Mixelpixx GoogleSearch McpServer

🚀 Google 検索 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、Google 検索機能とウェブページ内容分析ツールを提供します。AI モデルは、このサーバーを通じてプログラムで Google 検索を実行し、ウェブページの内容を分析することができます。

✨ 主な機能

• Google カスタム検索の統合
• ウェブページ内容分析
• バッチウェブページ分析
• MCP 互換インターフェース

📦 インストール

前提条件

• Node.js (v16 以上)
• Python (v3.8 以上)
• Google Cloud Platform アカウント
• カスタム検索エンジン ID
• Google API Key

インストール手順

1. リポジトリをクローンします。
2. Node.js の依存関係をインストールします。

npm install

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

pip install flask google-api-python-client flask-cors

設定

1. ルートディレクトリに api-keys.json ファイルを作成し、Google API の認証情報を記述します。

{
    "api_key": "your-google-api-key",
    "search_engine_id": "your-custom-search-engine-id"
}

2. サーバー設定を MCP 設定ファイル（通常は %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）に追加します。

{
  "mcpServers": {
    "google-search": {
      "command": "npm",
      "args": ["run", "start:all"],
      "cwd": "/path/to/google-search-server"
    }
  }
}

ビルド

npm run build

実行

TypeScript サーバーと Python サーバーを同時に起動します。

npm run start:all

または、それぞれを個別に実行することもできます。

• TypeScript サーバー：npm start
• Python サーバー：npm run start:python

💻 使用例

1. 検索

Google 検索を実行し、結果を取得します。

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num_results": 5 // オプション、デフォルト値：5
  }
}

2. ウェブページ分析

単一のウェブページから内容を抽出し、分析します。

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

3. バッチウェブページ分析

一度のリクエストで複数のウェブページを分析します。

{
  "name": "batch_analyze_webpages",
  "arguments": {
    "urls": [
      "https://example1.com",
      "https://example2.com"
    ]
  }
}

📚 ドキュメント

Google API 認証情報の取得

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. カスタム検索 API を有効にします。
4. API 認証情報（API Key）を作成します。
5. カスタム検索エンジン ページにアクセスします。
6. 新しい検索エンジンを作成し、検索エンジン ID を取得します。
7. これらの認証情報を api-keys.json ファイルに追加します。

エラー処理

サーバーは、以下の状況で詳細なエラーメッセージを提供します。

• 欠落または無効な API 認証情報
• 検索リクエストの失敗
• 無効なウェブページ URL
• ネットワーク接続の問題

アーキテクチャ

サーバーは、以下の 2 つの主要な部分で構成されています。

1. TypeScript MCP サーバー：MCP プロトコルの通信を処理し、ツールのインターフェースを提供します。
2. Python Flask サーバー：Google API のやり取りとウェブページ内容分析を管理します。

📄 ライセンス

MIT