Google MCP Server

🚀 谷歌MCPサーバー

このプロジェクトは、Google API用のモデルコンテキストプロトコル（MCP）サーバーを実装しています。AIアシスタントやその他のMCP互換クライアントとの統合をサポートしています。

🚀 クイックスタート

このサーバーを使用することで、Google APIを通じた検索機能をMCP互換クライアントに統合できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• Google APIを用いたモデルコンテキストプロトコル（MCP）サーバーの実装。
• AIアシスタントやその他の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カスタム検索APIの認証情報を設定する

プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を記述します。

GOOGLE_API_KEY=your_google_api_key_here
GOOGLE_CX_ID=your_custom_search_engine_id_here

• GOOGLE_API_KEY: あなたのGoogleカスタム検索APIキー。
• GOOGLE_CX_ID: あなたのカスタム検索エンジンID。

これらの情報はGoogleカスタム検索JSON APIドキュメントで取得できます。

💻 使用例

基本的な使用法

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

npx ts-node src/test.ts

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

2. 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カスタム検索APIを使用してウェブ検索を実行し、構造化された結果（タイトル、リンク、抜粋）を返します。
2. googleSearchImages: Googleカスタム検索APIを使用して画像検索を実行し、最初の結果のMarkdown画像リンクを返します。

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

開発

プロジェクトを変更する場合は、以下の手順に従ってください。

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

トラブルシューティング

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

📄 ライセンス

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