Mcpwebsearch

🚀 📂 MCP Web Search Server

MCP Web Search Server是一個注重隱私的網絡、社交媒體和存檔搜索服務器，它通過模型控制協議（MCP）提供工具，以實現對外部搜索功能的受控訪問。

🚀 快速開始

# 克隆倉庫（如果適用）
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 搜索服務器（main.py），它會在標準輸入/輸出上監聽 JSON-RPC 消息。

📌 確保啟動腳本可執行：chmod +x run.sh

✨ 主要特性

• 並行搜索：可跨多個注重隱私的網絡搜索引擎進行並行搜索。
• 社交媒體查詢：可在主要平臺上查找公開內容。
• 存檔檢索：可從互聯網檔案館（Wayback Machine）、archive.today、谷歌緩存等獲取存檔。
• 動態列表：可動態列出支持的搜索引擎和存檔服務。
• 結果緩存：採用最近最少使用（LRU）淘汰策略進行結果緩存，以加快重複查詢的速度。

📦 安裝指南

# 克隆倉庫（如果適用）
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 搜索服務器（main.py），它會在標準輸入/輸出上監聽 JSON-RPC 消息。

📌 確保啟動腳本可執行：chmod +x run.sh

⚙️ 命令行選項

服務器本身不需要額外的命令行標誌；所有配置均通過 JSON-RPC 完成。

🤝 與 LM Studio 集成

在 mcp.json 中添加一個條目，以便 LM Studio 可以自動啟動服務器：

{
  "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 概述

所有通信均通過標準輸入/輸出遵循 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 標籤，並強制限制最大查詢長度（500）。
• 嚴格的 URL 驗證：僅接受具有有效域名的 http:// 或 https:// 協議的 URL。
• 阻止模式：使用正則表達式防止 <script> 注入、javascript: URI 和事件處理程序屬性。
• 輸入模式強制：每個工具通過 JSON-RPC inputSchema 驗證必需字段。
• 速率限制：使用異步 I/O 信號量限制併發外部請求（MAX_CONCURRENT_SEARCHES）。

© 2025 Undici77 – 保留所有權利。