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:

2. Install dependencies:

3. Configure Claude Desktop:

   • Open claude_desktop_config.json

   • Add the following MCP configuration:

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

Development

Project Structure

Key Components

• AzureMCPServer: Main server class implementing the MCP protocol

• HandleCallTool: Processes incoming tool requests

• ExecuteWithRetry: Implements retry logic for resilient operations

Troubleshooting

1. Authentication Issues:

   • Ensure you're logged in via Azure CLI (az login)

   • Check environment variables if using service principal

   • Verify your Azure account has necessary permissions

2. Connection Issues:

   • Verify Claude Desktop configuration

   • Check paths in config file match your installation

   • Ensure no other instances are running

3. Common Errors:

   • NO_TENANT: Select a tenant using the 'select-tenant' tool

   • NO_CLIENTS: Ensure proper initialization and authentication

   • CODE_EXECUTION_FAILED: Check Azure permissions and connection

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contributors

• @calclavia - Integration with smithery.ai

Acknowledgments

• Claude Desktop team for the MCP implementation

• Azure SDK team for the comprehensive SDK

• Model Context Protocol for enabling AI-service integration

Security Note

This implementation follows Azure security best practices:

• No hardcoded credentials

• Secure credential chain implementation

• Proper error handling and sanitization

For security concerns or vulnerabilities, please create an issue.