MCP · Claude Desktop

Claude Desktop 联网搜索 MCP 配置

给 Claude Desktop 加上有界联网搜索:编辑 claude_desktop_config.json,完全重启后即可使用 search_web,每条结果带 fetched_at。

配置文件在哪

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json
  • 也可从应用内打开:Settings → Developer → Edit Config。

配置 JSON

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

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

使用绝对命令路径

macOS 的图形应用不继承你 shell 的 PATH。如果工具一直不出现,把 command 字段的 "annolux-mcp" 换成绝对路径 —— 在终端运行 which annolux-mcp 查看,通常是 $HOME/go/bin/annolux-mcp。

完全重启

Claude Desktop 只在启动时读取配置。请完全退出应用 —— macOS 从菜单栏 Quit,Windows 从托盘退出,而不是只关窗口 —— 再重新打开。新对话的工具菜单里应出现 search_web。

还是不出现时

  • macOS 日志:~/Library/Logs/Claude/ —— 查看 mcp*.log。
  • Windows 日志:%APPDATA%\Claude\logs。
  • 单独测试服务器:在终端设置两个环境变量后运行 annolux-mcp —— 应正常启动并在 stdio 等待。
  • JSON 语法错误会导致整份配置被静默忽略 —— 编辑后请校验。

更新与移除

更新只需重跑 go install @latest —— 配置文件无需改动。移除则从 mcpServers 删除 annolux 条目并完全重启。同一文件里的其他 MCP 服务器不受影响;只要 JSON 合法,配置就有效。

边界与点数

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