ИИтог

mcptoon сокращает расход токенов MCP-агентов почти на 98%

инструментыРедакция ИИтогHacker News🔥71Рейтинг ИИтог71Влияние60Новизна65Релевантность88Неожиданность60Участники25Достоверность78

mcptoon, независимый CLI-клиент для протокола MCP (Model Context Protocol), написанный на чистом Python без сторонних зависимостей и весящий 50 КБ. Он подключается к MCP-серверам по stdio или HTTP и вместо JSON выводит компактный формат TOON (Token-Optimized Object Notation). Работает с любым агентом, способным выполнять команды shell, автор называет среди примеров Claude Code, Codex, OpenCode и Cursor.

Автор описывает проблему так: обнаружение инструментов (tool discovery) в MCP обычно стоит 10 000+ токенов. По заявлению документации проекта, с mcptoon эта же операция обходится в 350 токенов. В иллюстративном примере из README: агент, подключённый к 5 MCP-серверам и вызывающий 20 инструментов, тратит на служебный JSON 40 000, 70 000 токенов ещё до начала содержательной работы, это 30, 55% от окна контекста в 128К токенов. На конкретном примере из двух инструментов JSON-описание занимает 287 токенов, TOON-версия того же списка, 5.

В тексте проекта заявлена экономия «98% для обнаружения инструментов, 60% для полной схемы, без потери информации». При этом в заголовке самого поста на Hacker News фигурирует другая цифра, 97% для того же обнаружения инструментов; источник это расхождение не поясняет.

Установка, через pip install mcptoon. CLI поддерживает команды init, add, manifest, call; конфигурация MCP-серверов задаётся один раз в ~/.mcptoon/config.json и общая для всех агентов на машине. Переменная окружения MCPTOON_AGENT_TYPE=claude включает автоматический вывод в TOON. Опасные операции, delete, drop, purge, wipe, kill и подобные, блокируются по умолчанию и требуют явного флага --destructive.

Проект опубликован под лицензией Apache 2.0. Документация заявляет отсутствие телеметрии и хранения учётных данных: ключи API берутся из конфигурации или переменных окружения пользователя. Тестовый набор, 98 тестов, проходят за 0,09 секунды; вся кодовая база, около 1700 строк. Автор отдельно указывает, что mcptoon не аффилирован с Anthropic. Имя разработчика в тексте не названо, указан только псевдоним аккаунта на GitHub, activeing123, и адрес для сообщений об уязвимостях.

Ключевые факты

  • Обнаружение инструментов MCP обычно стоит 10 000+ токенов; по заявлению проекта, с mcptoon, 350 токенов
  • Формат TOON вместо JSON: на примере из двух инструментов, 287 токенов против 5
  • Автор заявляет экономию 98% для обнаружения инструментов и 60% для полной схемы; в заголовке поста при этом фигурирует 97%, источник расхождение не объясняет
  • CLI без зависимостей (чистый Python, 50 КБ), совместим с Claude Code, Codex, OpenCode, Cursor и другими агентами, умеющими выполнять shell-команды
  • Открытый код (Apache 2.0), без телеметрии и хранения учётных данных; автор анонимен, указан только псевдоним аккаунта GitHub activeing123

Почему это важно

Каждый MCP-сервер, к которому подключается агент, добавляет в контекст описания своих инструментов в формате JSON, по оценке автора, это может съедать 30, 55% окна контекста в 128К токенов ещё до начала содержательной работы модели. mcptoon предлагает решение узкое, но конкретное: заменить многословный JSON компактной текстовой записью TOON, оставив агенту больше места под фактическое рассуждение вместо служебного синтаксиса.

Кому это важно

Разработчикам, которые строят или используют ИИ-агентов поверх нескольких MCP-серверов одновременно, в первую очередь пользователям Claude Code, Codex, OpenCode и Cursor, где расход контекста на служебные вызовы напрямую ограничивает длину полезного диалога или рабочей сессии.

Как это применить

Инструмент устанавливается командой pip install mcptoon и не требует сторонних зависимостей. MCP-серверы настраиваются один раз в общем конфиге ~/.mcptoon/config.json и становятся доступны сразу всем агентам на машине через команды manifest и call. Переменная окружения MCPTOON_AGENT_TYPE=claude включает автоматический вывод в TOON. Потенциально опасные операции (удаление, очистка и подобные) по умолчанию заблокированы и требуют явного флага --destructive. Проект бесплатный и с открытым кодом (Apache 2.0).

Можно ли доверять

В пользу доверия, открытый исходный код, отсутствие сторонних зависимостей, заявленное отсутствие телеметрии и хранения учётных данных, а также рабочий тестовый набор из 98 тестов. Против, все цифры экономии токенов взяты из документации самого проекта, независимой проверки или методологии измерений источник не приводит; в нём же заголовок поста (97%) расходится с текстом README (98%) для одной и той же метрики без объяснения. Автор проекта в тексте не назван по имени, только псевдоним аккаунта GitHub activeing123.

Риски и подводные камни

Проект только что опубликован (Show HN, история проекта в источнике не описана), реальных независимых замеров эффективности нет, только собственные примеры автора. Добавление ещё одного слоя в цепочку вызовов инструментов агента, это дополнительная зависимость, которую нужно понимать и доверять её автору, тем более анонимному. Защита от опасных операций (--destructive) снижает риск случайного разрушительного вызова, но не отменяет необходимости внимательно читать, что именно делает каждый MCP-сервер, подключённый через mcptoon.

«Экономия 98% для обнаружения инструментов, 60% для полной схемы, без потери информации.»

— документация проекта mcptoon