MCP Web Search

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

Google検索機能とウェブページ内容の閲覧を提供するMCPサーバーで、高度な反クローリング機構を備えています。

✨ 主な機能

• Googleカスタム検索：高度なフィルタリングをサポート
• ウェブページ内容の閲覧：Markdown変換機能付き
• 限流とキャッシュ
• ブラウザインスタンスプール
• 反クローリング検出：rebrowser - puppeteer技術を使用

📦 インストール

前提条件

• Bunランタイム環境v1.0以上
• Google APIの認証情報（APIキーと検索アプリID）

インストール手順

# 開発モードで実行し、ファイルの変更を監視
bun --watch run dev

# テストを実行
bun run test

# コードチェックを実行
bun run lint

📚 ドキュメント

設定ガイド

1. Cookie設定

認証を実現するために、以下の手順で設定してください。

• Windowsシステム：config - example.jsonファイルを%APPDATA%\Claude\mcp - clients\web - searchディレクトリにコピーし、config.jsonにリネームします。
• Mac/Linuxシステム：ファイルを~/.claude/mcp - clients/web - searchにコピーし、config.jsonにリネームします。

2. サーバー設定

config.jsonファイルに以下の内容を追加します。

{
  "browserLimits": {
    "globalLimit": 5,
    "requesterLimit": 2
  },
  "proxySettings": {
    "useProxy": true,
    "proxyUrl": "http://your - proxy - server:port",
    "proxyEnabledForDomains": ["example.com", "another - site.com"]
  }
}

ログ設定

# ログファイルを確認
# MacOS/Linuxシステム：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windowsシステム：
type %APPDATA%\Claude\Logs\mcp*.log

反クローリング機構の説明

• リクエスト頻度制限：browserLimits設定で並列および総リクエスト数を制御します。
• プロキシ設定：proxySettingsを設定して反クローリング検出を回避し、指定したドメインでプロキシを使用できます。

ツールインターフェース

検索ツール

{
  name: "search",
  params: {
    query: string;          // 必須項目：検索キーワード
    trustedDomains?: string[]; // オプション：信頼できるドメインのリスト
    excludedDomains?: string[]; // オプション：除外するドメイン
    resultCount?: number;   // オプション：返される結果の数、デフォルトは10
    safeSearch?: boolean;   // オプション：安全な検索を有効にする、デフォルトはtrue
    dateRestrict?: string;  // オプション：時間制限、"d"（過去1日）、"w"（過去1週間）などのオプションをサポート
  }
}

ウェブページ閲覧ツール

{
  name: "view_url",
  params: {
    url: string;            // 必須項目：対象のウェブページのURL
    includeImages?: boolean; // オプション：画像を含めるかどうか、デフォルトはtrue
    includeVideos?: boolean; // オプション：動画を含めるかどうか、デフォルトはtrue
    preserveLinks?: boolean; // オプション：リンクの完全性を維持するかどうか、デフォルトはtrue
    formatCode?: boolean;   // オプション：コード出力を整形するかどうか、デフォルトはfalse
  }
}

注意事項

⚠️ 重要提示

• サーバーには複数の反クローリング機構が組み込まれていますが、安全性を強化するためにプロキシとユーザーエージェントの設定を組み合わせる必要があります。
• 一部のウェブサイトでは自動化されたアクションを検出する可能性があります。

💡 使用建议

• ブラウザインスタンスのプール化設計により、リソース利用率を向上させることができます。
• アイドル状態のブラウザを自動的にクリーンアップして、リソースの枯渇を防ぎます。

📄 ライセンス

このプロジェクトはMITオープンソースライセンスに準拠しており、詳細な条項はLICENSEファイルを参照してください。