Annolux
中文 EN

MCP · Cursor

Cursor 联网搜索 MCP 配置

给 Cursor 的 Agent 加上 search_web 工具:一个 JSON 文件,精选中英索引,每条结果带 fetched_at。

项目级或全局

  • .cursor/mcp.json —— 仅当前仓库;可提交以共享服务器定义(不含密钥)。
  • ~/.cursor/mcp.json —— 本机所有项目。

配置 JSON

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

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

启用与批准

打开 Cursor Settings → MCP:列表中应出现 annolux 服务器及其 search_web 工具,未启用则打开开关。Agent 模式下模型会自行调用工具;默认每次调用前都请求你批准,因此你始终能看到即将发出的查询。

一个好用的具体问法

试试:「Vue 里用 TypeScript 定义 props 现在的正确写法是什么?用 domains 限定 vuejs.org 搜索。」Agent 会发起一次 search_web 调用,得到来自官方文档、各带 fetched_at 的排序结果,打开正确页面,并给出可核查的引用。一次成功调用,一点。

限定在你信任的文档站

在编辑器工作流里,domains 白名单是最有用的字段:让 Agent 把搜索限定在类库官方文档站,结果就不会跑出你信任的范围。Agent 写进代码或笔记的引用旁,请保留 fetched_at。

排障

  • 找不到二进制:把 command 换成 which annolux-mcp 得到的绝对路径。
  • 改了 JSON 没生效:在 Settings → MCP 刷新服务器列表,或重启 Cursor。
  • 空结果是精选索引的正常返回 —— 不是需要重试的错误。

边界与点数

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