gemini

gemini-mcp

轻量级 MCP 服务，可将 Google Gemini 作为工具提供给 Claude Code（或任何 MCP 客户端）。

使用 Gemini 获取第二意见、分析超长上下文、审查代码，或处理任何适合从不同模型视角出发的任务。

工具

工具	描述
gemini_ask	向 Gemini 提问或交给它一项任务
gemini_analyze	按照特定指令发送代码/文本进行分析
gemini_chat	保留完整历史记录的多轮对话
gemini_models	列出可用的 Gemini 模型

快速开始

1. 获取 API 密钥

前往 Google AI Studio 创建免费的 API 密钥。

2. 安装

选项 A — 克隆（推荐用于 Claude Code）

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git ~/.claude/mcp-servers/gemini
cd ~/.claude/mcp-servers/gemini
npm install

选项 B — npx（无需安装）

npx claude-gemini-mcp

3. 在 Claude Code 中注册

添加到 ~/.claude/settings.json：

{
  "mcpServers": {
    "gemini": {
      "command": "node",
      "args": ["/home/you/.claude/mcp-servers/gemini/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

或使用 npx：

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "claude-gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

使用示例

提出问题

> Use gemini_ask to explain the difference between std::expected and std::optional

Gemini says: std::optional<T> represents a value that may or may not be present...
std::expected<T, E> additionally carries an error value when the expected value is absent...

分析代码

> Use gemini_analyze to review this function for performance issues:
  instruction: "Find performance bottlenecks"
  content: <your code here>

Gemini says: Line 12 allocates inside the loop — move the vector outside...

多轮对话

> Use gemini_chat with messages:
  [{"role": "user", "content": "Design a REST API for a task manager"},
   {"role": "model", "content": "Here's a RESTful design..."},
   {"role": "user", "content": "Now add authentication"}]

Gemini says: Building on the previous design, add JWT-based auth...

为单次调用指定模型

> Use gemini_ask with model: "gemini-2.5-flash" to quickly summarize this error log

环境变量

变量	默认值	描述
GEMINI_API_KEY	(必需)	Google AI Studio API 密钥
GEMINI_MODEL	gemini-2.5-pro	所有工具的默认模型

模型

模型	适用场景
gemini-2.5-pro	质量最佳，上下文长度大（1M 个 token）
gemini-2.5-flash	速度快，适合大多数任务
gemini-2.0-flash	速度最快，适合简单任务

每个工具都接受可选的 model 参数，用于覆盖当前调用的默认模型。

功能

• 遇到速率限制（429）和服务器错误（5xx）时采用指数退避重试
• 将错误信息妥善返回给 MCP 客户端（不会崩溃）
• 支持为单次调用指定模型
• 除 API 密钥外，无需任何配置

故障排除

问题	解决方案
GEMINI_API_KEY is not set	在 settings.json 的 env 块中添加密钥
429 Too Many Requests	内置重试机制会处理此问题——等待几秒钟
Model not found	运行 gemini_models 列出有效的模型名称
Claude Code 中未显示工具	检查 ~/.claude/settings.json 语法，然后重启 Claude Code
ECONNREFUSED	检查网络/防火墙——该服务会调用 generativelanguage.googleapis.com

开发

git clone https://github.com/PavelGuzenfeld/gemini-mcp.git
cd gemini-mcp
npm install
npm test          # Run smoke tests
node index.js     # Start the MCP server locally

许可证

MIT