使用说明
双子座医疗中心
轻量级 主控程序 将Google Gemini作为Claude Code（或任何MCP客户端）的工具公开的服务器。
使用Gemini进行第二种意见、大型上下文分析、代码审查或任何不同模型视角有帮助的事情。
工具
| 工具 | 说明 |
|---|---|
gemini_ask |
问双子座一个问题或给它一个任务 |
gemini_analyze |
发送带有特定指令的代码/文本进行分析 |
gemini_chat |
具有完整历史的多回合对话 |
gemini_models |
列出可用的Gemini型号 |
快速开始
1.获取API密钥
首选 谷歌AI工作室 并创建一个免费的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/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代币） |
gemini-2.5-flash |
快速，适用于大多数任务 |
gemini-2.0-flash |
最快、最简单的任务 |
每个工具都接受一个可选 model 参数覆盖每次调用的默认值。
特性
- 在速率限制（429）和服务器错误（5xx）上以指数回退重试
- 向MCP客户端报告优雅的错误（无崩溃）
- 每次呼叫模型覆盖
- API密钥之外的零配置
故障排除
| 问题 | 解决方案 |
|---|---|
GEMINI_API_KEY is not set |
将密钥添加到您的 env 挡住 settings.json |
429 Too Many Requests |
内置重试处理此问题——等待几秒钟 |
Model not found |
快跑 gemini_models 列出有效的型号名称 |
| 工具未出现在Claude代码中 | 检查 ~/.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
