Annolux

MCP · Claude Code

Claude Code 联网搜索 MCP 配置

一条命令给 Claude Code 加上 search_web 工具:基于精选中英索引的有界搜索,每条结果带 fetched_at。

一条命令添加

先安装 annolux-mcp 二进制(见下方 MCP 总览),然后在终端注册。把占位密钥换成你账户里的真实密钥。

claude mcp add annolux --env ANNOLUX_API_URL=https://api.annolux.com --env ANNOLUX_API_KEY=ann_live_REPLACE_ME -- annolux-mcp

MCP 总览与服务器安装

选对作用域

不要提交明文密钥。共享的 .mcp.json 里应引用环境变量 —— Claude Code 会从每位开发者自己的环境展开 ${ANNOLUX_API_KEY}。

local(默认)—— 仅本机本项目。
--scope project —— 在仓库写入 .mcp.json,团队共享服务器定义。
--scope user —— 本机所有项目可用。

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

验证生效

运行 claude mcp list 确认服务器已注册,或在会话内输入 /mcp 查看状态和 search_web 工具。然后让 Claude 搜一个具体问题 —— 例如用 domains 白名单限定站点 —— 并要求它在引用链接旁标注 fetched_at。

同一注册对 claude -p 的非交互运行同样生效,脚本化 Agent 无需额外配置即可调用同一个有界工具。

Agent 可以依赖的行为

只有成功的 2xx 搜索扣 1 点;错误和超时不扣点。
空结果是正常返回 —— 应当处理,而不是盲目重试。
freshness 会被明确拒绝;索引为精选、按计划刷新,非实时。
limit 上限 10,timeout 上限 30 秒。

更新与移除

更新服务器只需重跑 go install @latest —— 注册信息本身不变。取消注册要在添加时的同一作用域移除;不确定在哪个作用域时,先运行 claude mcp list 查看。

claude mcp remove annolux

其他客户端