Gemini Imagen MCP

双子座图像服务器

一个基于TypeScript的MCP服务器，使用Google的Gemini Imagen API提供图像生成功能。此服务器允许您通过模型上下文协议生成具有可自定义参数的高质量图像。

特性

工具

• generate_image -使用Google Gemini Imagen生成图像

- 提示 （必填）：图像生成的文本描述 - 图片数量 （可选）：要生成的图像数量（1-4，默认值：1） - 宽高比 （可选）：图像宽高比（默认值：“9:16”） - sampleImageSize （可选）：图像分辨率（默认值：“2K”） - 人员生成 （可选）：控制人员生成（默认值：“allow_maadult”）

参数选项

宽高比

控制生成图像的纵横比：

• "1:1" -方形格式
• "3:4" -肖像格式
• "4:3" -景观格式
• "9:16" -垂直格式（默认）
• "16:9" -水平格式

sampleImageSize

控制生成图像的分辨率（仅限标准和Ultra型号）：

• "1K" -分辨率较低
• "2K" -更高的分辨率（默认）

人员生成

控制模型是否可以生成人物图像：

• "dont_allow" -街区一代人
• "allow_adult" -仅生成成年人（默认）
• "allow_all" -培养成人和儿童

使用示例

基本用法（默认设置）

{
  "prompt": "A beautiful sunset over mountains"
}

这将使用默认设置：

• 纵横比：“9:16”
• sampleImageSize:“2K”
• personGeneration：“允许成人”

自定义参数

{
  "prompt": "A cute cat playing with a ball",
  "aspectRatio": "1:1",
  "sampleImageSize": "1K",
  "personGeneration": "dont_allow",
  "numberOfImages": 2
}

肖像摄影

{
  "prompt": "Professional headshot of a business person",
  "aspectRatio": "3:4",
  "sampleImageSize": "2K",
  "personGeneration": "allow_adult"
}

风光摄影

{
  "prompt": "Panoramic view of a mountain range at dawn",
  "aspectRatio": "16:9",
  "sampleImageSize": "2K"
}

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于自动重建的开发：

npm run watch

安装

方法1：使用npx（推荐）

将服务器配置添加到MCP客户端：

在MacOS上： ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "npx",
      "args": ["/path/to/gemini-imagen-server/build/index.js"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

方法2：直接使用节点

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "node",
      "args": ["/path/to/gemini-imagen-server/build/index.js"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

配置

API密钥设置

这 GEMINI_API_KEY 可以通过两种方式提供：

1. MCP配置中的环境变量 （推荐）：

{
  "mcpServers": {
    "gemini-imagen": {
      "command": "npx",
      "args": ["/path/to/gemini-imagen-server/build/index.js"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

1. 系统环境变量:

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

获取Gemini API密钥

1. 首选 谷歌AI工作室
2. 使用您的Google帐户登录
3. 点击“获取API密钥”
4. 创建新的API密钥
5. 复制密钥并在配置中使用

输出

生成的图像保存到 /tmp/ 带有时间戳的文件名：

• 格式： generated_image_[timestamp]_[index].png
• 例子： generated_image_1758733788860_0.png

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员:

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

错误处理

服务器包括全面的错误处理：

• 无效参数将被验证并拒绝
• 发现API错误并报告有用的消息
• 检测到丢失的API密钥并清楚地报告
• 网络问题得到妥善处理

许可证

该项目根据MIT许可证获得许可。