LLM Usage — MCP-сервер для Claude Code: учёт расходов на LLM API
Собирает стоимость вызовов LLM в локальную базу и отдаёт её кодинг-агенту через MCP. Пригодится, когда счёт за API приходит неожиданно.
claude mcp add llm-usage-mcp -- uvx llm-usage-mcpЧто делает LLM Usage
Сервер перехватывает вызовы к провайдерам через локальный прокси, считает токены и стоимость по каждому маршруту и складывает всё в SQLite-файл ~/.llm-usage/usage.db. Прокси слушает только 127.0.0.1:5525, ключи API остаются на его стороне, клиентам их передавать не нужно. Поддержаны Anthropic, OpenAI, DeepSeek и Qwen, потоковые и обычные запросы.
Кроме MCP есть CLI: llm-usage spend, llm-usage compare, llm-usage recommend. Одни и те же данные читаются и агентом, и из терминала. Это счётчик, а не роутер: он показывает, сколько потрачено и какой провайдер дешевле для конкретного запроса, но сами вызовы не меняет.
Перед запуском нужен хотя бы один ключ провайдера в переменной окружения — ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY или DASHSCOPE_API_KEY для Qwen. Прокси стартует и без ключа, но запросы к провайдеру без ключа вернут 503 configuration_error. Клиент направляется на прокси через ANTHROPIC_BASE_URL и аналогичные переменные.
Какие задачи решает
- узнать, сколько ушло на Anthropic и OpenAI за неделю
- сравнить стоимость одного запроса у разных провайдеров
- свести расходы по нескольким API в одну локальную базу
- проверить, что вызов агента записался в учёт
- посчитать цену запроса на 10k входящих и 2k исходящих токенов
Примеры запросов агенту
- Сколько я потратил на Claude за эту неделю?
- Какой провайдер дешевле для запроса на 10k входящих и 2k исходящих токенов?
- Покажи расходы по провайдерам за последние дни.
Как установить LLM Usage
Командой платформы
claude mcp add llm-usage-mcp -- uvx llm-usage-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from llm-usage-mcp <команда>
Командой платформы
codex mcp add llm-usage -- uvx llm-usage-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from llm-usage-mcp <команда>
Файл настроек
{
"mcpServers": {
"llm-usage": {
"command": "uvx",
"args": [
"llm-usage-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from llm-usage-mcp <команда>
Файл настроек
{
"servers": {
"llm-usage": {
"type": "stdio",
"command": "uvx",
"args": [
"llm-usage-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from llm-usage-mcp <команда>
Командой платформы
gemini mcp add llm-usage uvx llm-usage-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from llm-usage-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о LLM Usage
Как установить LLM Usage в Claude Code?
Добавьте MCP-сервер командой claude mcp add llm-usage-mcp -- uvx llm-usage-mcp или под именем llm-usage: claude mcp add llm-usage -- uvx llm-usage-mcp.
Что делает LLM Usage?
Записывает вызовы к LLM-провайдерам, считает токены и стоимость и отдаёт эти данные агенту через MCP или через CLI.
Что нужно для работы LLM Usage?
Ключ хотя бы одного провайдера в переменной окружения: ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY или DASHSCOPE_API_KEY. Без ключа прокси запустится, но запросы к этому провайдеру вернут 503 configuration_error.
