内容
<div align="center">
# 艺术创作 AI 服务器
**通过 [Agnes AI](https://agnes-ai.com) 实现免费的文本转图像和文本转视频**
[](https://pypi.org/project/agnes-mcp/)
[](https://pypi.org/project/agnes-mcp/)
[](https://github.com/MSWEIMZ/agnes-mcp/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://modelcontextprotocol.io)
简体中文 | [English](README.md)
</div>
---
## 🚀 快速开始
```bash
# 1. 安装（一条命令）
pip install agnes-mcp
# 2. 在 https://agnes-ai.com 获取免费的 API 密钥
# 3. 添加到您的 MCP 客户端配置：
```
**Claude Desktop / Cursor / Windsurf** (`claude_desktop_config.json` 或等效文件）：
```json
{
"mcpServers": {
"agnes-mcp": {
"command": "uvx",
"args": ["agnes-mcp"],
"env": {
"AGNES_API_KEY": "your-api-key-here"
}
}
}
}
```
**Codex** (`config.toml`）：
```toml
[mcp_servers.agnes_mcp]
command = "uvx"
args = ["agnes-mcp"]
[mcp_servers.agnes_mcp.env]
AGNES_API_KEY = "your-api-key-here"
```
就这样！现在，您可以直接从 AI 助手生成图像和视频。
---
## ✨ 为什么选择 Agnes MCP？
| 功能 | Agnes MCP | 其他 AI 图像服务 |
|---------|-----------|------------------------|
| **价格** | **免费 / 张图片，免费 / 秒** | $0.02 - $0.08 / 张图片 |
| 文本转图像 | ✅ 2 个模型（2.0 & 2.1 Flash） | ✅ 通常 1 个模型 |
| 图像转图像 | ✅ 参考图像 + 提示 | ❌ 或有限 |
| 批量生成 | ✅ 1-4 张图片同时生成 | ❌ |
| 文本转视频 | ✅ 最多 18 秒，1080p | ❌ 或仅需付费 |
| 图像转视频 | ✅ 静态图像 → 视频 | ❌ 或仅需付费 |
| 多图像视频 | ✅ 关键帧动画 | ❌ |
| 自动下载 | ✅ 自动保存到本地 | ❌ 手动下载 |
| MCP 标准 | ✅ 完全符合 | 变化 |
**是的，它完全免费。** Agnes AI 目前提供所有图像和视频生成服务，且价格为 0。只需注册并获取 API 密钥。
---
## 🖼️ 演示
### 文本转图像（agnes-image-2.1-flash）
> *"一条雄伟的龙飞跃中国山脉景观，日落时分，电影般的灯光，史诗般的幻想艺术"*
### 文本转图像（agnes-image-2.0-flash）
> *"一个温馨的日本拉面店在夜间，温暖的灯笼光，雨水纷落，动漫风格"*
---
## 📦 工具
| 工具 | 描述 | 示例 |
|------|-------------|---------|
| `text_to_image` | 根据文本生成图像 | `prompt: "一只猫"` + 可选 `n: 4`, `images: [ref_url]` |
| `image_to_image` | 根据参考图像 + 文本生成图像 | `prompt: "使其具有赛博朋克风格"` + `images: [url]` |
| `text_to_video` | 根据文本/图像生成视频 | `prompt: "一只猫跳舞"` + 可选 `mode`, `num_inference_steps` |
| `image_to_video` | 将静态图像动画化为视频 | `prompt: "慢慢放大"` + `image: "url"` |
| `keyframe_animation` | 在关键帧图像之间平滑过渡 | `prompt: "变形场景"` + `images: [url1, url2, ...]` |
| `check_video_status` | 检查异步视频任务状态 | `video_id: "xxx"` 或 `task_id: "xxx"` |
---
## ⚙️ 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `AGNES_API_KEY` | **是** | - | 您的 Agnes AI API 密钥 |
| `AGNES_API_BASE` | 否 | `https://apihub.agnes-ai.com/v1` | API 基地址 |
| `AGNES_DEFAULT_MODEL` | 否 | `agnes-image-2.1-flash` | 默认图像模型 |
| `AGNES_DEFAULT_SIZE` | 否 | `1024x768` | 默认图像尺寸 |
---
## 🔑 获取免费 API 密钥
1. 访问 [https://agnes-ai.com](https://agnes-ai.com)
2. 创建账户（免费）
3. 进入 控制台 → API 密钥 → 创建
4. 复制密钥并粘贴到您的配置中
---
## ✅ 支持的客户端
- [x] **Claude Desktop**
- [x] **Codex（OpenAI）**
- [x] **Cursor**
- [x] **Windsurf**
- [x] **Cherry Studio**
- [x] 任何带有 `stdio` 传输的 MCP 客户端
---
## 📋 更新日志
### v0.3.0（2026-06-28）
- ✨ 新增工具：`image_to_video` — 将静态图像动画化为视频
- ✨ 新增工具：`keyframe_animation` — 在关键帧图像之间平滑过渡
- ✨ `text_to_video`: 添加了 `mode` 和 `num_inference_steps` 参数
- ✨ `create_video_task` / `generate_video`: 支持 `mode`（例如 `ti2vid`, `keyframes`）和 `num_inference_steps`
- ✅ 28 个测试通过
### v0.2.0（2026-06-27）
- ✨ 新增工具：`image_to_image` — 根据参考图像 + 提示生成图像
- ✨ `text_to_image`: 批量生成（`n: 1-4`）和多图像合成（`images`）
- ✨ `text_to_video`: 多图像视频 / 关键帧动画（`images`）
- 🐛 统一的多图像下载逻辑
- ✅ 19 个测试通过
### v0.1.1（2026-06-26）
- 🚀 初始公开版本
- 文本转图像，文本转视频，检查视频状态
- 异步 httpx 带有重试机制
- 自动下载到本地文件系统
---
## 🤝 贡献
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
---
## 📄 许可证
MIT
