mcp-azure

Un servidor de Model Context Protocol para Azure (a través de la API de Azure Resource Manager — la capa programática que hay detrás de Azure Portal). Permite que un cliente compatible con MCP (Claude Desktop, Claude Code, Cursor, Codex, …) inventaríe y opere recursos de Azure — con una capa de gobernanza que mantiene a un agente de IA dentro de límites seguros.

Qué ofrece

• Inventario — lista las suscripciones, ubicaciones, grupos de recursos y recursos; obtiene cualquier recurso por id de ARM.

• Operaciones — crea grupos de recursos (en regiones aprobadas), fusiona etiquetas en cualquier recurso y controla el estado de las máquinas virtuales (iniciar / detener / reiniciar / desasignar).

• Ciclo de vida — elimina grupos de recursos y recursos individuales, protegido.

• Gobernanza incorporada — modos de acceso, listas de permitidos de suscripciones y grupos de recursos, grupos de recursos protegidos, lista de ubicaciones permitidas para nuevos grupos, bloqueo de eliminaciones, confirmación tipada para eliminaciones de alto impacto, simulacro (dry-run) y registro de auditoría JSON.

Related MCP server: Azure MCP Server

Modelo de gobernanza y seguridad

Herramientas

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

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

Administración (admin): delete_resource_group, delete_resource (ambos necesitan AZURE_ALLOW_DELETE + confirmación tipada)

Inicio rápido — añádelo a tu agente

Publicado en npm como @dockndevai/mcp-azure. Se ejecuta con npx mediante una entidad de servicio de Entra ID. Consulta docs/CLIENTS.md para cada cliente y .env.example para todas las variables.

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

Ejemplos de indicaciones

• "Enumera todos los grupos de recursos de mi suscripción y en qué región está cada uno"

• "Muestra todos los recursos del grupo rg-web"

• "Etiqueta el recurso app-plan con env=prod y owner=team-a" (necesita write-read)

• "Detén la VM build-agent en rg-ci" (necesita write-read)

Ejecutar desde el código fuente (desarrollo)

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

Desarrollo

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

Publicación

Incluye un server.json para el registro oficial de MCP y un mcpName para la validación de la propiedad en npm. Consulta PUBLISHING.md.

Licencia

MIT