Gemini MCP Server

GeminiMCP

一个 MCP 服务，可将已配置的 DeepSeek 或 Qwen 模型提供给 MCP 客户端 （Claude Code、IDE 扩展、自定义工具）。

功能

• gemini_ask — 编码／分析问答，可组合使用 GitHub 上下文（PR、提交、差异、文件）
• 3 个工作流提示词 — review_pr、explain_commit、compare_refs
• 7 个编码提示词 — 代码审查、解释、调试、重构、架构、测试、安全
• 结构化 XML 封装 — 每轮用户对话都会呈现为 <context> / <task> / <final_instruction>，攻击者可控的正文会以原始文本形式输出
• 服务端系统提示词选择 — 分类器会选择特定类别的指令以及匹配的 <final_instruction> 正文
• 两种传输方式：HTTP（通过 JWT 保护，首选）和 stdio（本地备用方案）

快速开始

# Build
go build -o bin/mcp-gemini .

# Configure
cp .env.example .env
# Edit .env — set PROVIDER, PROVIDER_API_KEY, and PROVIDER_MODEL

# Run (stdio, for Claude Code)
./bin/mcp-gemini

# Run (HTTP)
./bin/mcp-gemini --transport=http

Claude Code mcpServers 配置项（stdio）：

{
  "gemini": {
    "command": "/path/to/bin/mcp-gemini",
    "env": { "PROVIDER": "deepseek", "PROVIDER_API_KEY": "your-key", "PROVIDER_MODEL": "deepseek-v4-pro" }
  }
}

文档

文档	内容
docs/QUICKREF.md	一页速查表 — 参数、环境变量、CLI 标志、示例
docs/TOOLS.md	完整的工具和提示词参考，包含所有参数和示例
docs/PROMPTS.md	MCP 提示词注册表和服务端系统提示词选择
docs/USAGE.md	安装、传输模式、身份验证、所有环境变量
docs/ARCHITECTURE OVERVIEW.md	代码库概览、组件图、请求生命周期
.env.example	附有注释的配置模板

开发

./run_test.sh     # tests
./run_lint.sh     # golangci-lint
./run_format.sh   # goimports + gofmt
task check        # all gates via go-task (fmt+vet+lint+test)

要求

• Go 1.26+
• PROVIDER、PROVIDER_API_KEY 和 PROVIDER_MODEL（DeepSeek 或 Qwen）
• GEMINI_GITHUB_TOKEN（GitHub PAT — 仅用于 github_* 参数）