@azure/mcp 2.0.0-beta.1 → 2.0.0-beta.10

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)
@@ -54,11 +54,25 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 | **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) |
 | **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | [Windsurf Cascade MCP Integration](https://docs.windsurf.com/windsurf/cascade/mcp) |
 
+## 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
+
+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
 
 ## Getting Started
@@ -76,13 +90,21 @@ 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 Azure Foundry models
-* Deploy foundry models
-* List 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 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 AI Search
 
@@ -95,6 +117,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
 
@@ -232,11 +257,11 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 
 ## 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 **41+ 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 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
@@ -270,6 +295,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
 - 🗄️ **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
@@ -287,6 +313,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
 ## 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!
 
@@ -308,9 +335,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.1",
+  "version": "2.0.0-beta.10",
   "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": {
-    "url": "https://github.com/microsoft/mcp.git",
-    "type": "git"
+    "type": "git",
+    "url": "https://github.com/microsoft/mcp.git"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -33,14 +33,15 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@azure/mcp-win32-arm64": "2.0.0-beta.1",
-    "@azure/mcp-darwin-arm64": "2.0.0-beta.1",
-    "@azure/mcp-win32-x64": "2.0.0-beta.1",
-    "@azure/mcp-darwin-x64": "2.0.0-beta.1",
-    "@azure/mcp-linux-arm64": "2.0.0-beta.1",
-    "@azure/mcp-linux-x64": "2.0.0-beta.1"
+    "@azure/mcp-darwin-arm64": "2.0.0-beta.10",
+    "@azure/mcp-linux-x64": "2.0.0-beta.10",
+    "@azure/mcp-darwin-x64": "2.0.0-beta.10",
+    "@azure/mcp-win32-x64": "2.0.0-beta.10",
+    "@azure/mcp-win32-arm64": "2.0.0-beta.10",
+    "@azure/mcp-linux-arm64": "2.0.0-beta.10"
   },
   "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) {