Gemini 图像生成 MCP 服务器

这是一个使用 Google 的 Gemini 2 API 提供图像生成功能的模型上下文协议 (MCP) 服务器。

快速开始

1. 获取 Gemini API 密钥

   • 访问 Google AI Studio
   • 创建一个新的 API 密钥

2. 配置 Claude 桌面版

   • 找到您的配置文件：

     Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
     Windows: %APPDATA%\Claude\claude_desktop_config.json
     Linux: ~/.config/Claude/claude_desktop_config.json
     

   • 添加 Gemini 配置：

     {
       "mcpServers": {
         "gemini-imagen": {
           "command": "npx",
           "args": ["-y", "github:sanxfxteam/gemini-mcp-server"],
           "env": {
             "GEMINI_API_KEY": "your_api_key_here"
           }
         }
       }
     }
     

3. 重启 Claude 桌面版

设置

1. 安装依赖项：

npm install

1. 设置环境变量：
   在根目录下创建一个 .env 文件并添加您的 Google API 密钥：

GEMINI_API_KEY=your_api_key_here

使用方法

运行服务器：

npm start

进行测试：

npx @modelcontextprotocol/inspector npm run start

可用工具

generateImage

使用 Gemini 2 的实验性图像生成功能生成图像。

参数：

• prompt (字符串, 必填): 您要生成的图像的描述
• numSamples (数字, 可选, 默认: 4): 要生成的图像数量
• aspectRatio (字符串, 可选, 默认: '1:1'): 生成图像的宽高比
• personGeneration (字符串, 可选, 默认: 'ALLOW_ADULT'): 人物生成设置

示例 MCP 请求：

{
  "tool": "generateImage",
  "params": {
    "prompt": "A serene mountain landscape at sunset",
    "numSamples": 2,
    "aspectRatio": "16:9"
  }
}

注意事项

• 该服务器使用了 Gemini 2 的实验性图像生成功能
• 确保您拥有来自 Google 的适当访问权限和 API 密钥
• 服务器通过 stdio 以模型上下文协议进行通信