Reactmcp

🚀 重新定義搜索：ReActMCP Web Search 中文版

ReActMCP Web Search 是一款專為 AI 助手框架打造的強大網絡搜索工具。它不僅提供基礎與高級的網絡搜索功能，還能通過 MCP 接口與其他 AI 工具無縫集成，為用戶帶來高效、穩定的搜索體驗。

🚀 快速開始

安裝

項目結構

ReActMCP Web Search/
├── servers/                  # MCP 服務器實現目錄
│   └── web_search.py        # 網絡搜索服務主文件
├── requirements.txt         # 必要的 Python 包依賴
└── README.md                # 項目文檔

安裝步驟

1. 克隆倉庫：

git clone https://github.com/yourusername/ReActMCP.git
cd ReActMCP/Web-Search

2. 安裝依賴項：

pip install -r requirements.txt

配置

環境變量配置

確保設置以下環境變量（通過 .env 文件）：

EXA_API_KEY=your_api_key_here

示例系統配置

在 web_search.py 中，您可以找到默認的配置參數。根據需要調整以下內容：

class WebSearchConfig:
    BASE_URL = "https://api.example.com"
    API_KEY_NAME = "EXA_API_KEY"
    TIMEOUT = 10  # seconds

啟動搜索服務器

MCP 服務器位於 servers 目錄中。運行服務器：

python servers/web_search.py

此命令將啟動 MCP 服務器，監聽請求並提供以下工具：

• search_web: 執行基礎網絡搜索。
• advanced_search_web: 帶有篩選選項的高級網絡搜索。

✨ 主要特性

• 豐富的搜索功能：支持基本和高級網絡搜索，滿足不同場景的需求。
• 可擴展架構：便於定製和擴展，適應各種業務變化。
• 高效搜索算法：確保快速返回搜索結果，提升用戶體驗。
• 穩定可靠：適用於各種應用場景，為業務提供堅實保障。

💻 使用示例

基礎用法

啟動服務器後，您可以使用以下工具進行搜索：

# 執行基礎網絡搜索
search_web(keyword="example")

# 執行帶有篩選選項的高級網絡搜索
advanced_search_web(keyword="example", url_limit=10)

📚 詳細文檔

功能介紹

• search_web: 執行基礎網絡搜索。
• advanced_search_web: 帶有篩選選項的高級網絡搜索。
• 支持多種搜索參數（如關鍵詞、URL限制等）。

測試

在 web_search.py 中，有一個測試函數 test_search()（當前已註釋）。要運行測試，請取消註釋測試執行塊並使用 Python 的 asyncio 運行器：

if __name__ == "__main__":
    import asyncio
    # 取消註釋以下行以執行測試搜索
    # asyncio.run(test_search())
    mcp.run()

這將打印示例查詢的搜索結果，並幫助您驗證工具是否正常工作。

Claude 桌面配置

在 config.json 中添加以下內容，使用此服務器：

{
  "mcpServers": {
    "websearch": {
         "command": "python",
         "args": ["path/to/servers/exa_web_search.py"]
       }
  }
}

故障排除

• 缺少 EXA_API_KEY: 確保 .env 文件正確設置，包含有效的 Exa API 密鑰。
• 依賴項問題: 檢查所有必要的 Python 包是否已安裝（參見 requirements.txt）。如果需要，請重新安裝包。
• API 錯誤: 如果在執行網絡搜索時遇到錯誤，請檢查您的網絡連接並驗證 Exa API 的狀態。

📄 許可證

此項目按 MIT 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。

🌟 貢獻與星曆史記錄

貢獻

歡迎貢獻！如果您有任何建議、錯誤修復或改進，請打開問題或提交拉取請求。

星曆史記錄