MCP Edge Search

🚀 MCPエッジ検索サーバー

MCPエッジ検索サーバーは、ウェブ検索機能を提供するMCPプロトコルサーバーで、ClaudeデスクトップなどのMCPクライアントをサポートしています。

🚀 クイックスタート

MCPエッジ検索サーバーは、ウェブ検索とウェブコンテンツの検索を行うことができ、Claude DesktopなどのMCPクライアントと連携して使用することができます。

✨ 主な機能

• ウェブ検索：Bingを使用してウェブ検索を行い、整形された結果を取得します。
• ウェブコンテンツ検索：任意のウェブページからテキストコンテンツを抽出し、クリーニングします。
• シンプルで軽量なPython実装：Pythonで実装されており、簡単に使用できます。
• ブラウザ自動化不要：HTTPリクエストのみを使用しているため、ブラウザ自動化は必要ありません。
• クリーンなウェブテキスト抽出：ウェブページからクリーンなテキストを抽出します。
• 詳細なログ記録：障害のトラブルシューティングに役立つ詳細なログを記録します。
• テストモード：MCPクライアントを使用せずに機能を検証することができます。

📦 インストール

前提条件

• Python 3.7以上
• MCPライブラリ（v1.2.0以上）
• Requestsライブラリ
• BeautifulSoup4ライブラリ

インストール手順

1. このリポジトリをクローンまたはダウンロードします。
2. 必要な依存関係をインストールします。

pip install -r requirements.txt

💻 使用例

基本的な使用法

MCPサーバーとして実行

Claude DesktopなどのMCPクライアントと一緒に使用する場合：

python edge_search_server.py

サーバーが起動したら、MCPクライアントの接続を待ちます。

テストモード

MCPクライアントを使用せずに検索機能をテストするには：

python edge_search_server.py --test --query "あなたの検索キーワード"

ウェブコンテンツ検索をテストするには：

python edge_search_server.py --test --url "https://example.com"

高度な使用法

Claude Desktopとの統合

このサーバーをClaude Desktopと一緒に使用するには：

1. Claude Desktopの設定ファイルを作成または編集します。
   • 場所：%AppData%\Claude\claude_desktop_config.json
2. 以下の設定内容を追加します。

{
  "mcpServers": {
    "edge-search": {
      "command": "C:/path/to/python.exe",
      "args": [
        "C:/path/to/mcp-edge-search/edge_search_server.py"
      ]
    }
  }
}

C:/path/to/python.exeを実際のPython実行ファイルのパスに置き換え、C:/path/to/mcp-edge-searchをこのリポジトリの実際のパスに置き換えます。 3. Claude Desktopを再起動します。 4. 「ウェブ検索を有効にする」ボタンをクリックします。

🔧 トラブルシューティング

サーバー切断エラー

Claude Desktopで「サーバーが切断されました」というエラーが表示された場合：

1. edge_search.logファイルのエラーメッセージを確認します。
2. すべての依存関係が正しくインストールされていることを確認します。
3. サーバーをテストモードで実行して機能を検証します。
4. Claude Desktopの設定ファイルのパスが正しいことを確認します。

JSON設定エラー

Claude Desktopが無効なJSONエラーを表示する場合：

1. 設定ファイルの形式が正しいことを確認します。
2. 正斜線（/）を使用し、バックスラッシュ（\）を使用しないでください。
3. Python実行ファイルのパスの正しさを検証します。

📚 ドキュメント

プロジェクト構造

• edge_search_server.py：メインのサーバー実装ファイル
• mcp_wrapper.py：Claude Desktopとの互換性を向上させるための補助スクリプト
• requirements.txt：Pythonの依存関係リスト
• run_server.bat：Windowsでサーバーをバッチ実行するためのバッチファイル

📄 ライセンス

このプロジェクトはMITライセンスの下でオープンソースです。

🔗 貢献ガイド

貢献を歓迎します！自由にPull Requestを送信してください。