Google Search MCP

🚀 拡張型Google検索MCPサーバー

この強力なModel Context Protocol (MCP) サーバーは、高度な匿名化と検知回避機能を備え、拡張されたGoogle検索機能を提供します。

⚠️ 重要提示

これはウェブスクレイピング技術を使用した実験的なGoogle検索MCPサーバーです。以下の点にご注意ください。

• レート制限：Googleがこのサーバーからのリクエストをブロックまたはレート制限する可能性があります。
• 信頼性：Googleのスクレイピング防止対策により、検索結果が一貫性を欠く場合があります。

💡 使用建议

本番環境での使用には、公式の検索APIまたは確立されたMCPサーバーの使用を強くおすすめします。

• DuckDuckGo MCPサーバー：より信頼性が高く、利用規約に準拠した代替手段です。
• Bing Search API：Microsoftの公式検索APIで、MCPと統合されています。
• Google Custom Search API：Googleの公式検索APIです（APIキーが必要です）。
• SearXNG MCP：プライバシーに配慮したメタ検索エンジンの統合です。

この実験的なサーバーは、リスクと制限を理解している場合のみ使用してください。

🚀 クイックスタート

この拡張型Google検索MCPサーバーは、高度な匿名化と検知回避機能を備え、拡張されたGoogle検索機能を提供します。以下では、そのインストール方法、使い方、機能などを説明します。

✨ 主な機能

🔍 拡張された検索機能

• 高度なクエリサポート：引用符、演算子、フィルターを使用した複雑な検索クエリを処理します。
• 結果の設定可能：結果を制限（1 - 10）、言語、地域、セーフサーチ、時間範囲を設定できます。
• 複数の解析戦略：フォールバックメカニズムを備えた強力な結果抽出機能です。

🛡️ 高度な匿名化

• リアルなブラウザフィンガープリント：実際のブラウザ（Chrome、Firefox、Safari、Edge）を模倣するユーザーエージェントをローテーションさせます。
• 動的なヘッダー：Accept-Language、Accept-Encoding、セキュリティヘッダーをランダム化します。
• セッションのランダム化：一意のセッションIDとリクエストフィンガープリントを使用します。
• リクエストタイミング：検出パターンを回避するためにランダムな遅延を追加します。

🚀 信頼性機能

• スマートなリトライロジック：失敗したリクエストに対して、ジッター付きの指数関数的バックオフを行います。
• レート制限の処理：レート制限を自動検出し、適切に処理します。
• エラー回復：ユーザーフレンドリーなメッセージを伴う包括的なエラー処理です。
• タイムアウト管理：適切なエラー報告を伴う設定可能なタイムアウトです。

🔧 技術的な改善

• 複数の結果セレクター：GoogleのHTML構造の変化に適応します。
• URLのクリーニング：GoogleのリダイレクトURLを適切に処理します。
• コンテンツの検証：すべての結果が有効なURLとコンテンツを持つことを保証します。
• 包括的なロギング：デバッグとモニタリングのための詳細なロギングです。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じて、Claude Desktop用のgoogle-search-mcpを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @kongyo2/google-search-mcp --client claude

手動インストール

npm install

💻 使用例

開発モード

インタラクティブなCLIで開発モードでサーバーを起動します。

npm run dev

本番モード

本番環境でサーバーを起動します。

npm run start

テスト

包括的なテストスイートを実行します。

npm run test

開発中の継続的なテストには、以下のコマンドを使用します。

npm run test:watch

MCPツール: search

サーバーは、以下のパラメーターを持つ単一の強力な検索ツールを提供します。

パラメーター

• query (必須): 実行する検索クエリ
• limit (オプション): 最大結果数（1 - 10、デフォルト: 5）
• language (オプション): 言語コード（例: 'en', 'es', 'fr', 'de', 'ja'）
• region (オプション): 地域コード（例: 'us', 'uk', 'ca', 'au'）
• safeSearch (オプション): フィルターレベル（'off', 'moderate', 'strict'）
• timeRange (オプション): 時間フィルター（'hour', 'day', 'week', 'month', 'year'）

利用例

{
  "name": "search",
  "arguments": {
    "query": "Model Context Protocol MCP",
    "limit": 5,
    "language": "en",
    "region": "us",
    "safeSearch": "moderate",
    "timeRange": "week"
  }
}

Claude Desktopでの設定

Claude DesktopのMCP設定に以下の設定を追加します。

{
  "mcpServers": {
    "enhanced-google-search": {
      "command": "npx",
      "args": ["tsx", "/path/to/your/project/src/server.ts"]
    }
  }
}

🔧 技術詳細

コアコンポーネント

1. UserAgentGenerator: リアルなブラウザフィンガープリントを作成します。
2. RequestAnonymizer: リクエストの匿名化とタイミングを処理します。
3. SearchParameterBuilder: 最適化された検索パラメーターを構築します。
4. ResultParser: 複数の戦略を持つ強力なHTML解析機能です。

検知回避機能

• ブラウザフィンガープリントのローテーション: リアルなユーザーエージェントを循環させます。
• ヘッダーのランダム化: リクエストヘッダーを変化させてパターンを回避します。
• タイミングのランダム化: リクエスト間にランダムな遅延を追加します。
• セッション管理: 一意のセッション識別子を生成します。
• パラメーターの変動: ランダムな検索パラメーターを追加します。

エラー処理

サーバーは、以下のエラーに対する包括的なエラー処理を提供します。

• Googleによるレート制限
• ネットワークタイムアウトと接続問題
• アクセス拒否/ブロックされたリクエスト
• 無効または空のレスポンス
• フォールバック戦略を伴う解析失敗

📚 ドキュメント

プロジェクト構造

src/
├── server.ts          # メインのMCPサーバー実装
├── search.ts          # 拡張された検索機能
├── search.test.ts     # 包括的なテストスイート
└── types.ts           # TypeScriptの型定義

コード品質

プロジェクトには以下が含まれています。

• TypeScript: 完全な型安全性とIntelliSenseサポート
• ESLint: TypeScriptルールによるコードリンティング
• Prettier: 一貫したコードフォーマット
• Vitest: 高速で信頼性の高いテストフレームワーク

スクリプト

• npm run build: TypeScriptをJavaScriptにコンパイルします。
• npm run start: 本番モードでサーバーを起動します。
• npm run dev: CLIで開発モードで起動します。
• npm run test: テストスイートを実行します。
• npm run test:watch: ウォッチモードでテストを実行します。
• npm run lint: コード品質と型をチェックします。
• npm run format: Prettierでコードをフォーマットします。

テスト

テストスイートは以下をカバーしています。

• 基本的な検索機能
• パラメーターの検証と処理
• 言語と地域のフィルタリング
• セーフサーチと時間範囲のフィルター
• 複雑なクエリの処理
• エラーシナリオとエッジケース
• URLの検証と結果のフォーマット

すべてのテストは、実際のGoogle検索リクエストを使用して、機能が実際に動作することを保証します。

🤝 コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. テストを含めて変更を加えます。
4. npm run lint と npm run test を実行します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。