cc-usage-mcp

Claude Code 用量追踪 MCP 服务器，支持 Windows / macOS / Linux。

解析本地 ~/.claude/projects/ 下的 JSONL 会话文件，统计 token 用量和费用。

功能

• usage_summary - 按项目/模型/日期汇总用量和费用，支持时间范围筛选
• usage_today - 查看今日用量
• usage_session - 查看指定会话或最近会话的用量
• usage_cost_estimate - 估算指定 token 数量的费用

安装

npm install
npm run build

配置

在 Claude Code 的 MCP 设置中添加：

方式一：项目级配置 (.claude/settings.json)

{
  "mcpServers": {
    "cc-usage": {
      "command": "node",
      "args": ["d:/temp/ikun-cc-usage-mcp/dist/index.js"]
    }
  }
}

方式二：全局配置 (~/.claude/settings.json)

{
  "mcpServers": {
    "cc-usage": {
      "command": "node",
      "args": ["/path/to/cc-usage-mcp/dist/index.js"]
    }
  }
}

路径根据你的系统调整：

• Windows: "d:/temp/ikun-cc-usage-mcp/dist/index.js"
• macOS/Linux: "/home/user/cc-usage-mcp/dist/index.js"

支持的模型计价

| 模型 | Input | Output | Cache Write | Cache Read | |------|-------|--------|-------------|------------| | claude-opus-4-6 | $15/M | $75/M | $18.75/M | $1.5/M | | claude-sonnet-4-6 | $3/M | $15/M | $3.75/M | $0.3/M | | claude-haiku-4-5 | $0.8/M | $4/M | $1/M | $0.08/M |