@azure/mcp 2.0.0-beta.9 → 2.0.0

package/README.md

@@ -7,6 +7,7 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 - [Installation](#installation)
 - [Usage](#usage)
     - [Getting Started](#getting-started)
+    - [Sovereign Cloud Support](#sovereign-cloud-support)
     - [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)
 - [Support and Reference](#support-and-reference)
@@ -33,7 +34,7 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
     ```json
     {
         "mcpServers": {
-            "azure-mcp-server": {
+            "Azure MCP Server": {
             "command": "npx",
             "args": [
                 "-y",
@@ -50,28 +51,23 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 **Client-Specific Configuration**
 | IDE | File Location | Documentation Link |
 |-----|---------------|-------------------|
-| **Amazon Q Developer** | `~/.aws/amazonq/mcp.json` (global)<br>`.amazonq/mcp.json` (workspace) | [AWS Q Developer MCP Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html) |
+| **VS Code** | `.vscode/mcp.json` (workspace)<br>`settings.json` (user) | [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) |
+| **Visual Studio** | `.mcp.json` (solution/workspace) | [Visual Studio MCP Setup](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) |
+| **GitHub Copilot CLI** | `~/.copilot/mcp-config.json` | [Copilot CLI MCP Configuration](#github-copilot-cli-configuration) |
 | **Claude Code** | `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://scottspence.com/posts/configuring-mcp-tools-in-claude-code) |
-| **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)<br>`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
-| **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) |
 | **Eclipse IDE** | GitHub Copilot Chat -> Configure Tools -> MCP Servers  | [Eclipse MCP Documentation](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp#configuring-mcp-servers-in-eclipse) |
 | **IntelliJ IDEA** | Built-in MCP server (2025.2+)<br>Settings > Tools > MCP Server | [IntelliJ MCP Documentation](https://www.jetbrains.com/help/ai-assistant/mcp.html) |
-| **Visual Studio** | `.mcp.json` (solution/workspace) | [Visual Studio MCP Setup](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) |
-| **VS Code** | `.vscode/mcp.json` (workspace)<br>`settings.json` (user) | [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) |
+| **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) |
 | **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | [Windsurf Cascade MCP Integration](https://docs.windsurf.com/windsurf/cascade/mcp) |
+| **Amazon Q Developer** | `~/.aws/amazonq/mcp.json` (global)<br>`.amazonq/mcp.json` (workspace) | [AWS Q Developer MCP Guide](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/qdev-mcp.html) |
+| **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)<br>`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
 
 ## Remote MCP Server (preview)
 
 Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoints. To self-host the Azure MCP Server for use with these platforms, deploy it as a remote MCP server on [Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview).
 
-### Microsoft Foundry
+Check out the remote hosting [azd templates](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/azd-templates/README.md) for deployment options.
 
-1. Follow the [deployment guide](https://github.com/Azure-Samples/azmcp-foundry-aca-mi) for Microsoft Foundry.
-2. See [Microsoft Foundry's MCP documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/model-context-protocol) for more details.
-
-### Microsoft Copilot Studio
-
-1. Follow the [deployment guide](https://github.com/Azure-Samples/azmcp-copilot-studio-aca-mi) for Microsoft Copilot Studio.
 
 # Usage
 
@@ -86,6 +82,42 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 1. 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 repository](https://github.com/microsoft/mcp/issues/new/choose)
 
+## Sovereign Cloud Support
+
+Azure MCP Server supports connecting to Azure sovereign clouds. By default, it authenticates against the Azure Public Cloud.
+
+| Cloud | Aliases |
+|-------|---------|
+| Azure Public Cloud | `AzureCloud`, `AzurePublicCloud`, `Public`, `AzurePublic` | 
+| Azure China Cloud | `AzureChinaCloud`, `China`, `AzureChina` |
+| Azure US Government | `AzureUSGovernment`, `USGov`, `AzureUSGovernmentCloud`, `USGovernment` |
+
+*_The aliases are case insensitive._
+
+Use the `--cloud` option when starting the server, or set the `AZURE_CLOUD` environment variable:
+
+```bash
+# Command line
+azmcp server start --cloud AzureChinaCloud
+
+# Environment variable (PowerShell)
+$env:AZURE_CLOUD = "AzureUSGovernment"
+azmcp server start
+```
+
+Before connecting, authenticate your local tools against the target cloud:
+
+```bash
+# Azure CLI
+az cloud set --name AzureChinaCloud
+az login
+
+# Azure PowerShell
+Connect-AzAccount -Environment AzureChinaCloud
+```
+
+For full configuration options, see the [Sovereign Clouds documentation](https://github.com/microsoft/mcp/blob/main/docs/sovereign-clouds.md).
+
 ## What can you do with the Azure MCP Server?
 
 ✨ The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
@@ -101,10 +133,10 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 * List Microsoft Foundry agents
 * Connect and query Microsoft Foundry agents
 * Evaluate Microsoft Foundry agents
-* Get SDK samples for interacting with Microsoft Foundry agent
-* Create Microsoft Foundry agent threads
-* List Microsoft Foundry agent threads
-* Get messages of a Microsoft Foundry thread
+
+### 📊 Azure Advisor
+
+* "List my Advisor recommendations"
 
 ### 🔎 Azure AI Search
 
@@ -132,15 +164,25 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 
 ### 🕸️ Azure App Service
 
-* "List the websites in my subscription"
-* "Show me the websites in my 'my-resource-group' resource group"
-* "Get the details for website 'my-website'"
-* "Get the details for app service plan 'my-app-service-plan'"
+* "Add a database connection for an App Service web app"
+* "List the web apps in my subscription"
+* "Show me the web apps in my 'my-resource-group' resource group"
+* "Get the details for web app 'my-webapp' in 'my-resource-group'"
+* "Get the application settings for my web app 'my-webapp' in 'my-resource-group'"
+* "Add application setting 'LogLevel' with value 'INFO' to my 'my-webapp' in 'my-resource-group'"
+* "Set application setting 'LogLevel' to 'WARNING' to my 'my-webapp' in 'my-resource-group'"
+* "Delete application setting 'LogLevel' from my 'my-webapp' in 'my-resource-group'"
+* "List the deployments for web app 'my-webapp' in 'my-resource-group'"
+* "Get the deployment 'deployment-id' for web app 'my-webapp' in 'my-resource-group'"
 
 ### 🖥️ Azure CLI Generate
 
 * Generate Azure CLI commands based on user intent
 
+Example prompts that generate Azure CLI commands:
+
+* "Get the details for app service plan 'my-app-service-plan'"
+
 ### 🖥️ Azure CLI Install
 
 * Get installation instructions for Azure CLI, Azure Developer CLI and Azure Functions Core Tools CLI for your platform.
@@ -157,7 +199,36 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 * "Send an email from my communication service endpoint with custom sender name and multiple recipients"
 * "Send an email to 'user1@example.com' and 'user2@example.com' with subject 'Team Update' and message 'Please review the attached document.'"
 
-### 📦 Azure Container Apps
+### 🖥️ Azure Compute
+
+* "List all my managed disks in subscription 'my-subscription'"
+* "Show me all disks in resource group 'my-resource-group'"
+* "Get details of disk 'my-disk' in resource group 'my-resource-group'"
+* "Create a 128 GB Premium_LRS managed disk named 'my-disk' in resource group 'my-resource-group'"
+* "Create a managed disk from snapshot in resource group 'my-resource-group'"
+* "Create a disk 'my-disk' in resource group 'my-resource-group' with tags env=prod team=infra"
+* "Delete managed disk 'my-disk' in resource group 'my-resource-group'"
+* "Update disk 'my-disk' in resource group 'my-resource-group' to 256 GB"
+* "Change the SKU of disk 'my-disk' to Premium_LRS"
+* "Set the IOPS limit on ultra disk 'my-disk' in resource group 'my-resource-group' to 10000"
+* "List all virtual machines in my subscription"
+* "Show me all VMs in resource group 'my-resource-group'"
+* "Get details for virtual machine 'my-vm' in resource group 'my-resource-group'"
+* "Get virtual machine 'my-vm' with instance view including power state and runtime status"
+* "Show me the power state and provisioning status of VM 'my-vm'"
+* "What is the current status of my virtual machine 'my-vm'?"
+* "Create a new VM named 'my-vm' in resource group 'my-rg' for web workloads"
+* "Create a Linux VM with Ubuntu 22.04 and SSH key authentication"
+* "Create a development VM with Standard_B2s size in East US"
+* "Update VM 'my-vm' tags to environment=production"
+* "Create a VMSS named 'my-vmss' with 3 instances for web workloads"
+* "Update VMSS 'my-vmss' capacity to 5 instances"
+* "Delete virtual machine 'my-vm' in resource group 'my-resource-group'"
+* "Force delete VM 'my-vm' in resource group 'my-rg' using force-deletion"
+* "Delete virtual machine scale set 'my-vmss' in resource group 'my-resource-group'"
+* "Force delete VMSS 'my-vmss' in resource group 'my-rg' using force-deletion"
+
+### �📦 Azure Container Apps
 
 * "List the container apps in my subscription"
 * "Show me the container apps in my 'my-resource-group' resource group"
@@ -195,6 +266,26 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 * "Publish an event with data '{\"name\": \"test\"}' to topic 'my-topic' using CloudEvents schema"
 * "Send custom event data to Event Grid topic 'analytics-events' with EventGrid schema"
 
+### 📂 Azure File Shares
+
+* "Get details about a specific file share in my resource group"
+* "Create a new Azure managed file share with NFS protocol"
+* "Create a file share with 64 GiB storage, 3000 IOPS, and 125 MiB/s throughput"
+* "Update the provisioned storage size of my file share"
+* "Update network access settings for my file share"
+* "Delete a file share from my resource group"
+* "Check if a file share name is available"
+* "Get details about a file share snapshot"
+* "Create a snapshot of my file share"
+* "Update tags on a file share snapshot"
+* "Delete a file share snapshot"
+* "Get a private endpoint connection for my file share"
+* "Update private endpoint connection status to Approved"
+* "Delete a private endpoint connection"
+* "Get file share limits and quotas for a region"
+* "Get provisioning recommendations for my file share workload"
+* "Get usage data and metrics for my file share"
+
 ### 🔑 Azure Key Vault
 
 * "List all secrets in my key vault 'my-vault'"
@@ -223,6 +314,14 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 
 * "Query my Log Analytics workspace"
 
+### 🧭 Azure Monitor Instrumentation (under Azure Monitor)
+
+* "List available Azure Monitor onboarding learning resources"
+* "Get the learning resource at 'concepts/dotnet/opentelemetry-pipeline.md'"
+* "Start Azure Monitor instrumentation orchestration for my local workspace"
+* "Continue to the next orchestration step after I complete the previous action"
+* "Send brownfield analysis findings to continue migration planning"
+
 ### 🔧 Azure Resource Management
 
 * "List my resource groups"
@@ -254,12 +353,25 @@ Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoin
 * "Get details about my Storage container"
 * "Upload my file to the blob container"
 
+### 🔄 Azure Migrate
+
+* "Generate a Platform Landing Zone"
+* "Turn off DDoS protection in my Platform Landing Zone"
+* "Turn off Bastion host in my Platform Landing Zone"
+
+### 🏛️ Azure Well-Architected Framework
+
+* "List all services with Well-Architected Framework guidance"
+* "What services have architectural guidance?"
+* "Get Well-Architected Framework guidance for App Service"
+* "What's the architectural guidance for Azure Cosmos DB?"
 
 ## Complete List of Supported Azure Services
 
-The Azure MCP Server provides tools for interacting with **41+ Azure service areas**:
+The Azure MCP Server provides tools for interacting with **43+ Azure service areas**:
 
 - 🧮 **Microsoft Foundry** - AI model management, AI model deployment, and knowledge index management
+- 📊 **Azure Advisor** - Advisor recommendations
 - 🔎 **Azure AI Search** - Search engine/vector database operations
 - 🎤 **Azure AI Services Speech** - Speech-to-text recognition and text-to-speech synthesis
 - ⚙️ **Azure App Configuration** - Configuration management
@@ -267,22 +379,27 @@ The Azure MCP Server provides tools for interacting with **41+ Azure service are
 - 🛡️ **Azure Best Practices** - Secure, production-grade guidance
 - 🖥️ **Azure CLI Generate** - Generate Azure CLI commands from natural language
 - 📞 **Azure Communication Services** - SMS messaging and communication
-- 🔐 **Azure Confidential Ledger** - Tamper-proof ledger operations
+- � **Azure Compute** - Virtual Machine, Virtual Machine Scale Set, and Disk management
+- �🔐 **Azure Confidential Ledger** - Tamper-proof ledger operations
 - 📦 **Azure Container Apps** - Container hosting
 - 📦 **Azure Container Registry (ACR)** - Container registry management
 - 📊 **Azure Cosmos DB** - NoSQL database operations
 - 🧮 **Azure Data Explorer** - Analytics queries and KQL
 - 🐬 **Azure Database for MySQL** - MySQL database management
 - 🐘 **Azure Database for PostgreSQL** - PostgreSQL database management
+- 🏭 **Azure Device Registry** - Device Registry namespace management
 - 📊 **Azure Event Grid** - Event routing and management
-- ⚡ **Azure Functions** - Function App management
+- 📁 **Azure File Shares** - Azure managed file share operations
+- ⚡ **Azure Functions** - Function App management and functions project files, language support, and templates source code
 - 🔑 **Azure Key Vault** - Secrets, keys, and certificates
 - ☸️ **Azure Kubernetes Service (AKS)** - Container orchestration
 - 📦 **Azure Load Testing** - Performance testing
 - 🚀 **Azure Managed Grafana** - Monitoring dashboards
 - 🗃️ **Azure Managed Lustre** - High-performance Lustre filesystem operations
 - 🏪 **Azure Marketplace** - Product discovery
-- 📈 **Azure Monitor** - Logging, metrics, and health monitoring
+- 🔄 **Azure Migrate** - Platform Landing Zone generation and modification guidance
+- 📈 **Azure Monitor** - Logging, metrics, health monitoring, and instrumentation onboarding/migration workflow for local applications
+- ⚖️ **Azure Policy** - Policies set to enforce organizational standards
 - ⚙️ **Azure Native ISV Services** - Third-party integrations
 - 🛡️ **Azure Quick Review CLI** - Compliance scanning
 - 📊 **Azure Quota** - Resource quota and usage management
@@ -290,15 +407,17 @@ The Azure MCP Server provides tools for interacting with **41+ Azure service are
 - 🔴 **Azure Redis Cache** - In-memory data store
 - 🏗️ **Azure Resource Groups** - Resource organization
 - 🚌 **Azure Service Bus** - Message queuing
+- 🧵 **Azure Service Fabric** - Managed cluster node operations
 - 🏥 **Azure Service Health** - Resource health status and availability
 - 🗄️ **Azure SQL Database** - Relational database management
 - 🗄️ **Azure SQL Elastic Pool** - Database resource sharing
 - 🗄️ **Azure SQL Server** - Server administration
 - 💾 **Azure Storage** - Blob storage
-- 🔄 **Azure Storage Sync** - Azure File Sync management operations
+-  **Azure Storage Sync** - Azure File Sync management operations
 - 📋 **Azure Subscription** - Subscription management
 - 🏗️ **Azure Terraform Best Practices** - Infrastructure as code guidance
 - 🖥️ **Azure Virtual Desktop** - Virtual desktop infrastructure
+- 🏛️ **Azure Well-Architected Framework** - Architectural best practices and design patterns
 - 📊 **Azure Workbooks** - Custom visualizations
 - 🏗️ **Bicep** - Azure resource templates
 - 🏗️ **Cloud Architect** - Guided architecture design
@@ -309,10 +428,12 @@ The Azure MCP Server provides tools for interacting with **41+ Azure service are
 
 - 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 [Azure MCP Commands](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/docs/azmcp-commands.md).
+- Use [Prompt Templates](https://github.com/microsoft/mcp/blob/main/docs/prompt-templates.md) to set tenant and subscription context once at the beginning of your Copilot session, avoiding repetitive information in subsequent prompts.
 
 ## Feedback and Support
 
 - Check the [Troubleshooting guide](https://aka.ms/azmcp/troubleshooting) to diagnose and resolve common issues with the Azure MCP Server.
+- Review the [Known Issues](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/KNOWN-ISSUES.md) for current limitations and workarounds.
 - For advanced troubleshooting, you can enable [support logging](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/TROUBLESHOOTING.md#support-logging) using the `--dangerously-write-support-logs-to-dir` option.
 - 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](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we’d love to hear from you!

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/mcp",
-  "version": "2.0.0-beta.9",
+  "version": "2.0.0",
   "description": "Azure MCP Server - Model Context Protocol implementation for Azure",
   "author": "Microsoft",
   "homepage": "https://github.com/Microsoft/mcp/blob/main/servers/Azure.Mcp.Server#readme",
@@ -33,12 +33,12 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@azure/mcp-linux-x64": "2.0.0-beta.9",
-    "@azure/mcp-darwin-arm64": "2.0.0-beta.9",
-    "@azure/mcp-win32-arm64": "2.0.0-beta.9",
-    "@azure/mcp-win32-x64": "2.0.0-beta.9",
-    "@azure/mcp-darwin-x64": "2.0.0-beta.9",
-    "@azure/mcp-linux-arm64": "2.0.0-beta.9"
+    "@azure/mcp-linux-arm64": "2.0.0",
+    "@azure/mcp-darwin-arm64": "2.0.0",
+    "@azure/mcp-darwin-x64": "2.0.0",
+    "@azure/mcp-win32-x64": "2.0.0",
+    "@azure/mcp-win32-arm64": "2.0.0",
+    "@azure/mcp-linux-x64": "2.0.0"
   },
   "scripts": {
     "postinstall": "node ./scripts/post-install-script.js"