mcp-azure

Ein Model Context Protocol-Server für Azure (über die Azure Resource Manager API – die programmatische Ebene hinter dem Azure Portal). Er ermöglicht einem MCP-fähigen Client (Claude Desktop, Claude Code, Cursor, Codex, …), Azure-Ressourcen zu inventarisieren und zu verwalten – mit einer Governance-Ebene, die einen KI-Agenten innerhalb sicherer Grenzen hält.

Funktionen

• Inventar – Abonnements, Standorte, Ressourcengruppen und Ressourcen auflisten; jede Ressource anhand der ARM id abrufen.

• Operationen – Ressourcengruppen in genehmigten Regionen erstellen, Tags auf jede Ressource zusammenführen und den Betriebszustand von VMs steuern (start / stop / restart / deallocate).

• Lebenszyklus – Ressourcengruppen und einzelne Ressourcen geschützt löschen.

• Integrierte Governance – Zugriffsmodi, Allowlisten für Abonnements/Ressourcengruppen, geschützte Ressourcengruppen, eine Standort-Allowlist für neue Gruppen, Lösch-Gating, typisierte Bestätigung für Löschungen mit großer Wirkung, Trockenlauf und JSON-Audit-Protokollierung.

Related MCP server: Azure MCP Server

Governance- und Sicherheitsmodell

Tools

Lesen (read-only+): list_subscriptions, list_locations, list_resource_groups, list_resources, get_resource

Schreiben (read-write+): create_resource_group, tag_resource, control_vm

Admin (admin): delete_resource_group, delete_resource (beide benötigen AZURE_ALLOW_DELETE + typisierte confirm)

Schnellstart — Einbindung in Ihren Agenten

Veröffentlicht auf npm als @dockndevai/mcp-azure. Eine Installation erfolgt per npx mit einem Entra ID-Dienstprinzipal. Kontaktieren Sie docs/CLIENTS.md für jeden Kunden und .env.example für alle Variablen.

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"
      }
    }
  }
}

Beispiel-Prompts

• „Liste alle Ressourcengruppen in meinem Abonnement auf und in welcher Region sie jeweils liegen"

• „Zeige jede Ressource in der Ressourcengruppe rg-web an"

• „Füge der Ressource app-plan die Tags env=prod und owner=team-a hinzu" (erfordert read-write)

• „Stoppe die VM build-agent in rg-ci" (erfordert read-write)

Aus dem Quellcode ausführen (Entwicklung)

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

Entwickeln

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

Veröffentlichen

Enthält eine server.json für das offizielle MCP-Registry und einen mcpName für die npm-Eigentümerprüfung. Siehe PUBLISHING.md.

Lizenz

MIT