MCP Image Gen

MCP图像生成器

一个模型上下文协议（MCP）服务器，用于使用谷歌的Gemini AI模型生成图像。

特性

• 🎨 使用Gemini AI从文本提示生成高质量图像
• 🖼️ 源/参考图像支持编辑、样式转换和字符一致性（最多14张图像）
• 📐 可定制的宽高比（1:1、16:9、9:16、4:3、3:4）
• 🔧 可配置的图像大小（小到4K分辨率）
• ⚙️ 通过JSON文件灵活配置
• 💾 使用有组织的文件名自动保存本地图像（默认情况下保存到~/gemini_images）
• 🚀 基于MCP SDK构建，实现无缝集成

⚠️ 已知问题

• 宽高比和图像大小参数可能无法正常工作 -当前正在以横向格式生成图像，而不管指定的纵横比如何。此事正在调查中。API调用看起来是正确的，但Gemini API可能没有按照预期尊重配置参数。

支持的型号

• 双子座-3-影像回顾 （默认）：专业级，支持高达4K分辨率
• 双子座-3.1闪光图像回顾：Gemini 3 Pro的高效对应产品，针对速度和大批量使用进行了优化；支持高达4K分辨率
• 双生2.5倍激光图像：针对速度进行了优化，生成1024px分辨率

安装

1. 克隆存储库：

git clone https://github.com/Legorobotdude/mcp-image-gen.git
cd mcp-image-gen

1. 安装依赖项：

pnpm install

1. 构建项目：

pnpm build

配置

环境变量

设置Gemini API密钥：

export GEMINI_API_KEY=your_api_key_here

从获取API密钥 谷歌AI工作室.

配置文件（可选）

创建一个 config.json 项目根目录中的文件以自定义默认值：

{
  "model": "gemini-3-pro-image-preview",
  "defaultAspectRatio": "1:1",
  "defaultImageSize": "large",
  "outputDirectory": "~/gemini_images"
}

可用选项：

• model: "gemini-3-pro-image-preview" （默认）， "gemini-3.1-flash-image-preview"，或 "gemini-2.5-flash-image"
• defaultAspectRatio: "1:1", "16:9", "9:16", "4:3"，或 "3:4"
• defaultImageSize:

- "small" （1K-1024px） - "medium" （2K至2048像素） - "large" （2K至2048像素） - "xlarge" （4K-4096px-仅适用于gemini-3.1-flash-image评论和gemini-3-pro-image评论）

• outputDirectory：保存生成图像的路径（默认： ~/gemini_images，可以使用绝对路径或 ~ 主目录）

使用Claude Desktop

添加到您的Claude Desktop配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-image-gen": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-image-gen/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

工具： generate_image

从文本提示生成图像。

参数

• 提示 （必填）：要生成的图像的文本描述
• 模型 （可选）：要使用的型号- "gemini-3-pro-image-preview", "gemini-3.1-flash-image-preview"，或 "gemini-2.5-flash-image"默认为服务器配置。
• 宽高比 （可选）：纵横比- "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"
• 图像大小 （可选）：分辨率- "small" （1K）， "medium" （2K）， "large" （2K）， "xlarge" （4K）
• 负面提示 （可选）：描述你不想在图片中看到什么
• 源图像 （可选）：源/参考图像（png、jpg、jpeg、gif、webp）的绝对文件路径数组。最多14张图片。仅限Gemini 3 Pro。

Claude中的示例用法

Generate an image of a serene mountain landscape at sunset with vibrant colors

Create a 16:9 image of a futuristic city skyline at night in xlarge size

Generate a portrait of a wise old wizard with a long beard, aspect ratio 3:4, medium size

Edit this photo to make it look like a watercolor painting (with sourceImages: ["/path/to/photo.jpg"])

Create a group photo of these people at a beach party (with sourceImages: ["/path/to/person1.jpg", "/path/to/person2.jpg"])

响应格式

该工具返回一个JSON响应，其中包含：

{
  "success": true,
  "imagePath": "/Users/yourusername/gemini_images/1234567890_serene_mountain_landscape.png",
  "prompt": "serene mountain landscape at sunset",
  "model": "gemini-3-pro-image-preview",
  "aspectRatio": "1:1",
  "imageSize": "large",
  "message": "Image generated successfully and saved to: /Users/yourusername/gemini_images/1234567890_serene_mountain_landscape.png"
}

图像质量说明

• 所有生成的图像都包含SynthID水印（谷歌的数字水印）
• 双子座-3-影像回顾 （默认）：最适合高质量、高达4K的详细图像
• 双子座-3.1闪光图像回顾：最适合速度和高容量使用，支持高达4K
• 双生2.5倍激光图像：最适合快速生成，固定为1024px分辨率

发展

开发观察模式：

pnpm dev

生产建设：

pnpm build

故障排除

“需要GEMINI_API_KEY环境变量”

确保您已设置 GEMINI_API_KEY 环境变量或将其添加到MCP配置中。

图像未生成

• 检查您的API密钥是否有效
• 验证您是否具有互联网连接
• 确保输出目录可写

尺寸选项不起作用

这 gemini-2.5-flash-image 无论大小参数如何，该型号仅支持1024px分辨率。使用 gemini-3-pro-image-preview 或 gemini-3.1-flash-image-preview 为了获得更高的分辨率。

许可证

麻省理工学院