MCP Google Custom Search Server

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

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

🚀 クイックスタート

前提条件

始める前に、以下の条件を満たしていることを確認してください。

1. Google Cloud Consoleでカスタム検索APIを有効にする

   • Google Cloud Consoleにアクセスします。
   • カスタム検索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

✨ 主な機能

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

📦 インストール

上述の「クイックスタート」の手順に従ってインストールしてください。

🔧 技術詳細

環境変数

Claude Desktop との統合

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

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-google-custom-search-server/build/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "あなたのAPIキー",
        "GOOGLE_SEARCH_ENGINE_ID": "あなたの検索エンジンID"
      }
    }
  }
}

💻 使用例

基本的な使用法

以下は、search APIを使用して基本的な検索を行う例です。

// 基本的な検索の例
const fetch = require('node-fetch');

const query = 'example query';
const num = 5;

fetch(`http://localhost:3000/search?query=${query}&num=${num}`)
  .then(response => response.json())
  .then(data => console.log(data));

高度な使用法

高度なシナリオでは、検索結果をさらに処理することができます。

// 高度なシナリオの例
const fetch = require('node-fetch');

const query = 'advanced example query';
const num = 10;

fetch(`http://localhost:3000/search?query=${query}&num=${num}`)
  .then(response => response.json())
  .then(data => {
    const titles = data.items.map(item => item.title);
    console.log('検索結果のタイトル:', titles);
  });

📚 ドキュメント

プロジェクトのドキュメントはGitHubリポジトリにあり、このライブラリの使用方法と拡張方法が詳細に説明されています。

📄 API ドキュメント

利用可能なツール

search

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

パラメータ:

• query（文字列）: 検索するキーワード。
• num（整数、オプション）: 返される結果の数。デフォルトは10。

返却形式:

{
  "items": [
    {
      "title": "結果のタイトル",
      "link": "結果のリンク",
      "snippet": "結果の概要"
    },
    ...
  ]
}

📁 プロジェクト構造

• src/: 核心業務ロジックを含む。
• build/: ビルド後の出力ファイル。

利用可能なスクリプト

• npm run build: サーバーをビルドします。
• npm start: サーバーを起動します。
• npm test: テストケースを実行します。

🎁 謝辞

オープンソースコミュニティの皆さんの支援と貢献に感謝します。このプロジェクトは以下のライブラリに基づいて実装されています。

• express
• node-fetch

このプロジェクトがあなたの開発作業に役立つことを願っています。何か問題や提案があれば、Issuesを投稿してください。