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 免费点数。