Azure MCP Server logo

Azure MCP Server

by mashriram

An implementation of a Model Context Protocol server for interacting with Azure services. It currently supports Azure Blob Storage and Azure Cosmos DB (NoSQL API).

View on GitHub

Last updated: N/A

What is Azure MCP Server?

The Azure MCP Server is a server that implements the Model Context Protocol to enable interaction with Azure services like Blob Storage and Cosmos DB. It allows applications, such as the Claude desktop app, to perform operations on these Azure services through a standardized protocol, with all operations automatically logged for auditing.

How to use Azure MCP Server?

To use the server, you can either install it automatically via Smithery or manually by cloning the repository, configuring Azure credentials (either through environment variables or the Azure CLI), and configuring the Claude desktop app to point to the server. Once configured, you can use Claude to interact with Azure services using the available tools.

Key features of Azure MCP Server

  • Implements Model Context Protocol for Azure services

  • Supports Azure Blob Storage and Azure Cosmos DB (NoSQL API)

  • Automatic logging of all operations via the audit://azure-operations endpoint

  • Integration with Claude desktop app

  • Supports Azure App Configuration

Use cases of Azure MCP Server

  • Allowing AI models to read and write data to Azure Blob Storage

  • Enabling AI models to query and manipulate data in Azure Cosmos DB

  • Integrating AI models with Azure App Configuration for dynamic configuration

  • Providing a secure and auditable interface for AI models to interact with Azure services

FAQ from Azure MCP Server

What Azure services are supported?

Currently, the server supports Azure Blob Storage, Azure Cosmos DB (NoSQL API), and Azure App Configuration.

How do I configure Azure credentials?

You can configure credentials either by setting environment variables (AZURE_STORAGE_ACCOUNT_URL, AZURE_COSMOSDB_ENDPOINT, AZURE_COSMOSDB_KEY, AZURE_APP_CONFIGURATION_ENDPOINT) or by authenticating with the Azure CLI using az login.

What is the default database name for Cosmos DB operations?

If the database_name is not provided, the server defaults to a database named defaultdb.

How do I create a Cosmos DB container?

Use the cosmosdb_container_create tool, providing the container_name and partition_key. The partition_key should be a JSON object defining the partition key (e.g., {"paths": ["/myPartitionKey"], "kind": "Hash"}).

Why do I need a partition key for Cosmos DB operations?

Cosmos DB requires a partition key for efficient data storage and retrieval. When creating containers, you must define a partition key. When reading, replacing, or deleting items, you must provide the correct partition key value for the item you are accessing.

Azure MCP Server - MCP Server | MCP Directory