JinDaGe - ReActMCP MCP Details

article

README

🚀 重新定义搜索：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 文件。

🌟 贡献与星历史记录

贡献

欢迎贡献！如果您有任何建议、错误修复或改进，请打开问题或提交拉取请求。

ReActMCP