Google Custom Search

🚀 Googleカスタム検索を使用したMCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づき、Googleカスタム検索APIとウェブページ内容抽出機能を利用して、ウェブ検索機能を提供します。

🚀 クイックスタート

このサーバーを使用する前に、Google APIキーと検索エンジンIDを取得する必要があります。その後、依存関係をインストールし、サーバーをビルドして起動できます。

✨ 主な機能

検索ツール

Googleカスタム検索APIを使用してウェブ検索を実行します。

• 全ウェブまたは特定のサイトを検索できます。
• 結果の数を1 - 10で制御できます。
• タイトル、リンク、抜粋を含む構造化された結果を取得できます。

ウェブページリーダーツール

任意のウェブページの内容を抽出します。

• ウェブページの内容を取得して解析します。
• ページのタイトルと本文を抽出します。
• スクリプトやスタイルを取り除いて内容をクリーニングします。
• タイトル、テキスト、URLを含む構造化データを返します。

📦 インストール

Smitheryを通じたインストール

Claudeデスクトップ用のGoogleカスタム検索サーバーを自動的にSmitheryを通じてインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

Claudeデスクトップと一緒に使用する場合、Google API認証情報を含むサーバー設定を追加します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

💻 使用例

基本的な使用法

検索ツール

{
  "name": "search",
  "arguments": {
    "query": "你的搜索查询",
    "num": 5 // オプション、デフォルトは5、範囲は1 - 10
  }
}

ウェブページリーダーツール

{
  "name": "extract",
  "arguments": {
    "url": "网页链接"
  }
}

高度な使用法

検索ツールの高度な使用

検索結果の数を変更することができます。例えば、結果を10件に設定するには、numを10に設定します。

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num": 10
  }
}

ウェブページリーダーツールの高度な使用

任意のウェブページの内容を抽出できます。

{
  "name": "extract",
  "arguments": {
    "url": "https://example.com"
  }
}

📚 ドキュメント

設定

Google APIキーと検索エンジンIDの取得

1. Google Cloudプロジェクトを作成します。

   • Google Cloudコンソールにアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • プロジェクトの課金を有効にします。

2. カスタム検索APIを有効にします。

   • APIライブラリにアクセスします。
   • "Custom Search API"を検索します。
   • "有効にする"をクリックします。

3. APIキーを取得します。

   • 認証情報にアクセスします。
   • "認証情報を作成">"APIキー"をクリックします。
   • APIキーをコピーします。
   • (オプション) このキーをカスタム検索APIのみに制限します。

4. カスタム検索エンジンを作成します。

   • プログラマブル検索エンジンにアクセスします。
   • 検索するサイトを入力します（全ウェブを検索するにはwww.google.comを使用します）。
   • "作成"をクリックします。
   • 次のステップで"カスタマイズ"をクリックします。
   • 設定で"全ウェブを検索"を有効にします。
   • 検索エンジンID(cx)をコピーします。

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

開発時に自動的に再構築します。

npm run watch

インストール

Smitheryを通じたインストール

Claudeデスクトップ用のGoogleカスタム検索サーバーを自動的にSmitheryを通じてインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

Claudeデスクトップと一緒に使用する場合、Google API認証情報を含むサーバー設定を追加します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

デバッグ

DEBUG=mcp-google-search環境変数を使用してデバッグ出力を有効にします。

DEBUG=mcp-google-search npm start

注意事項

⚠️ 重要提示

• 検索対象のサイトのアクセス権限を持っていることを確認してください。
• Google APIのサービス条項と使用制限に従ってください。