Universal Image Generator MCP

🚀 通用图像生成器MCP服务器

通用图像生成器MCP服务器是一个支持多供应商的AI图像生成服务器，供MCP客户端使用。借助该服务器，你可以通过任何与MCP兼容的应用程序，利用谷歌（Imagen & Gemini）、智谱AI的CogView - 4或阿里巴巴的百炼模型来生成高质量的图像。

🚀 快速开始

1. 通过uvx安装

无需手动安装！服务器将自动下载并运行。

2. 获取API密钥

选择一个供应商并获取API密钥：

• 谷歌：谷歌AI工作室（支持Imagen和Gemini模型）
• 智谱AI：智谱AI平台
• 百炼：阿里巴巴魔搭

3. 配置MCP客户端

将以下内容添加到你的MCP客户端配置文件（例如claude_desktop_config.json）中：

{
    "mcpServers": {
        "universal-image-generator": {
            "command": "uvx",
            "args": [
                "universal-image-generator-mcp"
            ],
            "env": {
                "IMAGE_PROVIDER": "google",
                "GOOGLE_MODEL": "gemini",
                "ZHIPU_API_KEY": "your-api-key-here",
                "GEMINI_API_KEY": "your-api-key-here",
                "DASHSCOPE_API_KEY": "your-api-key-here",
                "OUTPUT_IMAGE_PATH": "/path/to/save/images"
            }
        }
    }
}

环境变量说明：

• IMAGE_PROVIDER：可以是"google"、"zhipuai"或"bailian"
• GOOGLE_MODEL：可以是"gemini"或"imagen"（仅适用于谷歌供应商，默认为"gemini"）
• 为你选择的供应商设置相应的API密钥
• OUTPUT_IMAGE_PATH：保存生成图像的目录（可选）

✨ 主要特性

• 多供应商支持：可在谷歌（Imagen/Gemini）、智谱AI或百炼之间进行选择。
• 图像生成：所有供应商均支持文本到图像的生成。
• 图像转换：仅谷歌和百炼支持对现有图像进行编辑。
• 智能语言优化：自动进行提示词翻译和优化。
• 本地存储：可将生成的图像保存到指定目录。

📦 安装指南

见上述快速开始部分。

💻 使用示例

配置完成后，你可以向你的AI助手提出以下请求：

• "生成一幅山脉上日落的图像"
• "创建一个在科幻城市中3D渲染的飞猪图像"
• "通过给这个场景添加雪来转换这幅图像"

生成的图像将保存到你配置的输出目录中。

可用工具

generate_image_from_text

根据文本描述创建图像。

generate_image_from_text(prompt: str, model_type: Optional[str] = None) -> str

参数：

• prompt：要生成图像的文本描述。
• model_type：谷歌供应商的可选模型选择（"gemini"或"imagen"）
  • 仅适用于谷歌供应商。
  • 如果未指定，则使用GOOGLE_MODEL环境变量（默认为"gemini"）。

transform_image_from_encoded （仅谷歌和百炼支持）

使用Base64编码的图像数据转换图像。

transform_image_from_encoded(encoded_image: str, prompt: str) -> str

transform_image_from_file （仅谷歌和百炼支持）

转换现有的图像文件。

transform_image_from_file(image_file_path: str, prompt: str) -> str

示例输出

提示词："创建一个戴着礼帽、长着翅膀的猪在充满绿色植物的未来科幻城市上空飞行的3D渲染图像"

转换提示："添加一只可爱的小鲸鱼和猪一起飞行"

📚 详细文档

供应商能力

注意：对于谷歌供应商，图像转换仅支持Gemini模型，Imagen仅用于图像生成。

🔧 技术细节

本地开发测试

git clone https://github.com/ECNU3D/universal-image-generator-mcp.git
cd universal-image-generator-mcp
fastmcp dev src/universal_image_generator_mcp/server.py

访问 http://localhost:5173/ 使用MCP检查器进行测试。

📄 许可证

本项目采用MIT许可证。