MCP Edge Search

🚀 MCP邊緣搜索服務器

MCP邊緣搜索服務器是一個提供網頁搜索功能的MCP協議服務器，它專為與Claude桌面等MCP客戶端配合使用而設計，能讓AI助手執行網絡搜索並獲取信息，為用戶帶來便捷的網絡搜索體驗。

🚀 快速開始

運行環境準備

在運行此服務器之前，你需要確保滿足以下先決條件：

• 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"

✨ 主要特性

• 簡單輕量：採用Python實現，簡單且輕量。
• 無需瀏覽器自動化：僅使用HTTP請求，無需瀏覽器自動化操作。
• 清潔網頁文本提取：能夠從網頁中提取和清理文本內容。
• 詳細日誌記錄：詳細的日誌記錄便於故障排查。
• 測試模式：支持測試模式，可在無需MCP客戶端的情況下驗證功能。

📦 安裝指南

1. 克隆或下載此倉庫。
2. 安裝所需的依賴項：

pip install -r requirements.txt

💻 使用示例

作為MCP服務器運行

python edge_search_server.py

測試模式

測試搜索功能

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。