web-search-mcp

对外提供 HTTP 的 web_search 服务：把搜索请求转发给支持服务端搜索的 LLM API 网关 （如 fengwind 的 -search 后缀模型），返回带来源引用的答案。多供应商自动兜底。

零依赖 Node.js（18+，自带 fetch），Docker 镜像无需 npm install，跨平台 （amd64 / arm64）。

为什么有这个东西

参照 fengwind 网关实测结论：

• 普通模型不支持服务端搜索；-search 后缀模型（如 deepseek-v4-flash-search）可用， chat 与 responses 两种格式均返回实时结果 + [n](url) 来源引用。

• 中文请求体必须 ASCII 转义（\uXXXX）发送，直接发中文会随机乱码或 HTTP 000 断连 （本服务已对所有供应商统一处理，见 src/ascii.js）。

• 同一家网关可能波动，多供应商按优先级兜底更稳。

Related MCP server: evo-scry

快速开始（Docker）

cp .env.example .env    # 填入你的 key / 网关
docker compose up -d --build
curl http://localhost:3000/health

配置（JSON 环境变量）

单个 provider：

{
  "name": "fengwind",
  "baseURL": "https://api.fengwind.com",
  "apiKey": "sk-...",
  "model": ["deepseek-v4-flash-search", "deepseek-v4-pro-search"],
  "format": "chat",
  "timeoutMs": 120000,
  "priority": 0
}

配置项非法不会导致启动失败：坏条目被跳过并打印告警，可通过 /health 的 providerCount 核对。全部为空时 /search 返回 503。

HTTP API

POST /mcp（MCP Streamable HTTP 端点）

符合 MCP 协议（JSON-RPC 2.0，2025-03-26），供 Reasonix / Claude Desktop 等 MCP 客户端直接接入：

Reasonix 配置（config.toml 或 .mcp.json）：

[[plugins]]
name = "web-search"
type = "http"
url  = "https://box6-cu.15546991.xyz:14443/web_search/mcp"
# call_timeout_seconds = 180   # 搜索可能耗时较长，建议放宽

本实现只支持非流式 POST 响应（GET /mcp 返回 405）。

POST /search

curl -s http://localhost:3000/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"今天有什么重大新闻？"}'

{
  "ok": true,
  "query": "今天有什么重大新闻？",
  "answer": "……实时内容（带 [1](url) 引用）……",
  "sources": ["https://news.cn/..."],
  "provider": "fengwind",
  "model": "deepseek-v4-flash-search",
  "format": "chat",
  "latencyMs": 8421
}

可选字段 provider：指定只用某一家（{"query":"...","provider":"fengwind"}），用于单独验证。

全部供应商失败时返回 502 与 errors 列表（每家失败原因），方便排查。

⚠️ Windows 下 curl 命令行直接写中文会按本地代码页（GBK）编码，导致请求体损坏 （实测会变成乱码）。请用 UTF-8 文件发送：curl -d @request.json，或使用 Node/Python 等客户端（它们默认 UTF-8）。

GET /health

运行状态、供应商列表、超时配置。Docker HEALTHCHECK 使用此端点。

GET /providers

已配置供应商（key 脱敏为 sk-81b7...e785）。

本地运行（不用 Docker）

WEBSEARCH_CONFIG='{"providers":[...]}' node src/server.js
npm test   # 冒烟测试：假网关验证双格式 / ASCII 转义 / 兜底

目录结构

src/ascii.js     中文 → \uXXXX ASCII 转义（fengwind 实测坑）
src/providers.js JSON 环境变量解析、校验、排序、脱敏
src/search.js    双格式调用、引用提取、多供应商兜底
src/server.js    HTTP 服务与入口
test/smoke.mjs   冒烟测试（本地假网关，不发真实请求）