Google MCP Server

Google MCP サーバー

このプロジェクトは、AI アシスタントやその他の MCP 互換クライアントとの連携を可能にする、Google API 向けの Model Context Protocol（MCP）サーバーを実装しています。

---

前提条件

• Node.js 18+
• npm

---

インストール

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

git clone https://github.com/your-username/mcp-google-search.git
cd google-mcp-server

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

npm install

3. Google Custom Search API の認証情報を設定する

プロジェクトのルートに .env ファイルを作成し、次の内容を記述します。

GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_CX_ID=your_custom_search_engine_id_here

• GOOGLE_API_KEY：Google Custom Search API キーです。
• GOOGLE_CX_ID：Google Custom Search Engine ID です。

これらは Google Custom Search JSON API documentation から取得できます。

---

使用方法

1. テスト検索を実行する

npx ts-node src/test.ts

サンプル検索が実行され、結果がコンソールに出力されます。

2. MCP 互換クライアントと連携する

このサーバーを MCP の設定の一部として使用するには、MCP 設定ファイル（例：claude_desktop_config.json）に項目を追加します。

{
  "mcpServers": {
    "google-api": {
      "command": "npx",
      "args": ["ts-node", "src/index.ts"],
      "env": {
        "GOOGLE_API_KEY": "your_google_api_key_here",
        "GOOGLE_CX_ID": "your_custom_search_engine_id_here"
      }
    }
  }
}

API キーと CX ID を実際の認証情報に置き換えてください。

---

利用可能なツール

このサーバーでは、次のツールを利用できます。

1. googleSearchContent：Google Custom Search API を使用してウェブ検索を実行し、構造化された結果（タイトル、リンク、スニペット）を返します。
2. googleSearchImages：Google Custom Search API を使用して画像検索を実行し、最初の結果への Markdown 画像リンクを返します。

詳しい使い方については、src/tools.ts のソースコードを参照してください。

---

開発

プロジェクトを変更するには、次の手順に従います。

1. 必要に応じて src ディレクトリ内のコードを変更します。
2. 依存関係を追加または削除した場合は、それに応じて package.json を更新します。
3. 変更を適用するには、MCP クライアントまたはテストスクリプトを再起動します。

---

トラブルシューティング

• Google API キーと CX ID が .env ファイルまたは環境に正しく設定されていることを確認してください。
• すべての依存関係がインストールされていることを確認してください（npm install）。
• Node.js 18 以降を使用していることを確認してください。
• コードを変更した場合は、サーバーまたはテストスクリプトを再起動してください。

---

ライセンス

このプロジェクトは MIT License の下でライセンスされています。