ai-image-gen-mcp MCP 服务说明文档
1. 服务概述
一句话简介：多模型AI图像生成MCP Server。支持Seedream (Doubao)、SDXL、FLUX.1 Schnell/Dev。30x RTX 4090 GPU加速。
- 服务名称：ai-image-gen-mcp
- 版本号：最新版本
- 开发者/提供方：zhaohongyuziranerran
- 协议类型：MCP (Model Context Protocol)
2. 核心功能
列出该MCP服务提供的主要功能点：
- 多模型支持：支持4种主流AI图像生成模型 - Seedream 5.0、SDXL、FLUX.1 Schnell、FLUX.1 Dev
- 文本生成图像：根据文本描述生成高质量图像
- 图像转换：支持图像到图像的转换和变换
- 图像处理：提供图像放大（2x/4x）、背景移除等功能
- 批量生成：支持批量生成多个图像
- 风格迁移：支持8种艺术风格的迁移应用
- GPU加速：30块RTX 4090 GPU加速本地模型推理
3. 使用场景
描述该服务适合在什么情况下使用：
- 创意设计：快速生成创意图像，支持多种艺术风格
- 内容创作：为文章、博客、社交媒体生成配图
- 图像编辑：图像放大、背景移除、风格迁移等后期处理
- 批量生产：批量生成大量图像，提高工作效率
- 原型设计：快速生成设计原型和概念图
4. 接入方式
4.1 服务端点
在线访问地址：http://www.mzse.com/image-gen-mcp/
GitHub仓库：https://github.com/zhaohongyuziranerran/ai-image-gen-mcp
4.2 认证与权限
该服务需要配置以下环境变量：
SEEDREAM_API_KEY：Seedream API密钥（默认内置）SEEDREAM_BASE_URL：Seedream API基础URLCOMFYUI_URL：本地ComfyUI端点（默认：http://localhost:8188）IMAGE_OUTPUT_DIR：生成图像的输出目录
4.3 数据格式
所有请求和响应均采用JSON格式。图像生成结果返回图像URL或Base64编码。
4.4 服务器配置
在MCP客户端配置中添加服务：
{ "mcpServers": { "ai-image-gen-mcp": { "url": "http://www.mzse.com/image-gen-mcp/" } } }5. 接口定义
该服务提供10个核心工具：
| 工具名称 | 功能描述 | 主要参数 |
|---|---|---|
generate_image | 文本生成图像 | prompt, model, style, size |
generate_from_image | 图像到图像转换 | image, prompt, model |
list_models | 列出可用模型 | 无 |
get_model_info | 获取模型详情和定价 | model_id |
upscale_image | 超分辨率放大（2x/4x） | image, scale |
remove_background | 背景移除 | image |
batch_generate | 批量生成图像 | prompts, model, style |
get_generation_status | 检查任务状态 | task_id |
style_transfer | 应用艺术风格 | image, style |
image_variation | 生成图像变体 | image, num_variations |
5.1 支持的模型
| 模型 | 提供商 | 速度 | 质量 | 成本 |
|---|---|---|---|---|
| Seedream 5.0 | Doubao API | ~17秒 | 高 | ¥0.04/图 |
| SDXL | 本地 4090 | ~5秒 | 高 | 免费 |
| FLUX.1 Schnell | 本地 4090 | ~3秒 | 好 | 免费 |
| FLUX.1 Dev | 本地 4090 | ~15秒 | 最佳 | 免费 |
5.2 支持的艺术风格
该服务支持8种艺术风格：
- photorealistic：照片写实风格
- anime：动漫风格
- oil-painting：油画风格
- watercolor：水彩风格
- 3d-render：3D渲染风格
- pixel-art：像素艺术风格
- chinese-ink：中国水墨风格
- cyberpunk：赛博朋克风格
6. 快速开始
6.1 环境要求
- Python 3.8+
- FastMCP 2.x
- GPU（推荐）：NVIDIA RTX 4090或更高配置
- ComfyUI（用于本地模型）
6.2 示例代码
本地安装
# 安装依赖 pip install -r requirements.txt # 运行（stdio模式 - 用于Claude/WorkBuddy） python server.py # 运行（HTTP模式 - 用于远程访问） python server.py --transport http --port 8009生成图像示例
generate_image( prompt="a cyberpunk cat jumping over neon signs", model="flux-schnell", style="cyberpunk", size="1024x1024" )图像放大示例
upscale_image( image="path/to/image.jpg", scale=4 )背景移除示例
remove_background( image="path/to/image.jpg" )风格迁移示例
style_transfer( image="path/to/image.jpg", style="oil-painting" )7. 注意事项
- 模型选择：根据需求选择合适的模型，平衡速度、质量和成本
- GPU加速：本地模型需要GPU支持，推荐使用RTX 4090或更高配置
- API密钥：使用Seedream API需要配置API密钥
- 输出目录：建议配置IMAGE_OUTPUT_DIR环境变量指定输出目录
- 部署方式：支持stdio和HTTP两种传输模式，推荐使用在线访问方式
- 许可证：采用MIT开源许可证