懒加载 MCP 代理
MCP 架构成本最高降低 90 %。客户端只看到 2 个工具而不是 50+；上游在首次 call_tool 时启动，空闲即休眠。
节省最多 60 % 的 Token 支出
上下文 尽在掌控
团队约 40 % 的 Token 预算浪费在噪音上：未使用的 MCP 架构、离题的聊天记录、废弃项目。tokenguard 找出这些泄漏，并用一条命令消除。
scan → mcp lazy → chats compact → budget。无账号、无网络调用，MIT。
$ tokenguard scan
Harnesses & chats
Harness Found Chats Size
──────────────── ───── ───── ───────
DeepSeek Harness yes 12 15.9 MB
ℹ total sessions: 12 (15.9 MB)
MCP
Client Server Tools ~Tokens Verdict
────── ────── ───── ─────── ───────
DSH safari 2 ~221 lazy ✓
$ tokenguard chats drift --all
OpenRouter Explorer Free 939 ≈2.1M split
Digital twins 859 ≈1.8M split
⚠ 3 chats drifted — splitting recommended
$ tokenguard mcp lazy safari --apply
✓ Lazy proxy: ~/.tokenguard/lazy/safari.cjs
✓ idle timeout: 10min
$
−87% schema tokens
快速 · 安全 · 本地 · 开源
为什么团队会安装它
每个功能都堵住 一处具体泄漏
默认 dry-run。不加 --apply 不会改动任何内容，且修改前会先写备份。
主题漂移检测
精确定位对话偏离主题的那条消息，并估算开新对话可收回的 Token。完全离线，无需 LLM。
对话压缩
将 500+ 条消息压缩为一份结构化摘要 — 请求、文件、命令、关键主题 — 并保留最后 8 条原文。新对话即纯净上下文。
Token 分析与预算
按天、会话、工具、模型查看支出。设定每日上限，超支即让 CI 构建失败。通过 pricing.json 估算美元成本。
项目卫生
按 Git 指标找出死库与未完成仓库，并用 git bundle + tar + 清单归档。一条 clone 即可恢复。
文档检查
捕获断链、版本与端口冲突、重复段落、过时的「截止日期」。过时文档不再浪费上下文。
兼容性
适配您 既有的工具链
对话、重命名、MCP 配置与懒加载代理，覆盖所有主流开发工具。
| 工具 | 对话 | 重命名 | MCP 配置 | 懒加载 |
|---|---|---|---|---|
| DeepSeek Harness | 完整 | 原生 | YAML 配置 | 代理 + --apply |
| Claude Code | 读取 | — | ~/.claude.json | 代理 |
| OpenAI Codex CLI | 尽力而为 | — | config.toml | 代理 |
| Gemini CLI | — | — | settings.json | 代理 |
| Cursor | — | — | ~/.cursor/mcp.json | 代理 |
| VS Code / Copilot | — | — | .vscode/mcp.json | 代理 |
| Claude Desktop | — | — | claude_desktop_config.json | 代理 |
开始使用
30 秒 完成安装
Node.js ≥ 20 或现成二进制。无账号、无网络请求，MIT 许可。
# global install npm install -g tokenguard tokenguard version tokenguard 0.3.4 # first look at the environment tokenguard scan
# isolated run docker run --rm \ -v ~/.tokenguard:/data \ -v ~/.dsh:/dsh \ tokenguard/tokenguard:latest scan DeepSeek Harness yes 12 15.9 MB
# prebuilt binary (Linux x64) curl -fsSL https://github.com/tokenguard/tokenguard/releases/latest/download/tokenguard-linux-x64.tar.gz | tar xz sudo mv tokenguard /usr/local/bin/ tokenguard version tokenguard 0.3.4
# from source git clone https://github.com/tokenguard/tokenguard.git cd tokenguard && npm install npm link tokenguard scan
FAQ
常见 问题
实际能省多少？
取决于您的 MCP 环境。运行多个 MCP 服务器的团队通常从懒加载代理获得最大收益：未使用的工具架构不再随每次请求传输。先运行 tokenguard scan — 它会在改动前报告架构 Token 与估算浪费。
在正在使用的工作区运行安全吗？
安全。一切默认 dry-run，改动需要 --apply，任何修改前都会写入备份，最近 2 分钟内改动过的会话会被跳过，没有显式标志时不会发起网络请求。
支持哪些开发工具？
DeepSeek Harness（完整：对话、重命名、用量）、Claude Code、OpenAI Codex CLI、Gemini CLI、Cursor、VS Code / Copilot 以及 Claude Desktop 的 MCP 配置。
是免费的吗？
是 — MIT，永久免费。计划推出 Pro（团队仪表板、SSO、托管 MCP 网关），CLI 本身将保持开源。
立即开始节省 Token
一条命令看清 自己的泄漏
运行 tokenguard scan — 在改动前就看清 Token 的去向。
免费且 MIT。Pro（团队仪表板、SSO、MCP 网关）已在路线图上 — CLI 保持开源。