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基础URL
• COMFYUI_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个核心工具：

5.1 支持的模型

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开源许可证