LeanToken MCP
Локальный поиск по коду для агентов: находит нужные файлы и фрагменты и держит контекст в пределах заданного бюджета токенов
- 158 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Локальная база индекса хранит фрагменты исходников на диске
- Команда `setup` правит конфигурацию клиентов, перед записью смотрите показанный список путей
Установка
- Работает в
Ручная установка
npx leantoken setupОпределяет клиентов, показывает правки конфигурации и просит подтверждение.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Локальная база индекса хранит фрагменты исходников на диске
- Команда `setup` правит конфигурацию клиентов, перед записью смотрите показанный список путей
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
LeanToken индексирует исходный код на вашей машине в локальной базе и дает агенту ограниченные по объему ответы. Инструментов девять: `leantoken.context` для первого широкого обзора задачи, `leantoken.search` вместо grep, `leantoken.files` вместо find, `leantoken.outline` для сигнатур и импортов без чтения файла целиком, `leantoken.read` для одного символа или диапазона строк, `leantoken.history` для разницы между ревизиями Git, `leantoken.json` для запросов к JSON, `leantoken.receipt_rebase` и `leantoken.savings`. У каждого ответа есть явный предел токенов, поэтому большой файл не занимает весь запрос. Сервер на Rust работает только на чтение, правки, сборку и тесты остаются обычным инструментам агента. Установка делается командой `npx leantoken setup`, которая настраивает Claude Code, Cursor, OpenCode, Codex, Gemini CLI или Antigravity и ставит небольшой скилл подсказок. В контролируемом замере из 60 запусков расход входных токенов упал на 20,1 процента при ограниченном обзоре репозитория и на 37,6 процента при широком.
Для кого. Разработчикам больших репозиториев, которые гоняют агента по коду и хотят сократить расход токенов и шум в контексте.
Подходит, если
- Задача звучит широко, например про отмену запросов, и агент сначала получает материал через `leantoken.context`
- Нужны сигнатуры и импорты модуля без чтения файла на тысячи строк
- Нужно проследить, как менялся символ между ревизиями Git, не читая весь diff
- Счета за токены растут, и `npx leantoken savings` показывает, что реально сэкономлено
Не подходит, если
- Нужны правки кода или запуск тестов: сервер только читает репозиторий
- Репозиторий крошечный: встроенных поиска и чтения агента хватает с запасом
- Нужен облачный индекс без локальной базы: индекс строится и лежит на вашей машине
Пример запроса к агенту
Найди код, связанный с отменой запросов, покажи сигнатуры затронутых модулей и ограничь ответ тремя тысячами токеновMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Хост должен запускать сервер из рабочего каталога проекта: если он стартует из домашнего каталога или корня файловой системы, LeanToken по умолчанию откажется индексировать такой широкий корень. Ответ по умолчанию берет последнее завершенное поколение индекса и не дожидается изменений на диске, свежие правки требуют `consistency: "reconcile_working_tree"`. Результаты замера на 60 запусках описаны в методике, а экономия зависит от задачи и репозитория. Команда `setup` перед записью конфигурации просит отдельное подтверждение и закрепляет версию. Лицензия MIT или Apache 2.0, нужен Rust 1.95 только при сборке из исходников.
Как отключить. Удалите запись `leantoken` из конфигурации клиентов (`claude mcp remove leantoken`) и скилл подсказок, который добавил `setup`, при желании отмените закрепленную версию.
Частые вопросы
Как подключить LeanToken?
Командой `npx leantoken setup`: она найдет поддерживаемые клиенты, покажет пути конфигурации и попросит подтверждение. Для автоматизации укажите клиентов явно, например `--claude --codex --yes`.
Какие инструменты есть у сервера?
Девять: `context`, `search`, `files`, `outline`, `read`, `history`, `json`, `receipt_rebase` и `savings` с префиксом `leantoken.`. Каталог маленький намеренно, чтобы описания не съедали контекст.
Меняет ли LeanToken мои файлы?
Нет, это слой поиска и чтения. Правки, сборку и тесты ведут обычные инструменты агента.
Как проверить, что экономия есть?
Командой `npx leantoken savings`: она показывает учет токенов по репозиторию, подавление повторов и ограничения наблюдения. Методика замера лежит в `docs/measurement.md`.
Куда уходят мои исходники?
Никуда: индексация идет локально, а база лежит на вашей машине. Сетевой доступ нужен только для скачивания пакета.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная панель токенов, стоимости и вызовов инструментов для Claude Code, Codex, Gemini CLI и других агентов.
Локальный граф кода отвечает агентам на вопросы о символах и вызовах, и они реже перечитывают файлы целиком.
Граф знаний по коду проекта для агента: вызывающие, зависимости и радиус правки через MCP вместо чтения файлов
Локальный поиск по коду для Claude Code и Codex: шесть быстрых инструментов вместо grep и Read, индекс обновляется сам.
CLI строит индекс кодовой базы и карту на 250 токенов, чтобы агент не читал сотни файлов в поисках нужного.
Локальный MCP-сервер индексирует код проекта, и агент достает из индекса нужные функции вместо чтения целых файлов
Коротко о README
Заголовок с обещанием экономии токенов, замер на 60 запусках, быстрый старт `setup` и `doctor`, подробные заметки о безопасности установки, три основных свойства: локальность, явные бюджеты токенов, приспособленность к агентам. Дальше таблица инструментов, расширенные настройки и документация.