Google Search MCP Server

🚀 谷歌搜索 MCP サーバー

Google カスタム検索 JSON API を統合した MCP サーバーの実装で、インターネット検索機能を提供します。

✨ 主な機能

• ウェブ検索：包括的なクエリオプションを使用して Google を検索します。
• 高度なフィルタリング：日付、言語、国、セキュリティ検索レベルで検索結果を制御します。
• レート制限：API クォータを超えないように、組み込みのレート制限機能があります。
• 構造化された結果：タイトル、URL、抜粋を含む、整形された検索結果を返します。

📚 ドキュメント

ツール

• google_search
  • 高度なフィルタリングオプションを使用して Google 検索を実行します。
  • 入力：
    • query（文字列）：検索語（必須）
    • num_results（数値、オプション）：結果の数（1 - 10、デフォルト：5）
    • date_restrict（文字列、オプション）：日付でフィルタリング（例：「d1」は過去 1 日間）
    • language（文字列、オプション）：2 文字の言語コード（例：「en」）
    • country（文字列、オプション）：2 文字の国コード（例：「us」）
    • safe_search（文字列、オプション）：セキュリティレベル（「off」、「medium」、「high」）

設定

API キーの取得

1. Google Cloud Console で Google Cloud プロジェクトを作成します。
2. API ダッシュボード で Custom Search JSON API を有効にします。
3. 認証情報のセクションから、または Custom Search API ガイド に従って API キーを生成します。
4. カスタム検索エンジンを設定して、Google のプログラマブル検索 から検索エンジン ID を取得します。

環境変数

サーバーを起動する前に、これらの変数を設定してください。

export GOOGLE_API_KEY="your-api-key"
export GOOGLE_SEARCH_ENGINE_ID="your-search-engine-id"

ローカルリポジトリからの実行

ソースコードから直接サーバーを実行する手順は次の通りです。

1. リポジトリをクローンする

    git clone https://github.com/ayush-rudani/google-search-mcp-server.git
    cd google-search-mcp-server
   

2. 依存関係をインストールする

    pnpm install
    # または
    npm install
   

3. プロジェクトをビルドする

    pnpm run build
    # または
    npm run build
   

4. Claude Desktop を設定する claude_desktop_config.json を更新します。

   {
     "mcpServers": {
       "google-search": {
         "command": "/path/to/node", // <--- ターミナルで `echo "$(which node)"` を実行してパスを取得
         "args": ["/full/path/to/google-search-mcp/index.js"],
         "env": {
           "GOOGLE_API_KEY": "your-api-key",
           "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
         }
       }
     }
   }
   

   • /path/to/node をシステム内の Node.js 実行ファイルの完全パスに置き換えてください。
5. サーバーをテストする

    export GOOGLE_API_KEY=你的_api_key_here
    export GOOGLE_SEARCH_ENGINE_ID=你的_engine_id_here
    node dist/index.js
   

🔧 技術詳細

このサーバーは、Google の API クォータを超えないように、デフォルトで毎分 10 回のリクエストのレート制限が有効になっています。この設定はコード内で調整できます。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。