# 1) 后台起一个 SearXNG 当主后端（官方镜像）
docker run -d --name searxng -p 127.0.0.1:8809:8080 searxng/searxng:latest

# 2) 生成 API key（明文只打印一次，落盘仅 sha256 摘要）
mcp-search-server keygen --file ./apikeys.json

# 3) 启动本服务器（指向 SearXNG + 加载 key）
mcp-search-server serve --port 7397 --host 0.0.0.0 \
     --searxng-url http://127.0.0.1:8809 --api-keys-file ./apikeys.json

cc-node (MCP 客户端)
   │  http(s)://<host>:7397/mcp   +  Authorization: Bearer <api-key>
   ▼
mcp-search-server  (鉴权 + 暴露 MCP search 工具；零依赖)
   │  SEARXNG_URL=http://<searxng-host>:8809
   ▼
SearXNG  (多引擎聚合；google-cse / brave … 失败则本服务器回退 Bing)

# 起 SearXNG（官方镜像，默认 127.0.0.1:8809 即可）
docker run -d --name searxng -p 127.0.0.1:8809:8080 searxng/searxng:latest

node src/cli.js keygen --file ./apikeys.json
# 输出（仅一次，妥善保存）：
#   新 API Key（仅此一次显示，请妥善保存）
#   ms2_xxxx….（这是一串随机长串）

# 推荐：指向自建 SearXNG（主），未配时自动回退 Bing
node src/cli.js serve --port 7397 --host 0.0.0.0 \
     --searxng-url http://127.0.0.1:8809 \
     --api-keys-file ./apikeys.json

# 也用环境变量（优先级：命令行 > env）
export PORT=7394 API_KEYS=ms2_xxx,yyy SEARXNG_URL=http://127.0.0.1:8809
node src/cli.js serve --host 0.0.0.0

cloudflared tunnel --url http://127.0.0.1:7394
# 得到 https://xxx.trycloudflare.com —— 客户端连该地址 /mcp

location /mcp {
    proxy_pass http://127.0.0.1:7394;
    proxy_http_version 1.1;
    proxy_set_header Connection '';
    proxy_buffering off;
    proxy_read_timeout 120s;
}

{
  "mcp": {
    "servers": {
      "search": {
        "type": "http",
        "url": "https://search.example.com/mcp",
        "token": "ms2_你复制的key"   // cc-node 会原样作为 Bearer 透传
      }
    }
  }
}

import { MCPRegistry } from 'cc-node/src/mcp/index.js'
const r = new MCPRegistry()
r.register('search', { type: 'http', url: 'https://search.example.com/mcp', token: 'ms2_xxx' })
await r.connectAll()
const tools = r.getAllTools()                                   // [{name:'search', …}]
const res = await r.callTool('search', 'search', { query: 'Node.js 微服务', count: 5 })
console.log(res.content[0].text)

src/
├── searxng.js     SearXNG JSON 客户端（主后端；聚合 google-cse/brave…）
├── bing.js        Bing 网页抓取（let 兜底，无 SearXNG 时）
├── ddg.js         DuckDuckGo 抓取（保留为可选显式后端，不默认）
├── auth.js        API Key 生成 / 鉴权 / 摘要存储（sha256, CSPRNG, 常量时间比较）
├── protocol.js    MCP JSON-RPC 核心分发（initialize/tools.*,…；后端 failover 规划）
├── server.js      Streamable HTTP 服务器（鉴权中间件 + JSON/SSE 应答）
├── cli.js         CLI：keygen / serve
└── index.js       库入口
test/              单测 + 集成（含 fake-fetch 离线鉴权/解析/failover 测试）

npm test          # 等价 node --test test/*.test.js

// cc-node 的 .claude-code/config.json
{ "mcp": { "servers": { "search": {
    "type": "http", "url": "http://<本机或反代>:7397/mcp", "token": "ms2_xxx" } } } }