MCP · Windsurf

Windsurf 联网搜索 MCP 配置

给 Windsurf Cascade 加上 search_web 工具:一个 JSON 文件,精选中英索引,每条结果带明确抓取时间。

配置路径

  • ~/.codeium/windsurf/mcp_config.json —— 本机 Windsurf 的全局 MCP 配置文件。
  • 也可以通过 Windsurf 设置 → Cascade → MCP Servers 直接打开编辑。

配置 JSON

先安装 annolux-mcp 二进制(见下方 MCP 总览),再加入这段配置。把占位密钥换成真实密钥。

{
  "mcpServers": {
    "annolux": {
      "command": "annolux-mcp",
      "env": {
        "ANNOLUX_API_URL": "https://api.annolux.com",
        "ANNOLUX_API_KEY": "ann_live_REPLACE_ME"
      }
    }
  }
}

在 Agent 中使用搜索

在 Windsurf Cascade 中,当你询问最新类库、API 规范或调试错误时,Cascade 会自动调用 search_web 发起检索,并接收带明确抓取时间的结果。

限定在你信任的文档站

让 Cascade 将搜索限定在官方文档:「搜索 React Server Components 正确写法,限定 domains 为 react.dev」。结果保持干净精准。

排障

  • 找不到命令:在 command 中填入 which annolux-mcp 得到的绝对路径。
  • 更新 JSON 后,在 Cascade MCP 设置中选择刷新,或重启 Windsurf。
  • 空结果表示该查询不在精选索引内 —— 不是服务端故障。

边界与点数

search_web 查询精选中英索引。只有成功的 2xx 搜索扣 1 点,错误和超时不扣。新账户有 1,000 免费点数。