Gemini MCP Server

GeminiMCP

設定済みの DeepSeek または Qwen モデルを MCP クライアント（Claude Code、IDE 拡張機能、カスタムツール）に公開する MCP サーバーです。

機能

• gemini_ask — GitHub のコンテキスト（PR、コミット、差分、ファイル）を組み合わせた、コーディングや分析に関する質問への回答
• 3 つのワークフロープロンプト — review_pr、explain_commit、compare_refs
• 7 つのコーディングプロンプト — コードレビュー、説明、デバッグ、リファクタリング、アーキテクチャ、テスト、セキュリティ
• 構造化 XML エンベロープ — すべてのユーザーターンを<context>／<task>／<final_instruction>として構成し、攻撃者が制御可能な本文は生テキストとして出力します
• サーバー側のシステムプロンプト選択 — 分類器がカテゴリに応じた指示と、それに対応する<final_instruction>本文を選択します
• 2 つのトランスポート：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	1 ページのチートシート — パラメーター、環境変数、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_*パラメーターでのみ使用）