MCP Google Custom Search Server

🚀 MCP 谷歌カスタム検索サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づいて構築され、Googleのカスタム検索APIを通じてウェブ検索機能を提供します。言語学習モデル（LLMs）が標準化されたインターフェースを介してウェブ検索を実行できるようになります。

✨ 主な機能

• Googleカスタム検索APIとのシームレスな統合
• モデルコンテキストプロトコル（MCP）に準拠したサーバー実装
• TypeScriptによる安全な型実装
• 環境変数による設定
• Zodを使用した入力検証
• 検索結果の設定可能（クエリごとに最大10件）
• タイトル、URL、説明を含む整形された検索結果
• エラー処理と検証
• Claude Desktopやその他のMCPクライアントとの互換性

📋 前提条件

始める前に、以下のものが必要です。

1. カスタム検索APIが有効になっているGoogle Cloudプロジェクト
   • Google Cloudコンソールにアクセス
   • カスタム検索APIを有効にする
   • API認証情報を作成する
2. カスタム検索エンジンID
   • プログラマブル検索エンジンにアクセス
   • 新しい検索エンジンを作成する
   • 検索エンジンIDを取得する
3. ローカル開発の要件:
   • Node.js（v18以上）
   • npm（Node.jsと一緒に提供されます）

🚀 クイックスタート

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/mcp-google-custom-search-server.git
   cd mcp-google-custom-search-server
   

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

   npm install
   

3. .envファイルを作成します。

   GOOGLE_API_KEY=あなたのAPIキー
   GOOGLE_SEARCH_ENGINE_ID=あなたの検索エンジンID
   

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

   npm run build
   

5. サーバーを起動します。

   npm start
   

🔧 設定

環境変数

Claude Desktop 統合

この設定をClaude Desktopの設定ファイル（通常は~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "googleCustomSearchMCP": {
      "url": "http://localhost:3000",
      "id": "あなたのサーバーID"
    }
  }
}

📚 ドキュメント

検索ツール

検索を実行するには、/searchエンドポイントにPOSTリクエストを送信します。

{
  "queries": ["あなたの検索クエリ"]
}

レスポンスは以下の構造を持ちます。

プロジェクト構造

mcp-google-custom-search-server/
├── src/
│   ├── server.ts          # メインサーバーファイル
│   └── search.ts         # 検索処理ロジック
└── package.json        # プロジェクトの依存関係とスクリプト

利用可能なスクリプト

📄 ライセンス

[ライセンスリンク]

🙏 謝辞

当社のMCPカスタム検索サーバーをご利用いただき、ありがとうございます。何か問題や提案があれば、いつでもご連絡ください。