Token Guardian MCP

Token Guardian — это локальный MCP-сервер только для чтения, предназначенный для выявления неэффективного использования токенов в Claude Code и Codex, не снижая при этом их производительность.

Он выполняет две задачи:

• Сообщает, какие агенты, модели и сессии обрабатывают больше всего токенов.

• Рекомендует самую дешевую безопасную модель и уровень усилий для конкретной задачи.

Также включает команду route-task для пробного запуска, предназначенную для тестирования маршрутизации на основе промпта до регистрации MCP где-либо.

Жесткая граница безопасности

Token Guardian не может изменять настройки модели, уровни усилий, ограничения контекста, сжатие, регистрацию MCP или запущенные сессии. У него нет учетных данных модели, и он не совершает платных вызовов API.

Инструмент использования вызывает ccusage с флагами --offline и --no-cost. Заголовки Codex являются необязательными метаданными, читаемыми через sqlite3 -readonly. Каждый инструмент MCP помечен как доступный только для чтения, неразрушающий, идемпотентный и замкнутый.

Related MCP server: token-pilot

Инструменты

token_guardian_usage_snapshot

Считывает от одного до тридцати дней локального использования и возвращает:

• Итоги по агенту и модели

• Доли кэшированного чтения, вывода и frontier-моделей

• Крупнейшие сессии

• Точные дубликаты заголовков работ Codex

• Быстрые выигрыши, подтвержденные данными

Обработанные токены являются диагностикой рабочей нагрузки. Они не эквивалентны счетчику подписки, особенно когда доминирует кэшированный ввод.

token_guardian_recommend_route

Принимает клиент, задачу, риск и текущий размер контекста. Возвращает модель, уровень усилий, причины и опциональный frontier-валидатор.

Политика закрывается при ошибке. Работа, связанная с безопасностью, архитектурой, производством, разрушительными действиями, высоким риском, критическими задачами или неоднозначными ситуациями, остается на frontier-модели. Дешевые модели обрабатывают ограниченную механическую работу. Сбалансированные модели обрабатывают обычное кодирование и отладку, при необходимости с проверкой frontier.

Тестирование маршрутизации на основе промпта

Соберите проект, затем запустите маршрутизатор из любой папки:

node ./dist/route-cli.js --client codex --prompt "Implement a bounded TypeScript parser with tests." --cwd .

Рабочая папка не обязательно должна быть репозиторием. Маршрутизатор в первую очередь использует промпт. Он проверяет до 256 имен в текущей папке на наличие необязательных маркеров проекта, не открывая содержимое файлов и не сканируя подпапки.

Команда только выводит рекомендацию и команду запуска в рамках сессии. Она не выполняет эту команду, не изменяет конфигурацию, не регистрирует MCP и не взаимодействует с активной сессией. Расплывчатые продолжения промптов, такие как yeah, test that, остаются на frontier-маршруте, поскольку их реальный контекст отсутствует.

Локальные требования

• Node.js 24 или новее

• ccusage в PATH

• sqlite3 в PATH для необязательных заголовков потоков Codex

Сборка и тестирование

npm install
npm test
npm run typecheck
npm run build

Запустите собранный stdio-сервер:

node dist/index.js

Проверьте его без регистрации в живом клиенте:

npx @modelcontextprotocol/inspector node dist/index.js

Статус регистрации

Эта первая сборка намеренно не зарегистрирована в Claude, Codex или общем шлюзе Kitsune. Регистрация и любой перезапуск клиента являются отдельным изменением после принятия изолированного сервера.

Лицензия

MIT. См. LICENSE.