Azure Resource Manager MCP server

This server provides a Model Context Protocol (MCP) implementation focused on Azure resources management. It gives you tools, prompts, and resources to interact with your Azure infrastructure through language models that support the MCP specification.

Installation

Prerequisites

• Python 3.8 or higher
• An Azure account with appropriate permissions
• Azure CLI installed and authenticated

Installing from PyPI

pip install azure-mcp-server

Installing from Source

git clone https://github.com/username/azure-mcp-server.git
cd azure-mcp-server
pip install -e .

Configuration

Authentication Setup

Before using the MCP server, ensure you have authenticated with Azure:

az login

Server Configuration

Create a configuration file named config.yaml in your working directory:

azure:
  subscription_id: your-subscription-id
  resource_group: your-resource-group-name
  
server:
  port: 8080
  host: 0.0.0.0
  log_level: INFO

Running the Server

Start the MCP server with the following command:

mcp-azure-server --config config.yaml

Optional flags:

• --debug: Enable debug mode
• --port 8081: Override the port defined in config file
• --host 127.0.0.1: Override the host address

Using the MCP Server

Connecting to the Server

The server implements the Model Context Protocol, so any MCP-compatible client can connect to it. The server will be available at:

http://localhost:8080

Available Commands

List Azure Resources

{
  "type": "mcp.commands",
  "command": "azure.list_resources",
  "parameters": {
    "resource_type": "virtualmachine"
  }
}

Create a Resource

{
  "type": "mcp.commands",
  "command": "azure.create_resource",
  "parameters": {
    "resource_type": "storageaccount",
    "name": "mystorageaccount",
    "location": "eastus",
    "properties": {
      "sku": "Standard_LRS"
    }
  }
}

Get Resource Status

{
  "type": "mcp.commands",
  "command": "azure.get_status",
  "parameters": {
    "resource_id": "/subscriptions/{sub-id}/resourceGroups/{resource-group}/providers/Microsoft.Compute/virtualMachines/{vm-name}"
  }
}

Troubleshooting

Common Issues

• Authentication Errors: Make sure you've run az login and have the necessary permissions
• Resource Not Found: Verify the subscription ID and resource group in your configuration file
• Connection Issues: Check that the server is running and the port is accessible

Checking Logs

The server logs are available at:

./logs/mcp-server.log

Increase verbosity by setting log_level: DEBUG in your configuration file.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "azure-mcp-server" '{"command":"npx","args":["-y","azure-mcp-server"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "azure-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "azure-mcp-server"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "azure-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "azure-mcp-server"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect