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

package/README.md

@@ -54,6 +54,7 @@ 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) |
@@ -78,11 +79,19 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 
 ### 🧮 Azure AI Foundry
 
-* List Azure Foundry models
-* Deploy foundry models
-* List foundry model deployments
+* List AI Foundry models
+* Deploy AI Foundry models
+* List AI 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
 
 ### 🔎 Azure AI Search
 
@@ -95,6 +104,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
 
@@ -236,7 +248,8 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
 
 - 🧮 **Azure AI 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 AI Best Practices** - AI app development guidance for Azure AI Foundry and Microsoft Agent Framework
 - ⚙️ **Azure App Configuration** - Configuration management
 - 🕸️ **Azure App Service** - Web app hosting
 - 🛡️ **Azure Best Practices** - Secure, production-grade guidance

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.3",
   "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,12 +33,12 @@
     "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-linux-x64": "2.0.0-beta.3",
+    "@azure/mcp-win32-x64": "2.0.0-beta.3",
+    "@azure/mcp-darwin-x64": "2.0.0-beta.3",
+    "@azure/mcp-linux-arm64": "2.0.0-beta.3",
+    "@azure/mcp-darwin-arm64": "2.0.0-beta.3",
+    "@azure/mcp-win32-arm64": "2.0.0-beta.3"
   },
   "scripts": {
     "postinstall": "node ./scripts/post-install-script.js"

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) {