gemini-cli-mcp-server

nabekou29/gemini-cli-mcp-server

3.2

If you are the rightful owner of gemini-cli-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Gemini CLI MCP Server integrates Google Gemini CLI for fast web searches into Claude Desktop, providing real-time information retrieval with smart caching and robust error handling.

Tools

  1. search_web_with_gemini

    Executes a web search using the Gemini CLI.

  2. clear_gemini_search_cache

    Clears the cache for specific queries or all queries.

  3. view_search_history

    Displays recent search history.

🔮 Gemini CLI MCP Server

🤖 このプロジェクトは100% Claude Codeによって開発されました

Google Gemini CLIを活用した高速Web検索をClaude Desktopに統合

特徴 • クイックスタート • インストール • 使い方 • API • 貢献

✨ 特徴

🚀 高速検索

リアルタイムWeb検索で最新情報を即座に取得

💾 スマートキャッシュ

1時間の自動キャッシュで高速レスポンス

🛡️ 堅牢なエラーハンドリング

詳細なエラーメッセージと解決策を提供

🎯 MCP標準準拠

Model Context Protocolに完全準拠

 
// 使用例
await search_web_with_gemini({
  query: "Deno 最新機能 2024",
  useCache: true
});

// レスポンス
{
  "content": [{
    "type": "text",
    "text": "検索結果..."
  }]
}

🚀 クイックスタート

📋 前提条件

  • Deno v1.40以上
  • gemini-cli がPATHに設定済み
  • Claude Desktop アプリケーション

⚡ 30秒セットアップ

  1. Claude Desktopの設定ファイルを開く

    OSパス
    🍎 macOS~/Library/Application Support/Claude/claude_desktop_config.json
    🪟 Windows%APPDATA%\Claude\claude_desktop_config.json

  2. 以下の設定を追加

    {
  "mcpServers": {
    "gemini-cli-search": {
      "command": "deno",
      "args": [
        "run",
        "--allow-run=gemini",
        "https://raw.githubusercontent.com/nabekou29/gemini-cli-mcp-server/main/mod.ts"
      ]
    }
  }
}

  3. Claude Desktopを再起動 🎉

📦 インストール

🌐 方法1: GitHubから直接実行（推奨）

インストール不要！上記のクイックスタートの設定だけでOK

💻 方法2: ローカルインストール

# リポジトリをクローン
git clone https://github.com/nabekou29/gemini-cli-mcp-server.git
cd gemini-cli-mcp-server

# 開発モードで実行
deno task dev

# または実行ファイルをビルド
deno task build
📝 ローカル実行の設定 
{
  "mcpServers": {
    "gemini-cli-search": {
      "command": "deno",
      "args": [
        "run",
        "--allow-run=gemini",
        "/path/to/gemini-cli-mcp-server/mod.ts"
      ]
    }
  }
}

🎮 使い方

🔍 Web検索を実行

// Claudeで使用例
"TypeScript 5.6の新機能について検索して";
"Deno vs Bun 2024年の比較を調べて";

🧹 キャッシュ管理

// 特定のクエリのキャッシュをクリア
clear_gemini_search_cache({ query: "TypeScript" });

// 全キャッシュをクリア
clear_gemini_search_cache({});

📊 検索履歴

// 最近の検索履歴を表示
view_search_history({
  limit: 20,
  includeErrors: false,
});

📚 API

🛠️ ツール

ツール説明パラメータ
search_web_with_geminiWeb検索を実行query (string, 必須)
useCache (boolean, デフォルト: true)
clear_gemini_search_cacheキャッシュクリアquery (string, オプション)
view_search_history履歴表示limit (number, 1-100)
includeErrors (boolean)

📂 リソース

URI説明
gemini://cache/status現在のキャッシュ状態
gemini://history/recent最近の検索履歴

💬 プロンプト

名前説明
search_analysisトピックの包括的分析
comparative_search複数項目の比較分析

🤖 開発について

このプロジェクトは100% Claude Codeによって開発されました。コードの生成、テストの作成、ドキュメントの執筆まで、すべてClaude Codeによって行われています。

Claude Codeによる開発の特徴

  • 🧠 高品質なコード生成 - ベストプラクティスに従った実装
  • 🔍 包括的なエラーハンドリング - 予期しないエラーへの対処
  • 📚 詳細なドキュメント - わかりやすく構造化された説明
  • ✅ テスト駆動開発 - 信頼性の高いコード

🤝 貢献

貢献を歓迎します！以下の方法で参加できます：

  1. 🐛 Issueでバグ報告
  2. 💡 新機能の提案
  3. 🔧 プルリクエストの送信

開発環境のセットアップ

# テストの実行
deno test --allow-run=gemini

# フォーマット
deno fmt

# リント
deno lint

📄 ライセンス

このプロジェクトはの下で公開されています。

Built with 🤖 Claude by nabekou29

このプロジェクトは100% Claude Codeによって開発されました