Google Search MCP Server

Google Search MCP サーバー

Google の Custom Search JSON API と統合し、ウェブ検索機能を提供する MCP サーバーの実装です。

機能

• ウェブ検索：包括的なクエリオプションで Google を検索します
• 高度なフィルタリング：日付、言語、国、安全検索レベルで結果を絞り込めます
• レート制限：API クォータの超過を防ぐレート制限機能を内蔵しています
• 構造化された結果：タイトル、URL、スニペットを含む形式化された検索結果を返します

ツール

• google_search
  • 高度なフィルタリングオプションを使って Google 検索を実行します
  • 入力：
    • query (string)：検索語（必須）
    • num_results (number, optional)：結果の件数（1～10、デフォルト：5）
    • date_restrict (string, optional)：日付で絞り込みます（例：「d1」は過去1日間）
    • language (string, optional)：2文字の言語コード（例：「en」）
    • country (string, optional)：2文字の国コード（例：「us」）
    • safe_search (string, optional)：安全レベル（「off」、「medium」、「high」）

設定

API キーの取得

1. Google Cloud Console で Google Cloud プロジェクトを作成します
2. API ダッシュボード から、プロジェクトの Custom Search JSON API を有効にします
3. 認証情報セクションから API キーを生成するか、Custom Search API ガイドに従って生成します
4. Google の Programmable Search でカスタム検索エンジンを設定し、検索エンジン 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
    # or
    npm install
   

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

    pnpm run build
    # or
    npm run build
   

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

   {
     "mcpServers": {
       "google-search": {
         "command": "/path/to/node", // <--- Important to add the following, run in your terminal `echo "$(which node)"` to get the path
         "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 実行ファイルの完全なパスに置き換えます（ターミナルで which node コマンドを実行すると確認できます）

5. サーバーをテストする

    export GOOGLE_API_KEY=your_api_key_here
    export GOOGLE_SEARCH_ENGINE_ID=your_engine_id_here
    node dist/index.js
   

レート制限

Google の API クォータの超過を防ぐため、サーバーではデフォルトで1分あたり10件のリクエストにレート制限を適用しています。必要に応じてコード内で調整できます。

ライセンス

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