MCP для биллинга Yandex Cloud

yandex-cloud-mcp-billing

MCP-сервер расходов Yandex Cloud: разбор трат по сервисам, каталогам и меткам ресурсов с конвертацией в любую валюту

  • 1 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Запускает локальный Python-сервер, который по IAM-токену читает отчеты Billing Usage API
  • Курсы валют берет у ЦБ РФ, бюджеты и настройки не меняет
Все причины и проверки
Российский стек

aerdragon/yandex-cloud-mcp-billing

Установка

Сервисы

Ручная установка

uv venv && source .venv/bin/activate && uv pip install -e . && YC_IAM_TOKEN="$(yc iam create-token)" yc-billing-mcp

Локальная установка, по умолчанию поднимает Streamable HTTP на localhost:8000/mcp.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает локальный Python-сервер, который по IAM-токену читает отчеты Billing Usage API
  • Курсы валют берет у ЦБ РФ, бюджеты и настройки не меняет

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает Billing Usage API Yandex Cloud и отвечает только на вопросы о расходах: сколько потрачено на сервис, каталог или облако за период, как распределены траты по меткам ресурсов вроде project или team, и какие конкретные ресурсы дали основной расход. Есть отдельный поток для меток: сначала список ключей меток с оценкой кардинальности, затем группировка по одному ключу, затем детализация по конкретным значениям. У каждого ответа есть блок в выбранной валюте: курсы берутся из ЦБ РФ, валюту можно переключить инструментом на сессию. Баланса, бюджетов и прайс-листа сервер не показывает, только фактическое потребление.

Для кого. Для инженеров и фаундеров, которые хотят разбирать счет за Yandex Cloud по проектам и командам без выгрузок в таблицы.

Подходит, если

  • Нужно узнать, сколько потратили на конкретный сервис или каталог за месяц
  • Нужен chargeback по меткам ресурсов между проектами или командами
  • Нужно увидеть расход в другой валюте, например в евро или долларах

Не подходит, если

  • Нужен баланс аккаунта, бюджеты или прайс-лист: сервер их не отдает
  • Нет роли billing.accounts.getReport на нужном billing-аккаунте

Пример запроса к агенту

Покажи расход по проектам за прошлый месяц в евро и назови, какой проект вырос сильнее всего

MCP

Транспорт
stdio, http, sse
Авторизация
ключ необязателен

Переменные окружения

YC_IAM_TOKEN секрет
Готовый IAM-токен, не обновляется автоматически
YC_SA_KEY_FILE секрет
Путь к JSON-ключу сервисного аккаунта
YC_BILLING_ACCOUNT_ID
Billing-аккаунт по умолчанию для всех инструментов
YC_DISPLAY_CURRENCY
Валюта отображения по умолчанию, USD, если не задано

Ограничения

Нужна роль billing.accounts.getReport на billing-аккаунте. Данные о потреблении обновляются с задержкой, характерной для Billing Usage API. ConsumptionCore API ограничен одним запросом в минуту с IP, поэтому сервер кэширует ответы. Отчеты без ограничения по меткам или ресурсам API отклоняет, нужен явный фильтр или область.

Как отключить. Удалите блок yc-billing из конфигурации MCP клиента или остановите процесс сервера.

Частые вопросы

Можно ли посмотреть баланс аккаунта?

Нет, сервер намеренно ограничен отчетами по потреблению, баланс и бюджеты не отдает.

Как переключить валюту в ответах?

Инструментом set_display_currency один раз за сессию, дальше все ответы дополнительно показывают суммы в этой валюте по курсу ЦБ.

Чем MCP для биллинга Yandex Cloud отличается от консоли Yandex Cloud?

Сервер оборачивает Billing Usage API и отвечает только на вопросы о расходах: сколько потрачено на сервис, каталог или облако за период, как распределены траты по меткам ресурсов. Суммы можно конвертировать в любую валюту.

Можно ли посмотреть баланс аккаунта и как переключить валюту?

Баланс не показывается: сервер отвечает только о расходах. Валюта выбирается в параметрах вызова или настройке сервера, см. README. Доступ идет через ключ сервисного аккаунта. Работает в Claude Code, Claude Desktop и Cursor.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы Yandex Cloud

Yandex Cloud MCP Servers

Официальный

Официальный набор MCP-серверов Yandex Cloud: документация, поиск, развертывание приложений, serverless-функции, контейнеры и каталог данных

MCP-серверШирокий доступ49Звезды репозитория
Российский стек

MCP-сервер для базовых операций в Yandex Cloud: виртуальные машины, бакеты Object Storage и serverless-функции из диалога с агентом

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

Неофициальный однофайловый MCP-сервер для Yandex Object Storage: список бакетов, содержимое и скачивание файлов через AWS SDK

MCP-серверРасширенный доступ1Звезды репозитория

MCP-серверы Yandex AI Studio

MCP Servers in Yandex AI Studio

Официальный

Официальные демо-шаблоны Яндекса: MCP-шлюзы поверх облачных функций для YandexART, графиков, PDF, arXiv, Kaggle и погоды

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

Неофициальный MCP-сервер Yandex Cloud только для чтения: виртуальные машины, сети, диски и уровни доступа вплоть до организации

MCP-серверРасширенный доступ2Звезды репозитория
Российский стек

MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm

MCP-серверШирокий доступ3Звезды репозитория

Коротко о README

README описывает каталог сервисов, семейство инструментов spend_* поверх ConsumptionCore API, поток открытия трат по меткам с защитой от неограниченных запросов и блок автоматической конвертации валют. Отдельно расписаны шесть способов авторизации от готового IAM-токена до Workload Identity Federation в Kubernetes, транспорты stdio, Streamable HTTP и SSE, а также запуск в Docker.

Бейдж для README

Сообщить о проблеме