MCP 网页搜索服务器

一个提供网页搜索功能的 模型上下文协议（MCP）服务器，可部署在 Render 上。

使用官方 MCP SDK 以 Python 构建，支持 SSE（服务器发送事件） 传输，以最大限度地兼容 AIPI、Claude Desktop 等 MCP 客户端。

提供的工具

Related MCP server: MCP Search & Fetch

🚀 部署到 Render（分步指南）

1. 将此仓库推送到 GitHub

cd mcp-web-search
git init
git add .
git commit -m "Initial commit"
# create a repo on github.com, then:
git remote add origin https://github.com/YOUR_USERNAME/mcp-web-search.git
git push -u origin main

2. 在 Render 上创建新的 Web 服务

1. 前往 render.com → 新建 → Web 服务

2. 连接你的 GitHub 仓库（mcp-web-search）

3. Render 将自动检测 render.yaml — 点击 应用

4. 在 Render 仪表板中设置环境变量：

5. 点击 创建 Web 服务 — Render 将自动构建并部署。

你的服务器 URL 将是：https://mcp-web-search.onrender.com（或类似地址）

🔌 连接到 AIPI

在 AIPI 的"添加自定义 MCP"对话框中，粘贴此配置：

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

将 YOUR-SERVICE 替换为你实际的 Render 服务名称（例如 mcp-web-search-j73g）。

其他 MCP 客户端

适用于任何支持 SSE 传输的 MCP 客户端：

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

🔍 搜索提供商

在 Render 环境变量中设置 SERPER_API_KEY 以使用 Serper。如果缺少该密钥，服务器将自动回退到 DuckDuckGo。

🧪 本地测试

pip install -r requirements.txt
SERPER_API_KEY=your_key python server.py

健康检查：

curl http://localhost:3000/

服务器默认运行在 3000 端口。设置 PORT 环境变量可更改端口。

⚠️ 免费套餐说明

Render 的免费套餐在闲置 15 分钟后会休眠（冷启动约 30 秒）。 升级到**入门套餐（每月 7 美元）**以保持始终在线。