MCP 服务器

Gemini MCP Server for Claude Desktop

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

README

用于 Claude Desktop 的 Gemini MCP 服务器

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

🌟 功能

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

📋 要求

Node.js 16.x 或更高版本
Claude Desktop 应用程序
Google Gemini API 密钥 (在此处获取)

🚀 安装

全局安装 (推荐)

npm install -g gemini-mcp-server

# 运行配置向导
npx gemini-mcp-setup

本地安装

# 为服务器创建一个目录
mkdir gemini-mcp-server
cd gemini-mcp-server

# 本地安装
npm install gemini-mcp-server

# 运行配置向导
npx gemini-mcp-setup

⚙️ 设置

配置向导将引导您完成配置过程：

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

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

🎨 使用 Gemini MCP 服务器

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

与 Claude 开始对话
要求 Claude 为您生成图像，例如：
- "生成一张日落时分山景的图像"
- "创建一张带有飞行汽车的未来城市图片"
- "制作一张猫弹钢琴的插图"

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

高级选项

您可以使用其他参数自定义图像生成：

Style: 指定一种风格，如 "realistic"（逼真）、"artistic"（艺术）、"minimalistic"（极简）等。
Temperature: 控制生成的创造性/随机性 (0.0-1.0)

示例: "Generate an image of a cyberpunk city with neon lights in a realistic style with temperature 0.7" (生成一张具有霓虹灯的赛博朋克城市图像，风格逼真，温度为 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
# 设置环境变量
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"
export OUTPUT_DIR="/path/to/your/output/directory"
export DEBUG="true"

# 执行服务器
exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

使脚本可执行：

chmod +x gemini-mcp-wrapper.sh

3. 更新 Claude Desktop 配置

编辑您的 ~/.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`	最大输出 tokens	`8192`