Azure Infrastructure MCP Server

A Model Context Protocol (MCP) server for managing Azure infrastructure directly from AI assistants like Claude in Cursor, VS Code, Claude Desktop, or any MCP-compatible client.

What You Can Do

• Manage Subscriptions — List and switch between Azure subscriptions
• Inspect Accounts — View subscription details, get access tokens, clear cached credentials
• Organize Resources — List and manage resource groups, tags, locks
• Control VMs — Start, stop, restart, deallocate virtual machines and scale VMSS
• Manage Storage — List and inspect storage accounts
• App Configuration — Manage App Configuration stores and key-values
• App Service — List and manage App Service plans and web apps
• Deploy Web Apps — Create and manage Web Apps for Containers with Docker/Podman
• Container Registry — List, create, and manage ACR instances, images, tasks, and network rules
• Virtual Networks — Create and manage VNets, subnets, and peerings
• Identity & Access — Manage Azure AD users, groups, applications, and RBAC permissions
• Governance — Work with management groups, resource locks, and tags
• Audit — View activity logs and track changes
• Docker Runtime — List, inspect logs, and restart local Docker containers
• Monitoring — System metrics, service health, and infrastructure status

Quick Start

1. Prerequisites

• Python 3.10+
• Azure CLI installed and logged in (az login)
• uv package manager

2. Install

git clone <repo-url> azops-mcp
cd azops-mcp
./quickstart.sh

The script will:

• Create a virtual environment with Python 3.12
• Install all dependencies (including Azure SDKs)
• Show configuration for Claude Desktop and Cursor

3. Configure Your AI Client

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "azops-mcp": {
      "command": "uv",
      "args": ["--directory", "/full/path/to/azops-mcp", "run", "python", "-m", "azops_mcp"]
    }
  }
}

Cursor — add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "azops-mcp": {
      "command": "uv",
      "args": ["--directory", "/full/path/to/azops-mcp", "run", "python", "-m", "azops_mcp"]
    }
  }
}

Restart your AI client after saving the configuration.

4. Start Using

User: List my Azure subscriptions
User: Show resource groups in subscription xxx-xxx-xxx
User: Start the VM "web-server" in resource group "production"
User: What VMs are running in my dev resource group?

Authentication

See the Authentication docs for the full walkthrough.

Available Tools (90+)

Docker

Run the MCP server as a container:

# Build the image
docker compose build

# Run the MCP server interactively (stdio transport)
docker compose run --rm mcp-server

See the Docker docs for full instructions.

Project Structure

azops-mcp/
├── src/azops_mcp/
│   ├── __main__.py               # Module entry point
│   ├── server.py                 # MCP server — 93 tool definitions
│   ├── config.py                 # Configuration management
│   ├── tools/                    # Azure SDK integrations (by category)
│   │   ├── _clients.py           # Shared auth & Azure SDK client factories
│   │   ├── subscription.py       # Subscriptions, auth, tenants, locations
│   │   ├── resource_groups.py    # Resource groups, tags, locks, activity log
│   │   ├── compute.py            # VMs, VMSS, resource listing
│   │   ├── networking.py         # VNets, subnets, peerings
│   │   ├── authorization.py      # RBAC roles & assignments
│   │   ├── management_groups.py  # Management group hierarchy
│   │   ├── app_configuration.py  # App Configuration stores & key-values
│   │   ├── app_service.py        # App Service plans & web apps
│   │   ├── container_registry.py # Azure Container Registry (ACR)
│   │   ├── active_directory.py   # Azure AD / Entra ID
│   │   ├── webapp_deployment.py  # Web App for Containers deployment
│   │   ├── docker.py             # Local Docker container runtime
│   │   └── monitoring.py         # System metrics & health
│   └── utils/
│       └── helpers.py            # HTTP client, error formatting
├── tests/                        # Unit tests (per integration)
│   ├── test_subscription.py
│   ├── test_resource_groups.py
│   ├── test_compute.py
│   ├── test_networking.py
│   ├── test_authorization.py
│   ├── test_container_registry.py
│   ├── test_active_directory.py
│   ├── test_webapp_deployment.py
│   ├── test_docker.py
│   ├── test_monitoring.py
│   ├── test_health.py
│   └── test_config.py
├── docs/                          # GitHub Pages documentation
├── Dockerfile                     # MCP server container image
├── docker-compose.yml             # Docker Compose for the MCP server
├── pyproject.toml                 # Dependencies & metadata
├── quickstart.sh                  # Setup script
└── .env.example                   # Configuration template

Configuration

See .env.example for the complete list.

Development

# Install with dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Code quality
black src/ tests/
ruff check src/ tests/
mypy src/

# Run server manually
uv run python -m azops_mcp

Documentation

Full documentation is available at artemkozlenkov.github.io/azops-mcp.

• Getting Started
• Architecture
• Tools Reference
• Authentication
• Configuration
• Docker

License

MIT