mcpField
C
cco-tools

cco-tools

github.com/egorfedorovAgent 工作流12551 次安装1 天前更新
代码仓库

关于 cco-tools

cco-tools 记录各工具结果的实测 Token 成本,并按工具名汇总用量,帮助使用大量 MCP 的 Claude 会话识别上下文预算去向及不可靠的估算。

主要功能

  1. 01记录各工具的平均及最高成本
  2. 02汇总调用次数与累计用量
  3. 03标记样本少于 3 次的估算
  4. 04清除已学习的成本历史

适用场景

  1. 01查找消耗最多上下文预算的工具
  2. 02发现成本波动大的工具并缩小查询范围
  3. 03更改 MCP 配置后重新测量

MCP 相关

它测量 MCP 和 Agent 工具结果的 Token 成本;本身不提供 MCP 服务。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-tools

安装后在 Claude Code 中输入/cco-tools确认已加载。

详细介绍

CCO 工具——你的工具实际花费了多少

MCP 和 Agent 的 token 成本过去是一次性选定的常量(mcp__* ≈ 200 个输入 token, Agent ≈ 500 个 token)。实际结果可能相差数个数量级——“列出所有问题” 查询和只查一行使用的是同一个工具名称,但成本相差甚远。在 MCP 密集型会话中,预算计量器对最大的一项支出只能靠猜测。

CCO 现在会测量每个工具结果,并学习每个工具名称的平均值。

在插件根目录运行:

show(或不带参数)

node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js

打印学习到的表格:每个工具的调用次数、平均值、最坏情况和累计总量,并按总支出排序。

向用户解读结果时,值得关注的是:

  • total 最高的行就是实际消耗其上下文预算最多的地方。 它通常来自 MCP 服务,而不是文件读取。
  • 标有 · 的行样本少于 3 个,仍在使用内置常量——其估算值还不可靠。
  • avg 和 max 之间差距较大,说明该工具的开销难以预测;建议缩小查询范围(使用筛选条件、限制数量、分页),而不是弃用该工具。

与 /cco-overhead mcp 搭配使用——它显示哪些服务已配置但从未调用;本工具则显示已调用的服务实际花费了多少。

reset

node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js reset

清除学习到的表格,并将所有工具恢复为内置常量。更改 MCP 服务或其配置后,如果过去的测量结果已无法反映当前设置,这项操作会很有用。运行前请先确认——历史记录无法恢复。

评论

支持 Markdown