token-savior

token-savior

MibayyMIT
930 звёзд76 форков
Token Savior — MCP-сервер для AI-агентов, которые работают с кодом. Вместо чтения и отправки сырого текста файлов сервер передаёт структурированное представление кодовой базы: функции, классы, переменные, импорты. AI работает с кодом по именам символов, а не по строкам. В бенчмарке tsbench на 96 реальных задачах (Claude Opus 4.7) сервер показал 97,9% успешных прохождений. Расход токенов на задачу снизился с 17 221 до 3 395 (минус 80%), а время выполнения — с 110,6 до 18,9 секунд (минус 83%). Экономия построена на трёх механизмах: структурный доступ к символам кода, постоянная память между сессиями и компактизация вывода bash. В версии 4.3 добавили компакторы для pytest, git, gh CLI, grep, find и cat. Сервер разбирает цепочки && на сегменты и сжимает только последний значимый вывод.
Development
Открыть на GitHub

Установка

uvx token-savior

Характеристики

Общее

  • СтатусСообщество
  • РазработчикMibayy
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Структурная навигация по коду: AI обращается к функциям, классам и символам по именам. Контекст не засоряется лишними токенами.
  • Компактизация вывода pytest: сервер сжимает многострочный вывод. Работает с python3 -m pytest, uv run pytest, poetry/hatch/pdm/rye run pytest.
  • Компакторы для git и gh CLI: сжатие вывода git fetch, checkout, branch, worktree list, stash list, а также gh repo view, gh pr view, gh issue view, gh pr diff.
  • Компакторы для поисковых команд: grep, find, cat. Группировка совпадений по файлам, обрезка общего префикса пути, ограничение начала и конца. Экономия 83–96%.
  • Обработка составных команд: cd /root/foo && git status разбивается на сегменты. Компактизируется последний значимый. Безопасно пропускает сабшеллы, heredoc, пайпы и циклы.
  • Гибридный режим: комбинирует структурный доступ по символам с текстовым. AI сам выбирает оптимальный способ для задачи.
  • Постоянная память (persistent memory): контекст между сессиями сохраняется. AI не теряет информацию о проекте.
  • Инициализация через ts init: структурирует проект для максимальной эффективности компакторов и навигации.

Как подключить

Убедитесь, что установлен Python 3.11 или новее. Установите сервер:

uvx token-savior

Пропишите конфигурацию в клиенте MCP. Пример для Claude Desktop — файл claude_desktop_config.json:

{ "mcpServers": { "token-savior": { "command": "uvx", "args": ["token-savior"] } } }

Перезапустите MCP-клиент, чтобы применить изменения.

Примеры запросов

  • «Открой проект и найди функцию calculate_total в файле billing.py. Покажи её полный код с комментариями и сигнатурой.»
  • «Запусти тесты через uv run pytest -x --tb=short. Выведи только список упавших тестов с указанием файла и строки.»
  • «Проверь ветку feature/new-ui: какие коммиты не слиты в main. Покажи хеши и заголовки.»
  • «Найди все вхождения устаревшего метода deprecated_api_call. Сгруппируй по файлам и покажи первые три совпадения в каждом.»
  • «Построй диаграмму классов модуля services.py. Перечисли методы и родительские классы для каждого класса.»

Технические детали

  • Язык: Python 3.11+
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cline, Roo Code, Continue.dev и любые MCP-клиенты с stdio
  • Версия: 4.3.0 (май 2026)
  • Бенчмарки: 97,9% на tsbench, экономия 80% токенов, ускорение в 6 раз
  • Рейтинг: 930 звёзд на GitHub

Поделиться