CloudScope MCP

Спрашивайте свой ИИ о счетах за облачные услуги.

npm version Node.js TypeScript License: MIT

Установка

Claude Code	Cursor	VS Code
`claude mcp add cloudscope -- npx -y cloudscope-mcp`	Установить	Установить

Что это делает

CloudScope предоставляет ИИ-ассистентам доступ только для чтения к вашим данным о расходах в Azure. Спрашивайте о затратах, находите аномалии, получайте рекомендации по оптимизации и прогнозируйте счет за следующий месяц — и все это на естественном языке.

Поддерживаемые провайдеры

Провайдер	Статус
Azure	✅ Поддерживается
GCP	Скоро появится
AWS	Используйте официальный сервер AWS

Предварительные требования

Установленный и настроенный Azure CLI (az login)
Ваш ID подписки (az account show --query id -o tsv)
Роль Cost Management Reader (Читатель управления затратами) для подписки

Конфигурация

Добавьте в конфигурацию вашего MCP-клиента (claude_desktop_config.json, настройки Cursor и т.д.):

{
  "mcpServers": {
    "cloudscope": {
      "command": "npx",
      "args": ["-y", "cloudscope-mcp"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"
      }
    }
  }
}

Для локальной разработки не требуется субъект-служба (service principal). DefaultAzureCredential автоматически подхватывает вашу сессию az login.

Переменная	Описание
`AZURE_TENANT_ID`	ID арендатора Azure AD
`AZURE_CLIENT_ID`	ID клиента регистрации приложения
`AZURE_CLIENT_SECRET`	Секрет клиента регистрации приложения

Установите их вместе с AZURE_SUBSCRIPTION_ID в блоке env выше.

Инструменты

Инструмент	Описание	Ключевые параметры
`get_cost_summary`	Разбивка расходов по сервисам, группам или регионам	`start_date`, `end_date`, `group_by`
`detect_anomalies`	Поиск скачков расходов по сравнению с предыдущим периодом	`days`, `threshold`
`list_recommendations`	Рекомендации Azure Advisor по оптимизации затрат	`category`
`get_cost_forecast`	Прогноз расходов на основе текущих тенденций	`days`
`check_budgets`	Статус бюджета, текущие расходы, прогнозируемое превышение	(нет)
`compare_periods`	Сравнение расходов за два периода времени	`period_a_start/end`, `period_b_start/end`
`top_spending_resources`	Самые дорогие отдельные ресурсы	`days`, `limit`
`get_current_date`	Сегодняшняя дата и границы текущего/предыдущего месяца	(нет)

Примеры запросов

"Сколько стоил Azure в прошлом месяце?"
"Покажи расходы по группам ресурсов за последние 7 дней"
"Были ли аномалии в расходах на этой неделе?"
"Сколько будет стоить Azure в следующем месяце?"
"Покажи мне рекомендации по оптимизации затрат"
"У каких сервисов был самый большой рост расходов?"

Безопасность

CloudScope работает только в режиме чтения. Он не может создавать, изменять или удалять какие-либо ресурсы Azure. Все вызовы API используют права доступа Cost Management Reader без возможности записи.

Часто задаваемые вопросы

Изменяет ли это мои ресурсы Azure? Нет. Только доступ для чтения.

Нужен ли мне субъект-служба (service principal)? Нет. az login работает для локального использования.

Как насчет GCP? Скоро появится.

Платный ли API Azure Cost Management? Нет. Он бесплатный.

Разработка

git clone https://github.com/alexpota/cloudscope-mcp.git
cd cloudscope-mcp
npm install
npm run build
npm test
npx @modelcontextprotocol/inspector node dist/index.js

Лицензия

MIT

cloudscope-mcp