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。