agentburn — MCP-сервер для Claude Code: что делает и как установить
Локальный профилировщик расхода токенов и лимитов подписки. Показывает пиковые пятичасовые окна, стоимость длинного контекста и время до блокировки по вашим логам.
claude mcp add agentburn -- uvx agentburnЧто делает agentburn
Сервер разбирает локальные журналы сессий без передачи данных во внешнюю сеть. Он вычисляет, в какой именно скользящий пятичасовой отрезок исчерпался лимит, сравнивая худший интервал со стандартным показателем. Утилита выводит структуру затрат: распределение по моделям, вызовы субагентов, а также соотношение чтения кэша, записи и генерации ответов.
Для подписок инструмент находит потолок автоматически по сообщениям об отсечке в стенограммах или берёт метрики лимитов Codex. Отдельный режим оценивает влияние разросшейся истории на расход окна и рассчитывает выгоду от команды /clear на разных объёмах контекста.
Для запуска через uvx требуется Python 3.9 или новее. Без сохранённых локальных логов сессий утилите не из чего будет строить отчёты.
Какие задачи решает
- вычислить пиковый пятичасовой интервал перерасхода токенов
- оценить экономию лимитов от сброса контекста через
/clear - рассчитать примерное время до исчерпания сессионного окна
- разбить затраты токенов по проектам и вызовам навыков
Примеры запросов агенту
- Покажи через
agentburn limits, когда был пик потребления и сколько осталось до лимита - Проанализируй через
agentburn context, сколько токенов съедает разросшаяся история сессии - Запусти
agentburn, чтобы найти причины сгорания баланса за последние дни
Как установить agentburn
Командой платформы
claude mcp add agentburn -- uvx agentburnuvx запускает команду с именем пакета; если в README она другая — uvx --from agentburn <команда>
Командой платформы
codex mcp add agentburn -- uvx agentburnuvx запускает команду с именем пакета; если в README она другая — uvx --from agentburn <команда>
Файл настроек
{
"mcpServers": {
"agentburn": {
"command": "uvx",
"args": [
"agentburn"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agentburn <команда>
Файл настроек
{
"servers": {
"agentburn": {
"type": "stdio",
"command": "uvx",
"args": [
"agentburn"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agentburn <команда>
Командой платформы
gemini mcp add agentburn uvx agentburnuvx запускает команду с именем пакета; если в README она другая — uvx --from agentburn <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agentburn
Как установить agentburn в Claude Code?
Выполните команду claude mcp add agentburn -- uvx agentburn.
Что делает agentburn?
Он читает локальные стенограммы агента и профилирует трату ресурсов. Инструмент находит пиковые пятичасовые окна, оценивает перерасход длинного контекста и прогнозирует время до блокировки.
Отправляет ли инструмент логи на сторонние серверы?
Нет, утилита работает локально в режиме чтения и не требует создания учётной записи. Вся обработка журналов происходит прямо на вашем компьютере.
