@azure/mcp 2.0.0-beta.2 → 2.0.0-beta.21

package/README.md

@@ -1,7 +1,7 @@
 # <img height="36" width="36" src="https://cdn-dynmedia-1.microsoft.com/is/content/microsoftcorp/acom_social_icon_azure" alt="Microsoft Azure Logo" /> Azure MCP Server NPM Package
 
-All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code.
 
+All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code.
 ## Table of Contents
 - [Overview](#overview)
 - [Installation](#installation)
@@ -33,7 +33,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,15 +50,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).
+
+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.
+
 
 # Usage
 
@@ -77,21 +85,25 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 
 ✨ The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
 
-### 🧮 Azure AI Foundry
+### 🧮 Microsoft Foundry
 
-* List AI Foundry models
-* Deploy AI Foundry models
-* List AI Foundry model deployments
+* List Microsoft Foundry models
+* Deploy Microsoft Foundry models
+* List Microsoft Foundry model deployments
 * List knowledge indexes
 * Get knowledge index schema configuration
-* Create AI Foundry agents
-* List AI Foundry agents
-* Connect and query AI Foundry agents
-* Evaluate AI Foundry agents
-* Get SDK samples for interacting with AI Foundry agent
-* Create AI Foundry agent threads
-* List AI Foundry agent threads
-* Get messages of an AI Foundry thread
+* Create Microsoft Foundry agents
+* 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
 
@@ -104,6 +116,9 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 * "Recognize speech from my audio file with language detection"
 * "Transcribe speech from audio with profanity filtering"
 * "Transcribe audio with phrase hints for better accuracy"
+* "Convert text to speech and save to output.wav"
+* "Synthesize speech from 'Hello, welcome to Azure' with Spanish voice"
+* "Generate MP3 audio from text with high quality format"
 
 ### ⚙️ Azure App Configuration
 
@@ -141,7 +156,19 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 * "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'"
+* "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'?"
+
+### �📦 Azure Container Apps
 
 * "List the container apps in my subscription"
 * "Show me the container apps in my 'my-resource-group' resource group"
@@ -179,6 +206,26 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 * "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'"
@@ -238,20 +285,27 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 * "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"
 
 ## Complete List of Supported Azure Services
 
-The Azure MCP Server provides tools for interacting with **40+ Azure service areas**:
+The Azure MCP Server provides tools for interacting with **42+ Azure service areas**:
 
-- 🧮 **Azure AI Foundry** - AI model management, AI model deployment, and knowledge index management
+- 🧮 **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
+- 🎤 **Azure AI Services Speech** - Speech-to-text recognition and text-to-speech synthesis
 - ⚙️ **Azure App Configuration** - Configuration management
 - 🕸️ **Azure App Service** - Web app hosting
 - 🛡️ **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
@@ -259,6 +313,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
 - 🐬 **Azure Database for MySQL** - MySQL database management
 - 🐘 **Azure Database for PostgreSQL** - PostgreSQL database management
 - 📊 **Azure Event Grid** - Event routing and management
+- � **Azure File Shares** - Azure managed file share operations
 - ⚡ **Azure Functions** - Function App management
 - 🔑 **Azure Key Vault** - Secrets, keys, and certificates
 - ☸️ **Azure Kubernetes Service (AKS)** - Container orchestration
@@ -266,7 +321,9 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
 - 🚀 **Azure Managed Grafana** - Monitoring dashboards
 - 🗃️ **Azure Managed Lustre** - High-performance Lustre filesystem operations
 - 🏪 **Azure Marketplace** - Product discovery
+- 🔄 **Azure Migrate** - Platform Landing Zone generation and modification guidance
 - 📈 **Azure Monitor** - Logging, metrics, and health monitoring
+- ⚖️ **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
@@ -274,11 +331,13 @@ The Azure MCP Server provides tools for interacting with **40+ 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 Subscription** - Subscription management
 - 🏗️ **Azure Terraform Best Practices** - Infrastructure as code guidance
 - 🖥️ **Azure Virtual Desktop** - Virtual desktop infrastructure
@@ -292,10 +351,12 @@ The Azure MCP Server provides tools for interacting with **40+ 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.
+- 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!
 
@@ -317,9 +378,27 @@ The software may collect information about you and your use of the software and
 
 ### Telemetry Configuration
 
-Telemetry collection is on by default.
+Telemetry collection is on by default. The server supports two telemetry streams:
+
+1. **User-provided telemetry**: If you configure your own Application Insights connection string via the `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable, telemetry will be sent to your Application Insights resource.
+
+2. **Microsoft telemetry**: By default, telemetry is also sent to Microsoft to help improve the product. This can be disabled separately from user-provided telemetry. See [Disabling All Telemetry](#disabling-all-telemetry) section below for more details.
+
+#### Disabling All Telemetry
+
+To disable all telemetry collection (both user-provided and Microsoft), set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false`:
+
+```bash
+export AZURE_MCP_COLLECT_TELEMETRY=false
+```
+
+#### Disabling Microsoft Telemetry Only
+
+To disable only Microsoft telemetry collection while keeping your own Application Insights telemetry active, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY_MICROSOFT` to `false`:
 
-To opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false` in your environment.
+```bash
+export AZURE_MCP_COLLECT_TELEMETRY_MICROSOFT=false
+```
 
 ## Compliance Responsibility
 

package/index.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 
 const os = require('os')
+const packageJson = require('./package.json')
 
 // Check if DEBUG environment variable is set
 const isDebugMode = process.env.DEBUG && (
   process.env.DEBUG.toLowerCase() === 'true' ||
-  process.env.DEBUG.includes('azure-mcp') ||
+  process.env.DEBUG.includes('mcp') ||
   process.env.DEBUG === '*'
 )
 
@@ -25,7 +26,9 @@ process.argv.forEach((val, index) => {
 const platform = os.platform()
 const arch = os.arch()
 
-const platformPackageName = `@azure/mcp-${platform}-${arch}`
+const packageName = packageJson.name
+const packageVersion = packageJson.version
+const platformPackageName = `${packageName}-${platform}-${arch}`
 
 // Try to load the platform package
 let platformPackage
@@ -34,58 +37,59 @@ try {
   platformPackage = require(platformPackageName)
 } catch (err) {
   debugLog(`Failed to require ${platformPackageName}, attempting auto-install: ${err.message}`)
-  
+
   // Try to automatically install the missing platform package
   try {
     const { execSync } = require('child_process')
-    
+
     console.error(`Installing missing platform package: ${platformPackageName}`)
-    
+
     // Try to install the platform package
     try {
-      execSync(`npm install ${platformPackageName}@latest`, { 
+      execSync(`npm install ${platformPackageName}@${packageVersion}`, {
         stdio: ['inherit', 'inherit', 'pipe'], // Only pipe stderr to capture errors
         timeout: 60000 // 60 second timeout
       })
     } catch (npmErr) {
       // If npm install fails, try with --no-save and different install strategies
       debugLog(`npm install failed, trying alternative installation methods: ${npmErr.message}`)
-      
+
       // Try with --no-save and --prefer-online
-      execSync(`npm install ${platformPackageName}@latest --no-save --prefer-online`, { 
+      execSync(`npm install ${platformPackageName}@${packageVersion} --no-save --prefer-online`, {
         stdio: ['inherit', 'inherit', 'pipe'],
         timeout: 60000
       })
     }
-    
+
     // Clear module cache and try to require again after installation
     Object.keys(require.cache).forEach(key => {
       if (key.includes(platformPackageName)) {
         delete require.cache[key]
       }
     })
-    
+
     platformPackage = require(platformPackageName)
-    
+
     console.error(`✅ Successfully installed and loaded ${platformPackageName}`)
-    
+
   } catch (installErr) {
     debugLog(`Auto-install failed: ${installErr.message}`)
-    
+
     console.error(`\n❌ Failed to load platform specific package '${platformPackageName}'`)
     console.error(`\n🔍 Troubleshooting steps:`)
-    console.error(`\n1. Clear npm cache and reinstall:`)
+    console.error(`\n1. Clear npm cache:`)
     console.error(`   npm cache clean --force`)
-    console.error(`   npm uninstall -g @azure/mcp`)
-    console.error(`   npm install -g @azure/mcp@latest`)
-    console.error(`\n2. If using npx, clear the cache:`)
-    console.error(`   npx clear-npx-cache`)
-    console.error(`   npx -y @azure/mcp@latest server start`)
-    console.error(`\n3. Manually install the platform package:`)
+    console.error(`\n2. If installing as a global tool, uninstall and reinstall:`)
+    console.error(`   npm uninstall -g ${packageName}`)
+    console.error(`   npm install -g ${packageName}`)
+    console.error(`\n3. If using npx, clear the npx cache and try again:`)
+    console.error(`   npx -y clear-npx-cache`)
+    console.error(`   npx -y ${packageName}@latest --version`)
+    console.error(`\n4. Manually install the platform package to check compatibility:`)
     console.error(`   npm install ${platformPackageName}@latest`)
-    console.error(`\n4. Check your internet connection and try again`)
-    console.error(`\n5. If the issue persists, please report it at:`)
-    console.error(`   https://github.com/Azure/azure-mcp/issues`)
+    console.error(`\n5. Check your internet connection and try again`)
+    console.error(`\n6. If the issue persists, please report it at:`)
+    console.error(`   https://github.com/microsoft/mcp/issues`)
     console.error(`\nOriginal error: ${err.message}`)
     console.error(`Install error: ${installErr.message}`)
     process.exit(1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/mcp",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.21",
   "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",
@@ -14,8 +14,8 @@
     "url": "https://github.com/microsoft/mcp/issues"
   },
   "repository": {
-    "type": "git",
-    "url": "https://github.com/microsoft/mcp.git"
+    "url": "https://github.com/microsoft/mcp.git",
+    "type": "git"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -33,14 +33,15 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@azure/mcp-darwin-x64": "2.0.0-beta.2",
-    "@azure/mcp-darwin-arm64": "2.0.0-beta.2",
-    "@azure/mcp-linux-arm64": "2.0.0-beta.2",
-    "@azure/mcp-win32-arm64": "2.0.0-beta.2",
-    "@azure/mcp-linux-x64": "2.0.0-beta.2",
-    "@azure/mcp-win32-x64": "2.0.0-beta.2"
+    "@azure/mcp-darwin-arm64": "2.0.0-beta.21",
+    "@azure/mcp-win32-x64": "2.0.0-beta.21",
+    "@azure/mcp-linux-arm64": "2.0.0-beta.21",
+    "@azure/mcp-darwin-x64": "2.0.0-beta.21",
+    "@azure/mcp-win32-arm64": "2.0.0-beta.21",
+    "@azure/mcp-linux-x64": "2.0.0-beta.21"
   },
   "scripts": {
     "postinstall": "node ./scripts/post-install-script.js"
-  }
+  },
+  "mcpName": "com.microsoft/azure"
 }

package/scripts/post-install-script.js

@@ -1,23 +1,19 @@
-const fs = require('fs')
-const path = require('path')
 const os = require('os');
 
 const platform = os.platform();
 const arch = os.arch();
 
-const pkgJsonPath = path.join(__dirname, '..', 'package.json');
-let baseName = '@azure/mcp';
-try {
-  const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
-  if (pkg.name) {
-    baseName = pkg.name;
-  }
-} catch (e) {
-  // fallback to default
+let baseName = '';
+try{
+    const packageJson = require('../package.json');
+    baseName = packageJson.name;
+}
+catch (err) {
+  console.error('Unable to verify platform package installation. Error reading package.json.');
+  process.exit(1);
 }
 
 const requiredPackage = `${baseName}-${platform}-${arch}`;
-
 try {
   require.resolve(requiredPackage);
 } catch (err) {