AI导哈

MCP使用追踪器

MCP使用追踪器是一个解析Claude Code转录文件并提供Codex、Gemini和Context7等MCP提供商使用情况分析的工具。

  • by hyunseokjeong-madup
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hyunseok-blue/mcp-usage-tracker

使用说明

MCP Usage Tracker

Claude Code MCP 프로바이더 사용량 분석기
Track Codex, Gemini, and Context7 usage across your Claude Code sessions

这是什么？

当您将Claude Code与MCP提供商一起使用时，例如 法典 （OpenAI）， 双子座 （谷歌），以及 背景7，没有内置的方法来查看您使用每个提供商的量。

MCP使用跟踪器解析您的Claude代码转录文件，并为您提供以下内容的清晰细分：

  • 每个提供商的呼叫计数（Codex、Gemini、Context7）
  • 使用的代理角色（架构师、设计师、评论家等）
  • MCP通话时间表
  • 聚合多个会话的统计数据

演示

╔══════════════════════════════════════════╗
║   MCP Usage Tracker                      ║
║   Codex · Gemini · Context7              ║
╚══════════════════════════════════════════╝

 Session: 8a0bbbd8-a02  |  Opus  |  45m  |  2026-02-19 22:10
  Tools: 64 total, 11 MCP (17%)
  [Cx] Codex (OpenAI)       █████████████░░ 4 calls
  [Gm] Gemini (Google)      ██████░░░░░░░░░ 2 calls
  [C7] Context7 (Docs)      ████████████████ 5 calls

需求

  • python 3.8+（无外部依赖）
  • 克劳德代码 带有文字记录文件

安装

git clone https://github.com/hyunseok-blue/mcp-usage-tracker.git ~/mcp-usage-tracker
chmod +x ~/mcp-usage-tracker/mcp-tracker.py

添加别名（可选）

增添 ~/.zshrc 或 ~/.bashrc:

alias mcpt='~/mcp-usage-tracker/mcp-tracker.py'

用法

# Current session (latest transcript)
mcpt

# With detailed breakdown (roles, actions, timeline)
mcpt -v

# All sessions with aggregate summary
mcpt --all

# Last 5 sessions
mcpt --last 5

# Specific session
mcpt --session 8a0bbbd8

# Live watch mode (refreshes every 3s)
mcpt --watch

# JSON output (for scripting)
mcpt --json

# Custom transcript directory
mcpt --dir ~/.claude/projects/my-project/

提供商检测

提供者 MCP工具模式 图标
食品法典委员会（OpenAI） mcp__*_x__ask_codex, *_x__list_jobs等等。 [Cx]
双子座（谷歌） mcp__*_g__ask_gemini, *_g__list_jobs等等。 [Gm]
背景7 mcp__*context7* [C7]
其他MCP 任何其他 mcp__* 工具 [MC]

运作原理

Claude Code将对话记录作为JSONL文件存储在 ~/.claude/projects/。每行包含一条带有工具调用的消息。此脚本：

  1. 在Claude Code项目目录中查找转录文件
  2. 解析每一行JSONL以查找 tool_use 块
  3. 按提供程序模式匹配对MCP工具调用进行分类
  4. 提取元数据（代理角色、后台模式、时间戳）
  5. 渲染彩色终端仪表板

观看模式

监视模式持续监视最新的成绩单，并每3秒更新一次，这在活动编码会话中很有用：

mcpt --watch

按 Ctrl+C 退出。

文件

~/mcp-usage-tracker/
├── mcp-tracker.py   # Main tracker script
├── README.md
└── LICENSE

许可证

麻省理工学院

Track your AI provider usage like a pro

相关 MCP