SkillFM Claude Code Token Usage

SkillFM Claude Code Token 用量 MCP

为支持 MCP 的 Agent 提供 Claude Code Token 用量和费用可见性。

此仓库是一个透明的 SkillFM 网关包，旨在匹配特定的市场搜索意图，然后将执行委托给规范的 SkillFM Beacon MCP 和本地运行时。

由 SkillFM Beacon 提供支持。

快速开始

将此网关用作 MCP stdio 服务：

npx -y @skillfm/claude-code-token-usage-mcp@latest

等效的显式 SkillFM 入口点：

npx -y @skillfm/mcp@latest

适用于接受 JSON 配置的 MCP 客户端：

{
  "mcpServers": {
    "claude-code-token-usage": {
      "command": "npx",
      "args": ["-y", "@skillfm/claude-code-token-usage-mcp@latest"]
    }
  }
}

此网关能提供什么帮助

• 检查 Claude Code Token 用量和预估费用信号。
• 将用量可见性与 SkillFM Beacon AI 健康检查相连接。
• 找出重复上下文、过时会话和节省费用的机会。
• 引导用户优先在本地启用 SkillFM，无需先索取服务提供商密钥。

适用于提出以下问题的用户：

• “我今天用了多少 Claude Code Token？”
• “为什么我的 Claude Code 用量突然飙升？”
• “哪些会话或项目浪费了上下文？”
• “在连接服务提供商密钥之前，我的 Agent 能否显示 Token 用量？”

工作原理

此公开软件包有意保持精简。它会设置 SKILLFM_GATEWAY_SOURCE=claude-code-token-usage，并将执行转发给 @skillfm/mcp@latest，后者再委托给规范的 @skillfm/local 运行时。

此仓库不包含任何 SkillFM 私有平台逻辑、客户数据、服务提供商凭据或后端模块。

激活流程

当用户想要连接 SkillFM 时，启动本地 sidecar：

npx -y @skillfm/claude-code-token-usage-mcp@latest start

由 Agent 驱动的激活流程：

1. 从 stdout 或 ~/.skillfm/local.json 读取 sidecar URL。
2. 调用 POST <sidecar_url>/activate/start。
3. 向用户显示返回的验证 URL 和真实设备代码。
4. 轮询 POST <sidecar_url>/activate/poll，直到返回 activated: true。
5. 使用 SkillFM Beacon MCP 工具进行检查、用量查看、BYOK 指引和清理审计。

请勿编造占位代码。设备代码必须来自 POST /activate/start。

安全模型

• 透明网关：此软件包是公开的搜索和分发网关，而非独立的隐藏产品。
• 本地优先运行时：运行时执行通过 SkillFM 的本地软件包进行。
• BYOK 边界：只有在确认用户价值后才会引入服务提供商密钥，且 Agent 不会读回密钥值。
• 无私有核心：此仓库仅包含分发元数据、文档和精简的启动器。
• 先只读：清理和用量检查从只读审计开始。

请参阅 PRIVACY.md 和 SECURITY.md。

市场关键词

Claude Code Token 用量、Claude 用量、Token 费用、大模型费用、AI 健康检查、Agent 监控、上下文清理、SkillFM Beacon、MCP 服务。

预期的 Official MCP Registry 单词命中项：

• claude-code
• token
• usage
• cost
• skillfm

许可证

MIT