gemini coding MCP

🤖 Gemini编码MCP服务器

一个IDE友好的MCP服务器，将谷歌的Gemini AI与Claude Code集成在一起，以增强编码辅助。

✨ 特性

• 15种专用编码工具：从代码审查到调试协助
• IDE优化：无缝剪贴板集成、文件读取和环境变量支持
• 无冲突命令：所有带有前缀的命令 gc 避免冲突
• 多种输入法：直接文本、文件路径、剪贴板或环境变量
• 智能缓存：缩短了重复查询的响应时间
• 长文本支持：最多可处理100KB的输入

📋 先决条件

• Python 3.8或更高版本
• Gemini API密钥
• Claude Code应用程序

🚀 安装

步骤1：克隆并安装

# Clone to the standard MCP servers location
git clone https://github.com/YOUR_USERNAME/gemini-coding.git ~/.claude-mcp-servers/gemini-coding

# Navigate to the directory
cd ~/.claude-mcp-servers/gemini-coding

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

步骤2：设置Gemini API密钥

从获取API密钥 谷歌人工智能工作室 并将其设置为环境变量：

# macOS/Linux
export GEMINI_API_KEY="your-api-key-here"

# Windows
set GEMINI_API_KEY=your-api-key-here

步骤3：配置Claude代码

将服务器添加到您的Claude Code MCP配置中：

macOS

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-coding": {
      "command": "python",
      "args": ["~/.claude-mcp-servers/gemini-coding/server.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

视窗

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-coding": {
      "command": "python",
      "args": ["%USERPROFILE%\\.claude-mcp-servers\\gemini-coding\\server.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Linux

编辑 ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-coding": {
      "command": "python",
      "args": ["~/.claude-mcp-servers/gemini-coding/server.py"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

步骤4：重新启动Claude代码

更新配置后，重新启动Claude Code以加载新的MCP服务器。

🎯 快速入门指南

基本用法

所有命令都遵循以下模式： mcp__gemini-coding__[command] [parameters]

获得帮助

mcp__gemini-coding__gchelp                    # Show all commands
mcp__gemini-coding__gchelp category="code"    # Show code-related commands
mcp__gemini-coding__gchelp category="ide"     # Show IDE workflow tips

提出问题

# Direct question
mcp__gemini-coding__gcask prompt="What are Python decorators?"

# From clipboard (copy code first)
mcp__gemini-coding__gcask prompt="Explain this code"

# From file
mcp__gemini-coding__gcask file_path="complex_algorithm.py" prompt="How does this work?"

IDE工作流示例

代码审查工作流程

1. 在IDE中选择代码
2. 复制（Cmd/Ctrl+C）
3. 运行： mcp__gemini-coding__gcreview focus="security"

调试错误消息

1. 从终端复制错误
2. 运行： mcp__gemini-coding__gcdebug

分析整个文件

mcp__gemini-coding__gcreview file_path="src/auth.py" focus="security"
mcp__gemini-coding__gctest file_path="utils.py" type="unit"
mcp__gemini-coding__gcperf file_path="slow_function.py"

📚 命令参考

基本命令

规格与设计

代码分析

调试与理解

实用工具

🔧 高级功能

多种输入法

所有命令都支持以下输入法：

1. 直接文本：直接在命令中传递文本
2. 文件路径：使用 file_path 用于分析文件的参数
3. 剪贴板：将文本参数留空以使用剪贴板内容
4. 环境变量：设置 GEMINI_INPUT 用于程序化使用

性能优化

• 温度≤0.3的命令被缓存5分钟
• 使用 fast=true 随着 gcask 使用Gemini Flash型号实现更快的响应

IDE集成提示

• 使用VS Code、Cursor或Windsurf等现代IDE最有效
• 剪贴板集成需要 pyperclip （包含在要求中）
• 文件路径可以是相对路径或绝对路径

🐛 故障排除

常见问题

“Gemini不可用”错误

• 检查你的 GEMINI_API_KEY 环境变量
• 确保您有互联网连接
• 验证您的API密钥是否有效

“未提供输入”错误

• 在运行命令之前，请确保已将文本复制到剪贴板
• 检查文件路径是否正确
• 尝试直接在命令中提供文本

未找到命令

• 配置更改后重新启动Claude代码
• 验证配置中的服务器名称是否完全为“gemini编码”
• 检查配置中的Python路径

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🔗 链接

• Gemini API文件
• MCP协议规范
• Claude代码文档