MCP边缘搜索服务器

一个提供网页搜索功能的MCP协议服务器，支持Claude桌面等MCP客户端。

概述

MCP边缘搜索服务器提供了以下主要功能：

1. 网页搜索：使用必应进行网络搜索并获取格式化结果
2. 网页内容检索：从任意网页中提取和清理文本内容

该服务器专为与MCP客户端（如Claude Desktop）配合设计，允许AI助手执行网络搜索并获取信息。

功能特点

• 简单轻量的Python实现
• 不需要浏览器自动化（仅使用HTTP请求）
• 清洁网页文本提取
• 详细日志记录便于故障排查
• 测试模式以验证功能而无需MCP客户端

先决条件

• 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"

与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替换为此仓库的实际路径。

1. 重启Claude Desktop
2. 点击“启用网络搜索”按钮

故障排除

服务器断开连接错误

如果在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。