适用于 Claude 桌面的 Gemini MCP 服务器

模型上下文协议 (MCP) 服务器使 Claude Desktop 能够使用 Google 的 Gemini AI 模型生成图像。

🌟 功能

使用 Google 的 Gemini 模型直接从 Claude Desktop 生成图像
简易的配置设置向导
可定制的图像生成参数
与 Claude Desktop 的 MCP 服务器系统集成
详细的日志记录和调试功能

📋 要求

Node.js 16.x 或更高版本
Claude桌面应用程序
Google Gemini API 密钥（在此获取）

🚀 安装

全局安装（推荐）

npm install -g gemini-mcp-server

# Run the setup wizard
npx gemini-mcp-setup

本地安装

# Create a directory for the server
mkdir gemini-mcp-server
cd gemini-mcp-server

# Install locally
npm install gemini-mcp-server

# Run the setup wizard
npx gemini-mcp-setup

⚙️ 设置

安装向导将指导您完成配置过程：

输入您的 Google Gemini API 密钥
指定生成图像的保存目录
配置日志记录和模型设置
自动为 Claude Desktop 创建包装脚本
更新您的 Claude Desktop 配置

如果您更喜欢手动设置，请参阅下面的手动配置部分。

🎨 使用 Gemini MCP 服务器

安装并配置完成后，重新启动 Claude Desktop 以启用 Gemini MCP 服务器。然后：

与 Claude 开始对话
让 Claude 为你生成一张图片，例如：
- “生成日落时分的山景图像”
- “描绘一个有飞行汽车的未来城市”
- “制作一幅猫弹钢琴的插图”

Claude 将调用 Gemini API 来生成图像并为您提供保存的图像文件的路径。

高级选项

您可以使用附加参数自定义图像生成：

风格：指定“现实主义”、“艺术主义”、“简约主义”等风格。
温度：控制生成的创造力/随机性（0.0-1.0）

例如：“生成一幅赛博朋克城市图像，其霓虹灯风格逼真，温度为 0.7”

🔧 手动配置

如果您不想使用安装向导，请按照以下步骤操作：

1.创建配置文件

使用您的设置创建一个 JSON 配置文件：

{
  "apiKey": "YOUR_GEMINI_API_KEY_HERE",
  "outputDir": "/path/to/your/output/directory",
  "debug": true,
  "modelOptions": {
    "model": "gemini-2.0-flash-exp",
    "temperature": 0.4
  }
}

2. 创建包装脚本

创建一个 bash 脚本来运行服务器：

#!/bin/bash
# Set environment variables
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"
export OUTPUT_DIR="/path/to/your/output/directory"
export DEBUG="true"

# Execute the server
exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

使脚本可执行：

chmod +x gemini-mcp-wrapper.sh

3.更新Claude桌面配置

编辑~/.config/claude/claude_desktop_config.json文件以添加 Gemini MCP 服务器：

{
  "mcpServers": {
    "gemini-image": {
      "command": "/bin/bash",
      "args": [
        "-c",
        "/path/to/your/gemini-mcp-wrapper.sh"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE",
        "DEBUG": "true"
      }
    }
  }
}

📚 API 文档

命令行界面

gemini-mcp-server [options]

选项：

-k, --api-key <key> ：Google Gemini API 密钥
-o, --output-dir <dir> ：保存生成的图像的目录
-d, --debug ：启用调试日志记录
-c, --config <path> ：自定义配置文件的路径
-r, --reset-config ：将配置重置为默认值
-v, --version ：显示版本信息

环境变量

GEMINI_API_KEY ：您的 Google Gemini API 密钥
OUTPUT_DIR ：保存生成的图像的目录
DEBUG ：启用调试日志记录（ true或false ）
LOG_LEVEL ：设置日志级别（ ERROR 、 WARN 、 INFO或DEBUG ）
GEMINI_LOG_FILE ：自定义日志文件路径

配置选项

选项	描述	默认
`apiKey`	Google Gemini API 密钥	（必需的）
`outputDir`	保存生成的图像的目录	`~/Claude/gemini-images`
`debug`	启用调试日志记录	`false`
`modelOptions.model`	使用 Gemini 模型	`gemini-2.0-flash-exp`
`modelOptions.temperature`	控制创造力/随机性	`0.4`
`modelOptions.topK`	Top-k采样参数	`32`
`modelOptions.topP`	Top-p 抽样参数	`1`
`modelOptions.maxOutputTokens`	最大输出令牌	`8192`

🔍 故障排除

常见问题

服务器未启动或 Claude 无法连接

检查日志文件~/Claude/logs/gemini-image-mcp.log
验证您的 API 密钥是否正确
确保所有目录都存在并且具有适当的权限
重启Claude桌面

未生成图像

验证您的 Google Gemini API 密钥是否具有正确的权限
检查输出目录是否存在且可写
检查日志中的具体错误消息
尝试不同的提示或模型

错误：“未找到方法”

这通常意味着 Claude 正在尝试调用 MCP 服务器不支持的方法。请检查日志以查看请求的方法。

调试模式

启用调试模式以获取更详细的日志：

npx gemini-mcp-server --debug

或者设置环境变量：

export DEBUG=true
npx gemini-mcp-server

📝 许可证

麻省理工学院

Gemini MCP Server for Claude Desktop

Integrations