LLM Token Tracker 是一个用于追踪 OpenAI、Claude 和 Gemini API Token 用量与成本的开源工具，支持 MCP（Model Context Protocol），目标是把准确的 API 成本传递给最终用户。
用途
用于统计和管理调用 AI API 时产生的 Token 消耗与费用，帮助开发者了解每个用户或每次会话的实际成本。
主要能力
- 简单集成：一行代码即可包裹 API 客户端。
- 自动追踪：无需手动计数 Token。
- 准确计费：内置 2025 年所有模型的最新定价。
- 多提供商：支持 OpenAI、Claude、Gemini。
- 用户管理：可按用户/会话追踪用量。
- 货币支持：美元（USD）和韩元（KRW）。
- MCP 服务器：可直接在 Claude Desktop 中使用。
- 直观会话追踪：实时用量与进度条显示。
- 文件持久化：会话数据在服务器重启后仍保留，自动保存至 ~/.llm-token-tracker/sessions.json，对 npm 和本地安装均有效，无需配置。
- 实时汇率：自动将美元转换为韩元，使用 exchangerate-api.com，带 24 小时缓存和后台自动更新。
使用方式
作为库使用
用一行代码包裹真实的 OpenAI/Anthropic API 客户端即可启用自动追踪。示例运行命令见仓库的 examples/basic-usage.js。
作为 MCP 服务器使用
将配置添加到 Claude Desktop 设置文件（~/Library/Application Support/Claude/claude_desktop_config.json）。添加后可在 Claude 中执行如下操作：
- “Calculate current session usage”：查看当前会话用量。
- “Calculate current conversation cost”：获取含输入/输出 Token 的成本明细。
- “Track my API usage”。
- “Compare costs between GPT-4 and Claude”。
- “Show my total spending today”。
可用工具
- get_current_session（推荐）：获取当前会话用量，返回已用/剩余 Token、输入/输出明细、成本与进度条；默认 user_id 为 current-session，默认预算 190,000 Token，适合实时对话追踪。
- track_usage：追踪一次 AI API 调用的 Token 用量，参数为 provider、model、input_tokens、output_tokens、user_id。
- get_usage：获取指定用户或所有用户的用量摘要。
- compare_costs：比较不同模型的成本。
- clear_usage：清除某用户的用量数据。
- get_exchange_rate：查看当前汇率。
API 参考
- new TokenTracker(config)：config.currency 为 'USD' 或 'KRW'（默认 'USD'）；config.webhookUrl 为可选的用量通知 webhook。
- tracker.wrap(client)：包裹 OpenAI 或 Anthropic 客户端以自动追踪。
- tracker.forUser(userId)：创建指定用户的追踪实例。
- tracker.startTracking(userId?, sessionId?)：开始手动追踪会话，返回追踪 ID。
- tracker.endTracking(trackingId, usage)：结束追踪并记录用量。
- tracker.getUserUsage(userId)：获取某用户的总用量。
- tracker.getAllUsersUsage()：获取所有用户的用量摘要。
支持的模型与定价
仓库列出 Anthropic（2025）和 Google Gemini（2025）的定价信息，价格按每 1,000 Token 计。批量 API 可享 50% 折扣，提示缓存最多可降低 90% 成本。具体模型价格表未在资料中以文本形式提供。
适用场景
适合需要透明化 AI API 计费的开发者，尤其是按用户或按会话核算成本、对比不同模型花费、在 Claude Desktop 中实时查看用量与预算进度的场景。
限制
资料未提供安装命令、支持的全部模型清单、价格表具体数值、平台兼容性范围以及收费或开源许可细节，这些事实暂未提供。
