Ultimate Image Gen MCP

终极双子座MCP

谷歌的MCP服务器 Gemini 3.1闪光图像 --具有高级推理的快速图像生成，512px–4K分辨率，多达14张参考图像，谷歌搜索基础和自动思维模式。

所有生成的图像都包含不可见的SynthID水印，用于真实性和来源跟踪。

______________________________________________________________________

特性

Gemini 3.1闪光图像

• 高分辨率输出：512px、1K、2K和4K分辨率
• 高级文本渲染：信息图表、菜单、图表和徽标中清晰、风格化的文本
• 最多14个参考图像：最多10个对象+4个字符，以保持风格/字符的一致性
• 谷歌搜索暂停：实时数据（天气、股票、事件、地图）
• 谷歌图片搜索：来自网络图像的视觉背景——该模型可以找到任何事物的真实图像
• 思维方式：可配置推理-“最小”（快速）或“高”（最佳质量）

这个模型是不同的。 与仅依赖训练数据的传统图像生成器不同，Gemini 3.1 Flash可以实时访问谷歌搜索和图像搜索。它可以找到产品、人员、事件或任何在线存在的实际参考。《韦德之路12》→ 生成真正的鞋子。“托尼·霍克”→ 找到真实的照片。别操之过急，让模特做饭吧。

服务器功能

• 批处理：并行生成多个图像（最多8个并发图像）
• 22个专家提示模板：用于摄影、徽标、电影、故事板等的MCP斜线命令
• 灵活的纵横比：14个选项--1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9
• 可通过环境变量进行配置：输出目录、默认大小、超时等

______________________________________________________________________

展示

照片级真实感能力

黄仁勋-GPU冲浪

埃隆·马斯克-火星象棋比赛

黄仁勋-GPU厨房

埃隆·马斯克——Cybertruck Symphony

黄仁勋-水下数据中心

埃隆·马斯克——SpaceX滑板

谷歌搜索暂停

旧金山当前天气

谷歌图片搜索

花上的蝴蝶

不同的决议

512px（最快）

1K

2K

______________________________________________________________________

快速开始

先决条件

• Python 3.11+
• Google Gemini API密钥 （免费版可用）

安装

使用uvx（推荐使用，无需安装）：

uvx ultimate-gemini-mcp@latest

注： 使用 @latest 以确保uv始终从PyPI获取最新版本。没有它，uv可能会使用缓存环境。

使用pip：

pip install ultimate-gemini-mcp

来源：

git clone https://github.com/anand-92/ultimate-image-gen-mcp
cd ultimate-image-gen-mcp
uv sync

______________________________________________________________________

设置

克劳德桌面版

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": ["ultimate-gemini-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置文件位置：

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

macOS spawn uvx ENOENT 错误：使用完整路径--使用查找 which uvx，然后设置 "command": "/Users/you/.local/bin/uvx".

克劳德代码

claude mcp add ultimate-gemini \
  --env GEMINI_API_KEY=your-api-key \
  -- uvx ultimate-gemini-mcp@latest

光标

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "ultimate-gemini": {
      "command": "uvx",
      "args": ["ultimate-gemini-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

图像保存到 ~/gemini_images 默认情况下。添加 "OUTPUT_DIR": "/your/path" 定制。

______________________________________________________________________

工具

generate_image

使用Gemini 3.1 Flash image生成图像。

图像尺寸指南：

• 512px --最快、成本最低（0.5K）
• 1K --快速，适合测试（~1-2MB）
• 2K --建议用于大多数用例（~3-5 MB）
• 4K --生产资产的最高质量（~8-15 MB）

______________________________________________________________________

batch_generate

并行生成多个图像。

______________________________________________________________________

MCP提示模板

22个专家提示模板可用作Claude Code中的MCP斜线命令（类型 / 浏览）。每个模板都返回一个精心编制的提示和推荐的参数，可以直接传递给 generate_image 或 batch_generate.

______________________________________________________________________

配置

______________________________________________________________________

故障排除

spawn uvx ENOENT --Claude Desktop找不到 uvx.使用完整路径：

"command": "/Users/yourusername/.local/bin/uvx"

通过以下方式查找： which uvx

GEMINI_API_KEY not found --在MCP配置中设置密钥 env 块或在 .env 文件。获取免费钥匙 谷歌AI工作室.

Content blocked by safety filters --改写提示以避免敏感内容。

Rate limit exceeded -等待并重试，或升级API配额。

图像未保存 --检查 OUTPUT_DIR 存在并且可写： mkdir -p /your/output/path.

______________________________________________________________________

许可证

麻省理工学院——见 许可证 了解详情。

链接

• 谷歌AI工作室 -获取API密钥
• Gemini API文件
• 模型上下文协议
• FastMCP