Gemini Bridge

🚀 Gemini Bridge

Gemini Bridgeは、軽量なMCP（Model Context Protocol）サーバーです。これにより、AIコーディングアシスタントが公式CLIを介してGoogleのGemini AIとやり取りできます。Claude Code、Cursor、VS Codeなど、MCP互換のクライアントと連携します。シンプルで信頼性が高く、シームレスな統合を実現します。

🚀 クイックスタート

前提条件

1. Gemini CLIのインストール：

   npm install -g @google/gemini-cli
   

2. Geminiでの認証：

   gemini auth login
   

3. インストールの確認：

   gemini --version
   

インストール

🎯 推奨：PyPIからのインストール

# PyPIからインストール
pip install gemini-bridge

# uvxを使ってClaude Codeに追加（推奨）
claude mcp add gemini-bridge -s user -- uvx gemini-bridge

代替案：ソースからのインストール

# リポジトリをクローン
git clone https://github.com/shelakh/gemini-bridge.git
cd gemini-bridge

# ローカルでビルドしてインストール
uvx --from build pyproject-build
pip install dist/*.whl

# Claude Codeに追加
claude mcp add gemini-bridge -s user -- uvx gemini-bridge

開発用インストール

# 開発モードでクローンしてインストール
git clone https://github.com/shelakh/gemini-bridge.git
cd gemini-bridge
pip install -e .

# Claude Codeに追加（開発用）
claude mcp add gemini-bridge-dev -s user -- python -m src

✨ 主な機能

• 直接的なGemini CLI統合：公式Gemini CLIを使用することで、APIコストをゼロに抑えます。
• シンプルなMCPツール：基本的なクエリとファイル分析のための2つのコア機能を備えています。
• ステートレス動作：セッション、キャッシュ、複雑な状態管理はありません。
• 本番環境対応：設定可能な60秒のタイムアウトで、堅牢なエラーハンドリングを行います。
• 最小限の依存関係：mcp>=1.0.0とGemini CLIのみが必要です。
• 簡単なデプロイ：uvxと従来のpipインストールの両方をサポートします。
• 汎用的なMCP互換性：MCP互換のすべてのAIコーディングアシスタントで動作します。

🌐 マルチクライアントサポート

Gemini Bridgeは、MCP互換のすべてのAIコーディングアシスタントと連携します - 同じサーバーが異なる設定方法で複数のクライアントをサポートします。

サポートされるMCPクライアント

• Claude Code ✅ (デフォルト)
• Cursor ✅
• VS Code ✅
• Windsurf ✅
• Cline ✅
• Void ✅
• Cherry Studio ✅
• Augment ✅
• Roo Code ✅
• Zencoder ✅
• MCP互換の任意のクライアント ✅

設定例

# 推奨のインストール方法
claude mcp add gemini-bridge -s user -- uvx gemini-bridge

# 開発用のインストール方法
claude mcp add gemini-bridge-dev -s user -- python -m src

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

{
  "servers": {
    "gemini-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": ["gemini-bridge"]
    }
  }
}

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

"augment.advanced": { 
  "mcpServers": [ 
    { 
      "name": "gemini-bridge", 
      "command": "uvx", 
      "args": ["gemini-bridge"],
      "env": {}
    }
  ]
}

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {}
    }
  }
}

{
  "command": "uvx",
  "args": ["gemini-bridge"],
  "env": {}
}

{
  "command": "gemini-bridge",
  "args": [],
  "env": {}
}

{
  "command": "python",
  "args": ["-m", "src"],
  "env": {},
  "cwd": "/path/to/gemini-bridge"
}

{
  "command": "npx",
  "args": ["gemini-bridge"],
  "env": {}
}

汎用的な使用方法

任意のクライアントで設定した後は、同じ2つのツールを使用できます：

1. 一般的な質問をする：「このコードベースではどのような認証パターンが使われていますか？」
2. 特定のファイルを分析する：「これらの認証ファイルのセキュリティ問題をレビューしてください」

サーバーの実装は同じです - クライアントの設定のみが異なります！

⚙️ 設定

タイムアウト設定

デフォルトでは、Gemini BridgeはすべてのCLI操作に60秒のタイムアウトを使用します。より長いクエリ（大きなファイル、複雑な分析）の場合は、GEMINI_BRIDGE_TIMEOUT 環境変数を使用してカスタムタイムアウトを設定できます。

設定例：

# カスタムタイムアウト（120秒）で追加
claude mcp add gemini-bridge -s user --env GEMINI_BRIDGE_TIMEOUT=120 -- uvx gemini-bridge

{
  "mcpServers": {
    "gemini-bridge": {
      "command": "uvx",
      "args": ["gemini-bridge"],
      "env": {
        "GEMINI_BRIDGE_TIMEOUT": "120"
      }
    }
  }
}

タイムアウトオプション：

• デフォルト：60秒（設定されていない場合）
• 範囲：任意の正の整数（秒）
• 推奨：大きなファイル分析の場合は120 - 300秒
• 無効な値：警告を表示して60秒に戻ります

🛠️ 利用可能なツール

consult_gemini

単純なクエリのための直接的なCLIブリッジです。

パラメータ：

• query (文字列)：Geminiに送信する質問またはプロンプト
• directory (文字列)：クエリの作業ディレクトリ（デフォルト：現在のディレクトリ）
• model (文字列、オプション)：使用するモデル - "flash" または "pro"（デフォルト："flash"）

例：

consult_gemini(
    query="Find authentication patterns in this codebase",
    directory="/path/to/project",
    model="flash"
)

consult_gemini_with_files

詳細な分析のためにファイルを添付できるCLIブリッジです。

パラメータ：

• query (文字列)：Geminiに送信する質問またはプロンプト
• directory (文字列)：クエリの作業ディレクトリ
• files (リスト)：ディレクトリに対する相対的なファイルパスのリスト
• model (文字列、オプション)：使用するモデル - "flash" または "pro"（デフォルト："flash"）

例：

consult_gemini_with_files(
    query="Analyze these auth files and suggest improvements",
    directory="/path/to/project",
    files=["src/auth.py", "src/models.py"],
    model="pro"
)

💻 使用例

基本的なコード分析

# シンプルな調査クエリ
consult_gemini(
    query="What authentication patterns are used in this project?",
    directory="/Users/dev/my-project"
)

詳細なファイルレビュー

# 特定のファイルを分析
consult_gemini_with_files(
    query="Review these files and suggest security improvements",
    directory="/Users/dev/my-project",
    files=["src/auth.py", "src/middleware.py"],
    model="pro"
)

マルチファイル分析

# 複数の実装ファイルを比較
consult_gemini_with_files(
    query="Compare these database implementations and recommend the best approach",
    directory="/Users/dev/my-project",
    files=["src/db/postgres.py", "src/db/sqlite.py", "src/db/redis.py"]
)

🏗️ アーキテクチャ

コア設計

• CLI優先：gemini コマンドへの直接的なサブプロセス呼び出し
• ステートレス：各ツールの呼び出しは独立しており、セッション状態はありません
• 固定タイムアウト：最大60秒の実行時間
• シンプルなエラーハンドリング：即時失敗アプローチで明確なエラーメッセージ

プロジェクト構造

gemini-bridge/
├── src/
│   ├── __init__.py              # エントリーポイント
│   ├── __main__.py              # モジュール実行のエントリーポイント
│   └── mcp_server.py            # 主なMCPサーバーの実装
├── .github/                     # GitHubテンプレートとワークフロー
├── pyproject.toml              # Pythonパッケージの設定
├── README.md                   # このファイル
├── CONTRIBUTING.md             # コントリビューションガイドライン
├── CODE_OF_CONDUCT.md          # コミュニティ基準
├── SECURITY.md                 # セキュリティポリシー
├── CHANGELOG.md               # バージョン履歴
└── LICENSE                    # MITライセンス

🔧 開発

ローカルテスト

# 開発モードでインストール
pip install -e .

# 直接実行
python -m src

# CLIの利用可能性をテスト
gemini --version

Claude Codeとの統合

サーバーは、MCPプロトコルを介して適切に設定されると、自動的にClaude Codeと統合されます。

🔍 トラブルシューティング

CLIが利用できない場合

# Gemini CLIをインストール
npm install -g @google/gemini-cli

# 認証
gemini auth login

# テスト
gemini --version

接続問題

• Gemini CLIが適切に認証されていることを確認します
• ネットワーク接続を確認します
• Claude CodeのMCP設定が正しいことを確認します
• gemini コマンドがPATHに含まれていることを確認します

一般的なエラーメッセージ

• "CLI not available"：Gemini CLIがインストールされていないか、PATHに含まれていません
• "Authentication required"：gemini auth login を実行してください
• "Timeout after 60 seconds"：クエリに時間がかかりすぎました。小さな部分に分割して試してください

🤝 コントリビューション

コミュニティからのコントリビューションを歓迎します！詳細は Contributing Guidelines をご覧ください。

簡単なコントリビューションガイド

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 適用可能な場合はテストを追加します
5. プルリクエストを送信します

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細は LICENSE ファイルを参照してください。

🔄 バージョン履歴

詳細なバージョン履歴は CHANGELOG.md を参照してください。

🆘 サポート

• 問題報告：GitHub Issues を通じてバグを報告または機能をリクエストしてください
• ディスカッション：コミュニティディスカッションに参加してください
• ドキュメント：追加のドキュメントは docs/ ディレクトリに作成できます

焦点：公式CLIを介してClaude CodeとGemini AIをシンプルで信頼性の高いブリッジで接続します。