把 geo-score 用作 MCP 服务

geo-score-mcp 是一个走 stdio、只用 Python 标准库的本地 MCP 服务。它给 Agent 的能力和命令行一样分三级：免费给网站打分、向 AI 引擎问一个问题、按周追踪一组问题。只有调用 AI 服务商的两个工具会花钱，而且只用你交给服务的 Key。

怎么把 geo-score 加进 Claude Code？

claude mcp add --scope user geo-score -- uvx geo-score@1.8.3 mcp

这行用 uvx 从 PyPI 运行 1.8.3 版，只需要装好 uv。claude mcp list 可以看服务是否连上，会话里输入 /mcp 可以看到它的工具。想要一个花不了钱的服务，在 mcp 后面加 --read-only。

怎么接入其他客户端？

凡是读 mcpServers 配置文件的客户端，都可以用这份标准配置，文件里不放任何 Key：

{
  "mcpServers": {
    "geo-score": {
      "command": "uvx",
      "args": ["geo-score@1.8.3", "mcp"]
    }
  }
}

Claude Desktop 不读你 shell 里的 PATH，所以 command 要写 which uvx 打印出的完整路径。各客户端（Claude Code、Claude Desktop、Codex、Cursor、VS Code、Gemini CLI、Devin Desktop、Zed）的配置，以及 Claude Code 插件、Claude Desktop 扩展和 Docker，见 guide/mcp.zh-CN.md。

服务提供哪些工具？

工具	级别	费用	作用
`score_site`	1	免费	按量表给网址打 0–100 分，只连接公网地址。
`ask`	2	用你的 Key	向你有 Key 的每家引擎问一个问题，报告回答引用了谁。
`run`	3	用你的 Key；`dry_run` 免费	跑一遍追踪的问题集，结果保存在配置文件旁边。
`list_runs`	3	免费	列出已保存的运行。
`report`	3	免费	报告某一次运行，或汇总某日以来的运行。
`diff`	3	免费	比较两次运行，只有配对检验认定时才算「有变化」。
`status`	—	免费	说明现在能跑什么，不花任何钱。

服务还把量表作为资源 geo-score://rubric/v1.1 提供，并带五个提示词模板：audit_site、check_citations、weekly_watch、compare_runs、explain_check。

怎么让服务一分钱都不花？

用 --read-only 启动：ask 和 run 会被去掉，服务提供的任何东西都花不了钱。不加时，ask 和 run 从服务自己的环境变量里读服务商 Key（OPENAI_API_KEY、PERPLEXITY_API_KEY、GEMINI_API_KEY、ANTHROPIC_API_KEY、OPENROUTER_API_KEY），那不是你终端的环境。Agent 只能收紧你 watch 配置里的上限，不能放宽。

可以让 Agent 做些什么？

「给 https://acme.com 做 AI 搜索就绪度打分，列出最能加分的 3 项。」Agent 会调用 score_site。
「把我追踪的问题空跑一遍，告诉我计划调用多少次、上限是多少。」Agent 会带 dry_run 调用 run，不花钱。
「比较最近两次 watch：哪些引擎变了，有没有超出噪声的变化？」Agent 会调用 diff。