timeverse-agnes-imggen-mcp

# TimeVerse Agnes ImageGen MCP > 🎨 **基于 MCP 标准的 Agnes Image 2.0 Flash 图片生成服务** [](https://www.python.org/) [](https://modelcontextprotocol.io/) [](LICENSE) --- ## 📋 概述 `timeverse-agnes-imggen-mcp` 是一个基于 **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/)** 标准的图片生成服务。它封装了 **Agnes Image 2.0 Flash** 的 API，将强大的 AI 图片生成能力以标准化的 MCP Tool 形式提供给 AI 客户端（如 Claude Desktop）调用。 ### 核心能力 - ✨ **文生图（Text-to-Image）**：根据文本描述生成高质量图片 - 🖼️ **图生图（Image-to-Image）**：基于参考图片生成新图片 - 🚀 **高速生成**：基于 Flash 模型，生成速度快 - 🔌 **即插即用**：遵循 MCP 标准，可被任何 MCP 客户端直接调用 --- ## 🚀 快速开始 ### 前置条件 - Python 3.10+ - [Agnes API Key](https://agnes-ai.com/)（免费注册获取） ### 安装 ```bash # 1. 克隆项目 cd timeverse-agnes-imggen-mcp # 2. 创建虚拟环境 python -m venv .venv source .venv/bin/activate # macOS/Linux # 或 .venv\Scripts\activate # Windows # 3. 安装依赖 pip install -e . ``` ### 配置 ```bash # 复制环境变量模板 cp .env.example .env # 编辑 .env 文件，填入你的 API Key # AGNES_API_KEY=your_api_key_here ``` ### 运行 ```bash # 标准模式（stdio） python -m timeverse_agnes_imggen_mcp.server # 或使用项目入口点 timeverse-agnes-imggen ``` --- ## 🔧 配置说明 | 环境变量 | 说明 | 默认值 | |---------|------|--------| | `AGNES_API_KEY` | Agnes API Key（必需） | - | | `AGNES_API_BASE_URL` | API 基础地址 | `https://apihub.agnes-ai.com/v1` | | `AGNES_MODEL` | 模型名称 | `agnes-image-2.0-flash` | | `HTTP_TIMEOUT` | HTTP 超时时间（秒） | `120` | | `MAX_RETRIES` | 最大重试次数 | `3` | | `DEBUG` | 调试模式 | `false` | --- ## 🛠️ MCP Tools 该 MCP Server 提供以下 Tool： ### 1. `generate_image` - 文生图 根据文本描述生成图片。 **参数：** | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | `prompt` | string | ✅ | 图片描述文本 | | `negative_prompt` | string | ❌ | 负面提示词 | | `size` | string | ❌ | 尺寸：`1024x1024`/`1280x720`/`720x1280`/`1920x1080` | | `quality` | string | ❌ | 质量：`standard`/`hd` | | `n` | integer | ❌ | 生成数量 1-4 | | `prompt_enhance`…