Azure MCP (Model Context Protocol) for Claude Desktop

A Model Context Protocol (MCP) implementation that enables Claude Desktop to interact with Azure services. This integration allows Claude to query and manage Azure resources directly through natural language conversations.

Features

• Azure Resource Management: Interface with Azure Resource Management client
• Subscription Management: List and manage Azure subscriptions
• Tenant Management: List and select Azure tenants
• Automatic Authentication: Leverages DefaultAzureCredential for flexible authentication methods
• Error Handling: Robust error handling with retries for transient failures
• Clean Response Formatting: Properly formatted responses compatible with Claude Desktop

Prerequisites

• Node.js (v18 or higher)
• Claude Desktop Application
• Azure Account with appropriate permissions
• Azure CLI (optional, for CLI-based authentication)

Installation

Manual Installation

1. Clone the repository:

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp

2. Install dependencies:

npm install

3. Configure Claude Desktop:
   • Open claude_desktop_config.json
   • Add the following MCP configuration:

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "azure": {
      "command": "tsx",
      "args": [
        "C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
      ]
    }
  }
}

Authentication

The server supports multiple authentication methods through DefaultAzureCredential:

• Environment Variables
• Managed Identity
• Azure CLI
• Visual Studio Code
• Interactive Browser

The server will automatically try these methods in sequence until one succeeds.

Usage

1. Close Claude Desktop if it’s running (check Task Manager)
2. Start Claude Desktop
3. In the chat, you can now ask Azure-related questions like:
   • “Can you get all the available Azure accounts and subscriptions?”
   • “List all resource groups in my subscription”
   • “Show me all virtual machines in a specific resource group”

Example Conversation

You: Can you get all the available Azure accounts and subscriptions?
Claude: I'll help you list all available Azure tenants and subscriptions.
[Claude will then use the Azure MCP to fetch and display the information]

Development

Project Structure

azure-mcp/
├── src/
│   ├── launcher.ts       # Server entry point
│   ├── AzureServer.ts    # Main MCP server implementation
│   └── LoggerService.ts  # Logging utility
├── package.json
└── README.md

Key Components