Overview
What is Azure MCP Server?
An implementation of the Model Context Protocol (MCP) server for interacting with Azure services, currently supporting Azure Blob Storage, Azure Cosmos DB (NoSQL API), and Azure App Configuration. All operations are automatically logged and accessible via the audit://azure-operations resource endpoint. It is designed for developers who want to manage Azure resources through AI assistants like Claude.
How to use Azure MCP Server?
Install via Smithery with npx -y @smithery/cli install @mashriram/azure_mcp_server --client claude, or manually by cloning the repository, configuring Azure credentials (via environment variables or Azure CLI), and adding the server configuration to Claude Desktop's claude_desktop_config.json. Then ask Claude to perform Azure operations using the provided tools.
Key features of Azure MCP Server
- Manage Azure Blob Storage containers and blobs (create, list, delete, upload, read)
- Manage Cosmos DB containers and items (create, read, replace, delete, query)
- Read, write, and delete key-values in Azure App Configuration
- Automatic audit logging of all operations via
audit://azure-operations - DefaultAzureCredential authentication supporting environment variables and Azure CLI
- Simple installation via Smithery or manual setup for Claude Desktop
Use cases of Azure MCP Server
- Create and manage Blob Storage containers and upload files via natural language
- Query, insert, update, and delete Cosmos DB items using SQL queries
- Manage application configuration key-values across environments
- Automate Azure resource management through conversational AI assistants
FAQ from Azure MCP Server
What Azure services does Azure MCP Server support?
It supports Azure Blob Storage, Azure Cosmos DB (NoSQL API), and Azure App Configuration.
How do I authenticate to Azure?
Use DefaultAzureCredential via environment variables (AZURE_STORAGE_ACCOUNT_URL, AZURE_COSMOSDB_ENDPOINT, AZURE_COSMOSDB_KEY, AZURE_APP_CONFIGURATION_ENDPOINT) or the Azure CLI with az login.
How are operations logged?
All operations performed through the server are automatically logged and accessible via the audit://azure-operations resource endpoint.
What is the default database for Cosmos DB?
If database_name is not provided in tool calls, the server defaults to a database named SampleDB. Ensure this database exists or explicitly provide the correct database name.
Do I need to handle partition keys for Cosmos DB?
Yes, partition keys are required and case-sensitive. You must define them when creating containers and provide the correct partition key value when reading, replacing, or deleting items.
