Azure MCP Server

An implementation of a Model Context Protocol server for interacting with Azure services. Currently supports Azure Blob Storage and Azure Cosmos DB (NoSQL API). All operations performed through this server are automatically logged and accessible via the audit://azure-operations resource endpoint.

Running Locally with the Claude Desktop App

Installing via Smithery

To install Azure MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mashriram/azure_mcp_server --client claude

Manual Installation

1. Clone the Repository: Clone this repository to your local machine.

2. Configure Azure Credentials: Configure your Azure credentials. This server requires an Azure account with appropriate permissions for Blob Storage, Cosmos DB and App Configuration. We recommend using DefaultAzureCredential which attempts to authenticate via various methods in order.

   • Environment Variables: Set the following environment variables:
     • AZURE_STORAGE_ACCOUNT_URL: The URL of your Azure Storage account (e.g., https://.blob.core.windows.net).
     • AZURE_COSMOSDB_ENDPOINT: The endpoint URL for your Azure Cosmos DB account.
     • AZURE_COSMOSDB_KEY: The primary or secondary key for your Azure Cosmos DB account. Important: Treat this key like a password and keep it secure.
     • AZURE_APP_CONFIGURATION_ENDPOINT: The URL of your Azure App Configuration instance.
   • Azure CLI: Alternatively, you can authenticate using the Azure CLI. Ensure you are logged in with an account that has the necessary permissions. This server uses DefaultAzureCredential so it will automatically authenticate with the Azure CLI credentials if environment variables are not specified. Use az login to log in.

3. Configure Claude Desktop: Add the following configuration to your claude_desktop_config.json file:

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

   "mcpServers": {
     "mcp-server-azure": {
       "command": "uv",
       "args": [
         "--directory",
         "/path/to/repo/azure-mcp-server",
         "run",
         "azure-mcp-server"
       ]
     }
   }
   

   Replace /path/to/repo/azure-mcp-server with the actual path to the cloned repository.