mcp-azure

Сервер Model Context Protocol для Azure (через Azure Resource Manager API — программный слой, лежащий в основе портала Azure). Он позволяет MCP-совместимому клиенту (Claude Desktop, Claude Code, Cursor, Codex, …) инвентаризировать ресурсы Azure и управлять ими — со слоем контроля, который удерживает ИИ-агента в безопасных границах.

Что это даёт

• Инвентаризация — список подписок, регионов, групп ресурсов и ресурсов; получение любого ресурса по ARM id.

• Операции — создание групп ресурсов (в разрешённых регионах), наложение тегов на любой ресурс и управление состоянием питания виртуальных машин (запуск / остановка / перезапуск / освобождение).

• Жизненный цикл — удаление групп ресурсов и отдельных ресурсов, защищённое управление.

• Встроенное управление — режимы доступа, списки разрешённых подписок и групп ресурсов, защищённые группы ресурсов, список разрешённых регионов для новых групп, ограничение удалений, требование ввода для рискованных удалений, dry-run и JSON-журнал аудита.

Related MCP server: Azure MCP Server

Модель управления и безопасности

Инструменты

Чтение (read-only+): list_subscriptions, list_locations, list_resource_groups, list_resources, get_resource

Запись (read-write+): create_resource_group, tag_resource, control_vm

Администрирование (admin): delete_resource_group, delete_resource (оба требуют AZURE_ALLOW_DELETE и ввода confirm)

Быстрый старт — подключение к вашему агенту

Опубликован на npm как @dockndevai/mcp-azure. Запускается через npx с субъектом‑службой Entra ID. По каждому клиенту см. docs/CLIENTS.md, а все переменные — в .env.example.

Claude Code

claude mcp add azure -e AZURE_TENANT_ID="…" -e AZURE_CLIENT_ID="…" -e AZURE_CLIENT_SECRET="…" -e AZURE_SUBSCRIPTION_ID="…" -e AZURE_MODE="read-only" -- npx -y @dockndevai/mcp-azure

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure"],
      "env": {
        "AZURE_TENANT_ID": "…",
        "AZURE_CLIENT_ID": "…",
        "AZURE_CLIENT_SECRET": "…",
        "AZURE_SUBSCRIPTION_ID": "…",
        "AZURE_MODE": "read-only"
      }
    }
  }
}

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

• «Покажи все группы ресурсов в моей подписке и в каких регионах они находятся»

• «Покажи все ресурсы в группе rg-web»

• «Добавь на ресурс app-plan теги env=prod и owner=team-a» (нужен read-write)

• «Останови виртуальную машину build-agent в rg-ci» (нужен read-write)

Запуск из исходного кода (разработка)

npm install
npm run build
node dist/index.js   # with the environment variables set

Разработка

npm run dev
npm test          # governance policy: modes, scoping, location allowlist, delete + confirmation
npm run typecheck

Публикация

В комплекте идёт файл server.json для официального реестра MCP и mcpName для проверки владельца пакета npm. См. PUBLISHING.md.

Лицензия

MIT