toolism CLI
toolism измеряет, сколько токенов уходит на описания инструментов и MCP, и сокращает их без поломки допустимых вызовов.
- 54 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Читает схемы инструментов и при чтении с MCP-сервера запускает его на вашей машине.
- Меняет только файлы схем, которые вы укажете.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/toolismОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает схемы инструментов и при чтении с MCP-сервера запускает его на вашей машине.
- Меняет только файлы схем, которые вы укажете.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
toolism — CLI и библиотека на Python для схем инструментов, которые агент получает с каждым запросом: функции OpenAI, инструменты Anthropic и инструменты MCP-серверов. Генераторы схем вроде Pydantic, FastMCP и zod-to-json-schema добавляют то, что модель и так знает: повторяющиеся заголовки, обертки `anyOf`, `default: null`, адреса `$schema` и неиспользуемые `$defs`. toolism убирает только такой балласт. По замерам автора на 14 наборах и 159 инструментах 13 популярных MCP-серверов правила по умолчанию сокращают описания на 37,4% в сумме, медиана 11,3% на набор, а у Notion до 73%. Опция `--verify` проверяет, что измененная схема принимает те же вызовы. Команда `toolism check` работает как шлюз в CI, есть GitHub Action и хук pre-commit.
Для кого. Авторам MCP-серверов и агентов, которые платят за описания инструментов в каждом запросе и хотят сократить этот расход без поломки вызовов.
Подходит, если
- Нужно узнать, сколько токенов занимают инструменты вашего MCP-сервера.
- Схемы от Pydantic раздуты, и их стоит сжать с доказательством эквивалентности.
- В CI нужен шлюз, который не даст стоимости описаний расти.
- Требуется сравнить конфигурацию MCP в `~/.cursor/mcp.json` по расходу токенов.
Не подходит, если
- Схемы уже написаны вручную и компактны: выигрыш почти нулевой.
- Нужно сокращать системные подсказки, а не схемы инструментов.
- Допустимо менять набор допустимых вызовов инструмента ради размера.
Пример запроса к агенту
Измерь, сколько токенов занимают инструменты моего MCP-сервера, и покажи, какие правила сократят описания без поломки вызовов.Ограничения
Выигрыш зависит от генератора схем: у аккуратно написанных вручную схем он близок к нулю. Режим `--verify` требует дополнения `toolism[verify]` и проверяет принятие вызовов тестами, а не доказательством в каждом случае. Точный подсчет токенов Anthropic доступен в наборе `toolism[all]`. Чтобы читать инструменты прямо с MCP-сервера, нужно дополнение `toolism[mcp]`, а сервер при этом запускается на вашей машине.
Как отключить. Удалите пакет командой `pip uninstall toolism` или `pipx uninstall toolism`. Базовый файл `.toolism/baseline.json` и шаг GitHub Action в CI удалите из репозитория.
Частые вопросы
Как измерить расход?
Выполните `toolism measure tools.json` или прочитайте инструменты с сервера: `toolism measure --mcp "npx -y @modelcontextprotocol/server-github"`.
Как закрепить результат в CI?
Создайте базовый файл `toolism check tools.json -b .toolism/baseline.json --update-baseline`, затем запускайте `toolism check` с `--max-increase 5%`.
Не ломает ли сокращение вызовы?
По умолчанию действуют безопасные правила, а `--verify` проверяет схему в обе стороны и откатывает правила, у которых найден контрпример.
Как запустить без установки?
Командой `uvx toolism measure tools.json` или установкой через `pipx`.
Есть ли интеграция с GitHub?
Да, есть GitHub Action с входами и выходами и хук для pre-commit.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПрокси сжимает описания инструментов большого MCP-сервера, и модель тратит контекст только на нужные вызовы.
CLI на Python без зависимостей: один каталог MCP-серверов и скиллов для всех агентов, в контекст попадает краткий индекс
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
CLI-установщик восьми инструментов экономии токенов: правила, хуки, MCP и локальный прокси для Claude Code, Codex, Cursor.
Один MCP-шлюз вместо десятков серверов: агент ищет инструмент по запросу и не держит все схемы в контексте
Дает агенту вызывать инструменты MCP и UTCP через выполнение кода: поиск инструментов, готовый код и запуск цепочек вместо десятков отдельных вызовов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| toolism (эта карточка) | нет | 54 | ||
| Token Optimizer | нет | 2 964 | общая экономия токенов агента; toolism режет описания инструментов и схемы MCP с проверкой равенства вызовов | |
| schemagate — доступ к таблицам для text-to-sql | нет | не нужна | 136 | шлюз схем инструментов; toolism измеряет и сокращает схемы, а шлюз в CI держит расход под контролем |
Коротко о README
Сокращение трогает только то, что модель и так знает. Бенчмарк автора показывает результат по тринадцати популярным MCP-серверам, включая официальные.