Azure MCP Server

# Azure MCP Server Extension for Visual Studio Code Easily bring the power of Model Context Protocol (MCP) to your Azure projects in VS Code. ## Table of Contents - [Overview](#overview) - [Getting Started](#getting-started) - [What can you do with the Azure MCP Server?](#what-can-you-do-with-the-azure-mcp-server) - [Complete List of Supported Azure Services](#complete-list-of-supported-azure-services) - [Documentation](#documentation) - [Feedback & Support](#feedback--support) - [Contributing](#contributing) - [License](#license) ## Overview **Azure MCP Server** adds smart, context-aware AI tools right inside VS Code to help you work more efficiently with Azure resources. The Azure MCP Server supercharges your agents with Azure context across **28 different Azure services**. ## Getting Started Follow these simple steps to start using Azure MCP in VS Code: 1. **Install the Extension** - Get it from the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server). 2. **Start (or Auto-Start) the MCP Server** > **VS Code (version 1.103 or above):** You can now configure MCP servers to start automatically using the `chat.mcp.autostart` setting, instead of manually restarting them after configuration changes. #### **Enable Autostart** 1. Open **Settings** in VS Code. 2. Search for `chat.mcp.autostart`. 3. Select **newAndOutdated** to automatically start MCP servers without manual refresh. 4. You can also set this from the **refresh icon tooltip** in the Chat view, which also shows which servers will auto-start.  #### **Manual Start (if autostart is off)** 1. Open Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`). 2. Run `MCP: List Servers`.  3. Select `Azure MCP Server ext`, then click **Start Server**.   4. **Check That It's Running** - Go to the **Output** tab in VS Code. - Look for log messages confirming the server started successfully.  3. (Optional) Configure tools and behavior - Full options: control how tools are exposed and whether mutations are allowed: ```json // Server Mode: collapse per service (default), single tool, or expose every tool "azureMcp.serverMode": "namespace", // one of: "single" | "namespace" (default) | "all" // Filter which namespaces to expose "azureMcp.enabledServices": ["storage", "keyvault"], // Run the server in read-only mode (prevents write operations) "azureMcp.readOnly": false ``` - Changes take effect after restarting the Azure MCP server from the MCP: List Servers view. (Step 2) You’re all set! Azure MCP Server is now ready to help you work smarter with Azure resources in VS Code. ## What can you do with the Azure MCP Server? Here are some cool prompts you can try across our supported Azure services: ### 🔎 Azure AI Search * "What indexes do I have in my Azure AI Search service 'mysvc'?" * "Let's search this index for 'my search query'" ### ⚙️ Azure App Configuration * "List my App Configuration stores" * "Show my key-value pairs in App Config" ### 📦 Azure Container Registry (ACR) * "List all my Azure Container Registries" * "Show me my container registries in the 'myproject' resource group" * "List all my Azure Container Registry repositories" ### ☸️ Azure Kubernetes Service (AKS) * "List my AKS clusters in my subscription" * "Show me all my Azure Kubernetes Service clusters" ### 📊 Azure Cosmos DB * "Show me all my Cosmos DB databases" * "List containers in my Cosmos DB database" ### 🧮 Azure Data Explorer * "Get Azure Data Explorer databases in cluster 'mycluster'" * "Sample 10 rows from table 'StormEvents' in Azure Data Explorer database 'db1'" ### ⚡ Azure Managed Lustre * "List the Azure Managed Lustre clusters in resource group 'my-resourcegroup'" * "How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?" ### 📊 Azure Monitor * "Query my Log Analytics workspace" ### 🔧 Azure Resource Management * "List my resource groups" * "List my Azure CDN endpoints" * "Help me build an Azure application using Node.js" ### 🗄️ Azure SQL Database * "Show me details about my Azure SQL database 'mydb'" * "List all databases in my Azure SQL server 'myserver'" * "List all firewall rules for my Azure SQL server 'myserver'" * "List all elastic pools in my Azure SQL server 'myserver'" * "List Active Directory administrators for my Azure SQL server 'myserver'" ### 💾 Azure Storage * "List my Azure storage accounts" * "Get details about my storage account 'mystorageaccount'" * "Create a new storage account in East US with Data Lake support" * "Show me the tables in my Storage account" * "Get details about my Storage container" * "Upload my file to the blob container" * "List paths in my Data Lake file system" * "List files and directories in my File Share" * "Send a message to my storage queue" ## 🛠️ Currently Supported Tools <details> <summary>The Azure MCP Server provides tools for interacting with the following Azure services</summary> ### 🔎 Azure AI Search (search engine/vector database) * List Azure AI Search services * List indexes and look at their schema and configuration * Query search indexes ### ⚙️ Azure App Configuration * List App Configuration stores * Manage key-value pairs * Handle labeled configurations * Lock/unlock configuration settings ### 🛡️ Azure Best Practices * Get secure, production-grade Azure SDK best practices for effective code generation. ### 🖥️ Azure CLI Extension * Execute Azure CLI commands directly * Support for all Azure CLI functionality ### 📦 Azure Container Registry (ACR) * List Azure Container Registries and repositories in a subscription * Filter container registries and repositories by resource group * JSON output formatting * Cross-platform compatibility ### 📊 Azure Cosmos DB (NoSQL Databases) * List Cosmos DB accounts * List and query databases * Manage containers and items * Execute SQL queries against containers ### 🧮 Azure Data Explorer * List Azure Data Explorer clusters * List databases * List tables * Get schema for a table * Sample rows from a table * Query using KQL ### 🐬 Azure Database for MySQL - Flexible Server * List and query databases. * List and get schema for tables. * List, get configuration and get parameters for servers. ### 🐘 Azure Database for PostgreSQL - Flexible Server * List and query databases. * List and get schema for tables. * List, get configuration and get/set parameters for servers. ### 🛠️ Azure Developer CLI (azd) Extension * Execute Azure Developer CLI commands directly * Support for template discovery, template initialization, provisioning and deployment * Cross-platform compatibility ### 🚀 Azure Deploy * Generate Azure service architecture diagrams from source code * Create a deploy plan for provisioning and deploying the application * Get the application service log for a specific azd environment * Get the bicep or terraform file generation rules for an application * Get the GitHub pipeline creation guideline for an application ### 🧮 Azure Foundry * List Azure Foundry models * Deploy foundry models * List foundry model deployments * List knowledge indexes ### ☁️ Azure Function App * List Azure Function Apps * Get details for a specific Function App ### 🔑 Azure Key Vault * List, create, and import certificates * List and create keys * List and create secrets ### ☸️ Azure Kubernetes Service (AKS) * List Azure Kubernetes Service clusters ### 📦 Azure Load Testing * List, create load test resources * List, create load tests * Get, list, (create) run and rerun, update load test runs ### 🚀 Azure Managed Grafana * List Azure Managed Grafana ### ⚡ Azure Managed Lustre * List Azure Managed Lustre filesystems * Get the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem ### 🏪 Azure Marketplace * Get details about Marketplace products ### 📈 Azure Monitor #### Log Analytics * List Log Analytics workspaces * Query logs using KQL * List available tables #### Health Models * Get health of an entity #### Metrics * Query Azure Monitor metrics for resources with time series data * List available metric definitions for resources ### 🏥 Azure Service Health * Get the availability status for a specific resource * List availability statuses for all resources in a subscription or resource group ### ⚙️ Azure Native ISV Services * List Monitored Resources in a Datadog Monitor ### 🛡️ Azure Quick Review CLI Extension * Scan Azure resources for compliance related recommendations ### 📊 Azure Quota * List available regions * Check quota usage ### 🔴 Azure Redis Cache * List Redis Cluster resources * List databases in Redis Clusters * List Redis Cache resources * List access policies for Redis Caches ### 🏗️ Azure Resource Groups * List resource groups ### 🎭 Azure Role-Based Access Control (RBAC) * List role assignments ### 🚌 Azure Service Bus * Examine properties and runtime information about queues, topics, and subscriptions ### 🗄️ Azure SQL Database * Show database details and properties * List the details and properties of all databases * List SQL server firewall rules ### 🗄️ Azure SQL Elastic Pool * List elastic pools in SQL servers ### 🗄️ Azure SQL Server * List Microsoft Entra ID administrators for SQL servers ### 💾 Azure Storage * List and create Storage accounts * Get detailed information about specific Storage accounts * Manage blob containers and blobs * Upload files to blob containers * List and query Storage tables * List paths in Data Lake file systems * Get container properties and metadata * List files and directories in File Shares ### 📋 Azure Subscription * List Azure subscriptions ### 🏗️ Azure Terraform Best Practices * Get secure, production-grade Azure Terraform best practices for effective code generation and command execution ### 🖥️ Azure Virtual Desktop * List Azure Virtual Desktop host pools * List session hosts in host pools * List user sessions on a session host ### 📊 Azure Workbooks * List workbooks in resource groups * Create new workbooks with custom visualizations * Update existing workbook configurations * Get workbook details and metadata * Delete workbooks when no longer needed ### 🏗️ Bicep * Get the Bicep schema for specific Azure resource types ### 🏗️ Cloud Architect * Design Azure cloud architectures through guided questions </details> For the complete list of supported services and sample prompts, see our [full documentation](https://github.com/Azure/azure-mcp/blob/main/README.md#-what-can-you-do-with-the-azure-mcp-server). ## Complete List of Supported Azure Services The Azure MCP Server provides tools for interacting with **28 Azure service areas**: - 🔎 **Azure AI Search** - Search engine/vector database operations - ⚙️ **Azure App Configuration** - Configuration management - 🛡️ **Azure Best Practices** - Secure, production-grade guidance - 🖥️ **Azure CLI Extension** - Direct Azure CLI command execution - 📦 **Azure Container Registry (ACR)** - Container registry management - 📊 **Azure Cosmos DB** - NoSQL database operations - 🧮 **Azure Data Explorer** - Analytics queries and KQL - 🐘 **Azure Database for PostgreSQL** - PostgreSQL database management - 🐬 **Azure Database for MySQL** - MySQL database management - 🛠️ **Azure Developer CLI (azd)** - Template and deployment management - ⚡ **Azure Functions** - Function App management - 🧮 **Azure Foundry** - AI model management, AI model deployment, and knowledge index management - 🚀 **Azure Managed Grafana** - Monitoring dashboards - 🗃️ **Azure Managed Lustre** - High-performance Lustre filesystem operations - 🔑 **Azure Key Vault** - Secrets, keys, and certificates - ☸️ **Azure Kubernetes Service (AKS)** - Container orchestration - 📦 **Azure Load Testing** - Performance testing - 🏪 **Azure Marketplace** - Product discovery - 📈 **Azure Monitor** - Logging, metrics, and health monitoring - 🏥 **Azure Service Health** - Resource health status and availability - ⚙️ **Azure Native ISV Services** - Third-party integrations - 🛡️ **Azure Quick Review CLI** - Compliance scanning - 🔴 **Azure Redis Cache** - In-memory data store - 🏗️ **Azure Resource Groups** - Resource organization - 🎭 **Azure RBAC** - Access control management - 🚌 **Azure Service Bus** - Message queuing - 🗄️ **Azure SQL Database** - Relational database management - 🗄️ **Azure SQL Elastic Pool** - Database resource sharing - 🗄️ **Azure SQL Server** - Server administration - 💾 **Azure Storage** - Blob, table, file, and data lake storage - 📋 **Azure Subscription** - Subscription management - 🏗️ **Azure Terraform Best Practices** - Infrastructure as code guidance - 🖥️ **Azure Virtual Desktop** - Virtual desktop infrastructure - 📊 **Azure Workbooks** - Custom visualizations - 🏗️ **Bicep** - Azure resource templates - 🏗️ **Cloud Architect** - Guided architecture design ## Documentation - See our [official documentation on learn.microsoft.com](https://learn.microsoft.com/azure/developer/azure-mcp-server/) to learn how to use the Azure MCP Server to interact with Azure resources through natural language commands from AI agents and other types of clients. - For additional command documentation and examples, see our [GitHub repository section on Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md). ## Feedback & Support - Check the [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) to diagnose and resolve common issues with the Azure MCP Server. - We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server. - 👉 Open an issue in the public [GitHub repository](https://github.com/Azure/azure-mcp/issues) — we’d love to hear from you! ## Contributing Want to contribute? Check out our [contribution guide](https://github.com/Azure/azure-mcp/blob/main/eng/vscode/CONTRIBUTING.md) to get started. ## License This project is licensed under the [MIT License](https://github.com/Azure/azure-mcp/blob/main/LICENSE).