33 v0.2.20 更新于 2026-11-03

headroom MCP Server

通过 MCP 为编码智能体提供实时的订阅额度、重置时间和预算检查。

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(npm)

{
  "mcpServers": {
    "headroom": {
      "command": "npx",
      "args": [
        "-y",
        "headroomd"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

quota_status

返回所有 Headroom 仪表的最新配额窗口。

quota_can

检查某个操作类别是否可以消耗其所有仪表,可原子预留学习到的成本。

quota_events

返回自某个 ISO 时间戳或时长以来的 Headroom 事件。

quota_lease_start

为编排器预留一个仪表(租约开始)。

quota_lease_end

结束一个仪表租约,非所有者需 force 与 reason 并被审计。

quota_leases

列出仪表租约及预估花费。

quota_cost

按操作类别返回已花费百分比的学习中位数、四分位距和样本数。

quota_rate

返回最近 N 分钟内每小时百分比消耗速率,need 可选择厂商报告窗口。

quota_spend

按所有者归因共享仪表上的花费,附带置信度。

quota_inbox

定义在片段中被截断,推测与读取收件箱消息相关。