Lazy MCP Proxy
Затраты на MCP-схемы падают до 90 %. Клиент видит 2 инструмента вместо 50+, upstream стартует при первом call_tool и засыпает после простоя.
Экономьте до 60 % бюджета токенов
Контекст под контролем
Команды тратят около 40 % бюджета токенов на шум: неиспользуемые 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
Lazy MCP Proxy
Затраты на MCP-схемы до −90 %
Детектор дрейфа
Где делить чат и сколько вернуть
Компакция чата
500 сообщений → конспект + 8
Бюджеты и профайлер
Лимиты и CI-гейт по перерасходу
Быстро · Безопасно · Локально · Открыто
За что его ставят
Каждая функция закрывает конкретную утечку
По умолчанию dry-run. Ничего не меняется без --apply, и перед изменением пишется бэкап.
Детектор дрейфа темы
Показывает конкретное сообщение, где разговор ушёл в сторону, и оценивает токены, которые вернёт новый чат. Полностью офлайн, без LLM.
Компакция чата
500+ сообщений сжимаются в структурированный конспект — запросы, файлы, команды, ключевые темы — а последние 8 остаются дословно. Чистый контекст в новом чате.
Профайлер и бюджеты
Расход по дням, сессиям, инструментам и моделям. Ставьте дневной лимит — CI падает при перерасходе. Оценка в USD через pricing.json.
Гигиена проектов
Находит мёртвые и незавершённые репозитории по git-метрикам и архивирует их: git bundle + tar + опись. Восстановление — один git clone.
Проверка документации
Битые ссылки, конфликтующие версии и порты, дубли абзацев, устаревшее «актуально на». Устаревшие документы перестают жечь контекст.
Совместимость
Работает с тем, что у вас уже стоит
Чаты, переименование, MCP-конфиги и ленивые прокси для всех основных харнессов.
| Харнесс | Чаты | Rename | MCP конфиг | Lazy |
|---|---|---|---|---|
| DeepSeek Harness | Полная | Штатное | YAML профили | Proxy + --apply |
| Claude Code | Чтение | — | ~/.claude.json | Proxy |
| OpenAI Codex CLI | Best effort | — | config.toml | Proxy |
| Gemini CLI | — | — | settings.json | Proxy |
| Cursor | — | — | ~/.cursor/mcp.json | Proxy |
| VS Code / Copilot | — | — | .vscode/mcp.json | Proxy |
| Claude Desktop | — | — | claude_desktop_config.json | Proxy |
С чего начать
Установка за 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 — он покажет токены схем и оценку потерь ещё до изменений.
Безопасно ли запускать на рабочем окружении?
Да. По умолчанию всё работает в режиме dry-run, изменения требуют --apply, перед любой правкой пишется бэкап, сессии, изменённые меньше 2 минут назад, пропускаются, а сетевые вызовы без явного флага не выполняются.
Какие харнессы поддерживаются?
DeepSeek Harness (полностью: чаты, переименование, usage), Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, VS Code / Copilot и Claude Desktop — для MCP-конфигов.
Это бесплатно?
Да — MIT, бесплатно навсегда. Планируется Pro с командными дашбордами, SSO и управляемым MCP-гейтвеем; сам CLI останется открытым.
Начните экономить токены
Посмотрите свои утечки одной командой
Запустите tokenguard scan — он покажет, куда уходят токены, ещё до изменений.
Бесплатно, лицензия MIT. Pro (командные дашборды, SSO, MCP-гейтвей) в планах — CLI останется открытым.