Mcpwebsearch

🚀 📂 MCP Web Search Server

このサーバーは、Model Control Protocol (MCP) を介してツールを公開し、外部の検索機能への制御されたアクセスを提供する、プライバシーに配慮したウェブ、ソーシャルメディア、およびアーカイブ検索サーバーです。

🚀 クイックスタート

このセクションでは、MCP Web Search Server のインストールと起動方法について説明します。

インストール手順

# リポジトリをクローンする（必要な場合）
git clone https://github.com/undici77/MCPWebSearch.git
cd MCPWebSearch

# 起動スクリプトを実行する（名前が異なる場合は調整する）
./run.sh -d /path/to/working/directory

1️⃣ Python 仮想環境 (.venv) を作成し、アクティブ化します。
2️⃣ requirements.txt から必要な依存関係をすべてインストールします。
3️⃣ MCP Search Server (main.py) を起動します。これは JSON‑RPC メッセージを stdin/stdout で受信します。

📌 起動スクリプトが実行可能であることを確認してください: chmod +x run.sh

✨ 主な機能

• 複数のプライバシーに配慮したウェブエンジンを横断した並列検索が可能です。
• 主要なプラットフォーム上の公開コンテンツに対するソーシャルメディア検索ができます。
• Wayback Machine、archive.today、Google Cache などからのアーカイブ検索が可能です。
• サポートされているエンジンとアーカイブサービスの動的リスト表示ができます。
• LRU エビクションによる結果キャッシュを行い、繰り返しのクエリを高速化します。

📦 インストール

コマンドラインオプション

サーバー自体は追加の CLI フラグを必要とせず、すべての設定は JSON‑RPC を介して行われます。

🤝 LM Studio との統合

LM Studio がサーバーを自動的に起動できるように、mcp.json にエントリを追加します。

{
  "mcpServers": {
    "web-search": {
      "command": "/absolute/path/to/run.sh",
      "args": [
        "-d",
        "/absolute/path/to/working/directory"
      ],
      "env": { "WORKING_DIR": "." }
    }
  }
}

📌 スクリプトを実行可能にし (chmod +x /absolute/path/to/run.sh)、LM Studio を起動する前に ./run.sh を一度実行して仮想環境をインストールしてください。

📚 ドキュメント

📡 MCP API 概要

すべての通信は、stdin/stdout を介した JSON‑RPC 2.0 に従います。

initialize

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}

レスポンス: プロトコルバージョン (2024-11-05)、サーバー機能 (ツール列挙)、および基本的なサーバー情報 (name, version)。

tools/list

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

レスポンス: ツール定義の配列 (名前、説明、入力スキーマ)。

tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "<tool_name>",
    "arguments": { … }
  }
}

注意: ツール識別子のキーは name であり、tool ではありません。

🛠️ 利用可能なツール

web_search

複数のプライバシーに配慮したエンジンを使用して並列にウェブを検索します。

例

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "web_search",
    "arguments": {
      "query": "privacy focused search engines",
      "engine": "duckduckgo",
      "max_results": 15
    }
  }
}

サーバーは、各選択されたエンジンからのタイトル、URL、およびスニペットを含むフォーマットされたテキストブロックを返します。

social_search

主要なソーシャルメディアプラットフォーム上の公開コンテンツを検索します。

例

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "social_search",
    "arguments": {
      "query": "AI ethics research",
      "platform": "reddit"
    }
  }
}

レスポンスには、ブラウザで開くことができる直接の URL が含まれます。

archives_search

複数のウェブアーカイブサービスを横断して、URL のアーカイブバージョンを検索します。

例

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "archives_search",
    "arguments": {
      "url": "https://example.com",
      "service": "wayback",
      "check_availability": true
    }
  }
}

レスポンスには、アーカイブ URL がリストされ、要求された場合にはスナップショット数とタイムスタンプが含まれます。

list_engines

利用可能なすべてのプライバシーに配慮した検索エンジンをリストします。

例

{
  "jsonrpc": "2.0",
  "id": 13,
  "method": "tools/call",
  "params": {
    "name": "list_engines",
    "arguments": {}
  }
}

サーバーは、各エンジンの Markdown 形式の概要と使用上の注意を返します。

list_archives_services

サポートされているすべてのウェブアーカイブサービスをリストします。

例

{
  "jsonrpc": "2.0",
  "id": 14,
  "method": "tools/call",
  "params": {
    "name": "list_archives_services",
    "arguments": {}
  }
}

レスポンスには、各サービスの説明、ID、および主要な機能が含まれます。

clear_cache

内部の検索結果キャッシュをクリアします。

例

{
  "jsonrpc": "2.0",
  "id": 15,
  "method": "tools/call",
  "params": {
    "name": "clear_cache",
    "arguments": {}
  }
}

サーバーは確認メッセージを返します。

🔧 技術詳細

🔐 セキュリティ機能

• クエリサニタイズ – 制御文字を削除し、HTML タグを除去し、MAX_QUERY_LENGTH (500) を適用します。
• 厳格な URL 検証 – http:// または https:// スキームと有効なドメインのみを受け入れます。
• ブロックパターン – 正規表現により、<script> インジェクション、javascript: URI、およびイベントハンドラー属性を防止します。
• 入力スキーマ適用 – 各ツールは JSON‑RPC inputSchema を介して必須フィールドを検証します。
• レート制限 – asyncio セマフォアにより、同時外部リクエスト数を制限します (MAX_CONCURRENT_SEARCHES)。

© 2025 Undici77 – All rights reserved.