ReActMCP Web Search

基本能力

产品定位

ReActMCP Web Search 是一个专注于网络搜索的 MCP 服务器，旨在为 AI 助手提供实时、准确的网络搜索能力。

核心功能

• 基本网络搜索：使用 Exa API 执行简单的搜索。
• 高级网络搜索：支持额外的过滤选项，如域名限制、文本包含要求和日期过滤。
• Markdown 输出：将搜索结果格式化为 Markdown，便于集成标题、URL 和摘要。
• MCP 集成：轻松将该工具集成到 MCP 服务器生态系统中，实现多工具 AI 辅助。

适用场景

• AI 助手需要实时网络搜索功能时。
• 需要高级搜索过滤选项（如特定域名或日期范围）的场景。
• 需要将搜索结果以结构化格式（如 Markdown）返回的应用。

工具列表

• search_web：执行基本网络搜索。
• advanced_search_web：执行高级网络搜索，支持多种过滤选项。

常见问题解答

• Missing EXA_API_KEY：确保 .env 文件中正确设置了有效的 Exa API 密钥。
• Dependency Issues：验证所有必要的 Python 包是否已安装（检查 requirements.txt 文件）。
• API Errors：检查网络连接并验证 Exa API 状态。

使用教程

使用依赖

• Python 3.8+
• python-dotenv
• exa_py（Exa API 客户端）

安装教程

1. 克隆仓库 bash git clone https://github.com/mshojaei77/ReActMCP.git cd ReActMCP
2. 创建虚拟环境（可选但推荐） bash python -m venv venv source venv/bin/activate # Windows 使用：venv\Scripts\activate
3. 安装依赖 bash pip install -r requirements.txt

调试方式

1. 运行 Web 搜索服务器 bash python servers/web_search.py
2. 测试工具 在 web_search.py 中，取消注释 test_search() 函数并运行： python if __name__ == "__main__": import asyncio asyncio.run(test_search()) mcp.run()

许可证

该项目遵循 MIT 开源许可条款。