🚀 重新定义搜索：ReActMCP Web Search 中文版
ReActMCP Web Search 是一款专为 AI 助手框架打造的强大网络搜索工具。它不仅提供基础与高级的网络搜索功能，还能通过 MCP 接口与其他 AI 工具无缝集成，为用户带来高效、稳定的搜索体验。
🚀 快速开始
安装
项目结构
ReActMCP Web Search/
├── servers/ # MCP 服务器实现目录
│ └── web_search.py # 网络搜索服务主文件
├── requirements.txt # 必要的 Python 包依赖
└── README.md # 项目文档
安装步骤
- 克隆仓库：
git clone https://github.com/yourusername/ReActMCP.git
cd ReActMCP/Web-Search
- 安装依赖项：
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 文件。
🌟 贡献与星历史记录
贡献
欢迎贡献！如果您有任何建议、错误修复或改进，请打开问题或提交拉取请求。