Web Search Server

🚀 ネットワーク検索 MCP サーバー

Google検索機能とウェブページ内容の閲覧を提供し、高度な反ロボット検出回避能力を備えたMCPサーバーです。

🚀 クイックスタート

ネットワーク検索MCPサーバーは、Google検索、ウェブページ内容の解析など、インターネットとの対話に関連する複雑なタスクを実行できる強力なツールです。このサーバーは、モデルコンテキストプロトコル（MCP）環境に統合するために設計されており、オンラインデータを拡張可能かつ安全な方法で処理します。

✨ 主な機能

• Googleカスタム検索：検索ドメインをカスタマイズし、特定のドメインを除外できます。
• ウェブページ内容の閲覧：指定したURLの内容を抽出し、複数の書式設定オプションをサポートします。
• レート制限とリソース管理：ブラウザインスタンスプールと自動的な空きインスタンスのクリーンアップにより、パフォーマンスを最適化します。
• 反ロボット検出回避：一般的な反ロボット検出メカニズムを回避するための高度な技術を統合しています。

📦 インストール

前提条件

1. システムにNode.jsとnpmをインストールしてください。
2. typescript と @types/node パッケージをインストールします。

   npm install -g typescript @types/node --save-dev
   

インストール手順

# リポジトリをクローン
git clone https://github.com/your-repository.git
cd web-search-mcp-server

# 依存関係をインストール
npm install

📚 ドキュメント

設定

1. 設定ファイルの作成

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

{
  "googleApiKey": "YOUR_GOOGLE_API_KEY",
  "proxySettings": {
    "http": "HTTP_PROXY_URL",
    "https": "HTTPS_PROXY_URL"
  },
  "browserOptions": {
    ".userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.128 Safari/537.36",
    "disableImages": false
  }
}

2. 環境変数の設定

ターミナルで以下の環境変数を設定します。

export MCP_SERVER_ENV=development

クッキー設定

クッキー機能を使用するには、以下の手順を実行してください。

1. Chromeブラウザをダウンロードしてインストールします。
2. uBlock Origin 拡張機能をインストールします。
3. ブラウザの設定ファイルをエクスポートします。

   chrome://settings/resetBrowser
   

4. エクスポートした設定ファイルのパスを環境変数として設定します。

   export BROWSER_PROFILE=~/path/to/your/exported/profile
   

ログ記録

• リアルタイムログの表示：
  • MacOS/Linux：

    tail -n 20 -f ~/Library/Logs/MCP/mcp*.log
    

  • Windows：

    type %APPDATA%\Claude\Logs\mcp*.log
    

反ロボット検出

核心機能

• ブラウザプール：ブラウザインスタンスを再利用することでパフォーマンスを最適化します。
• リクエスト頻度の制御：過度のリクエストによる反ロボットメカニズムのトリガーを防止します。
• 回避技術：
  • 動的なタイムアウト調整
  • ランダムなユーザーエージェント
  • 人間の行動パターンの模倣

よくある問題

1. サーバーが表示されない場合：
   • 設定ファイルの構文とパスが正しいか確認してください。
2. ツールの呼び出しが失敗する場合：
   • サーバーのログを確認し、Claude Desktopを再起動してください。
3. パスの問題が発生する場合：
   • 絶対パスを使用することを確認してください。

Claude Desktopの使用

設定手順

1. config.json ファイルを開きます。
2. ツールリストに以下の内容を追加します。

   {
     "name": "search",
     "description": "インターネットを検索して結果を返す"
   },
   {
     "name": "view_url",
     "description": "指定したURLの内容を表示してテキストを返す"
   }
   

統合の確認

1. ツールアイコンを確認します。
   • Claude Desktopで、ハンマーアイコンが表示されることを確認してください（参考画像）。

利用可能なツール

1. 検索ツール

{
  name: "search",
  params: {
    query: string;
    trustedDomains?: string[];
    excludedDomains?: string[];
    resultCount?: number;
    safeSearch?: boolean;
    dateRestrict?: string;
  }
}

2. URL閲覧ツール

{
  name: "view_url",
  params: {
    url: string;
    includeImages?: boolean;
    includeVideos?: boolean;
    preserveLinks?: boolean;
    formatCode?: boolean;
  }
}

トラブルシューティング

• 一般的なエラー：
  • ネットワーク接続の問題
  • 反ロボット検出のトリガー
  • 設定ファイルの構文エラー
• 解決策：
  • ネットワーク接続を確認する
  • リクエスト頻度を減らす
  • 設定ファイルが正しいことを確認する

開発

プロジェクト構造

web-search-mcp-server/
├── src/                 # コアソースコードディレクトリ
│   ├── browser.ts      # ブラウザ管理ロジック
│   ├── search.ts       # 検索機能の実装
│   └── view.ts         # URL閲覧機能の実装
├── config.json          # プロジェクト設定ファイル
└── package.json         # 依存関係管理ファイル

貢献

コミュニティからの貢献を歓迎します。リポジトリをフォークし、プルリクエストを送信してください。

📄 ライセンス

MITライセンス

連絡先

• メール：contact@example.com
• GitHub：https://github.com/your-repository

以上の手順に従えば、Web検索MCPサーバーを簡単に設定して実行し、プロジェクトに統合することができます。