@azure/mcp 0.8.3 → 0.8.5

package/README.md

@@ -1,22 +1,10 @@
-# <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
-
-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.  This project is in Public Preview and implementation may significantly change prior to our General Availability.
-
-[![Install Azure MCP in VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode-insiders:extension/ms-azuretools.vscode-azure-mcp-server) [![Install Azure MCP in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_Azure_MCP_Server-C16FDE?style=flat-square&logo=visualstudio&logoColor=white)](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022)  [![Install Azure MCP Server](https://img.shields.io/badge/IntelliJ%20IDEA-Install%20Azure%20MCP%20Server-1495b1?style=flat-square&logo=intellijidea&logoColor=white)](https://plugins.jetbrains.com/plugin/8053)
+# <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.
 
 ## Table of Contents
 - [Overview](#overview)
 - [Installation](#installation)
-    - [IDE](#ide)
-        - [VS Code (Recommended)](#vs-code-recommended)
-        - [Visual Studio 2022](#visual-studio-2022)
-        - [IntelliJ IDEA](#intellij-idea)
-        - [Manual Setup](#manual-setup)
-    - [Package Manager](#package-manager)
-        - [NuGet](#nuget)
-        - [NPM](#npm)
-        - [Docker](#docker)
 - [Usage](#usage)
     - [Getting Started](#getting-started)
     - [What can you do with the Azure MCP Server?](#what-can-you-do-with-the-azure-mcp-server)
@@ -26,66 +14,33 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
     - [Feedback and Support](#feedback-and-support)
     - [Security](#security)
     - [Data Collection](#data-collection)
-    - [Contributing and Code of Conduct](#contributing)
+    - [Contributing](#contributing)
+    - [Code of Conduct](#code-of-conduct)
 
 # Overview
 
-**Azure MCP Server** supercharges your agents with Azure context across **30+ different Azure services**.
+**Azure MCP Server** supercharges your agents with Azure context across **40+ different Azure services**.
 
 # Installation
 
-Install Azure MCP Server using either an IDE extension or package manager. Choose one method below.
-
-## IDE
-
-Start using Azure MCP with your favorite IDE.  We recommend VS Code:
-
-### VS Code (Recommended)
-
-1. Install either the stable or Insiders release of VS Code:
-   * [💫 Stable release](https://code.visualstudio.com/download)
-   * [🔮 Insiders release](https://code.visualstudio.com/insiders)
-1. Install the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extensions
-1. Install the [Azure MCP Server](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server) extension
-
-### Visual Studio 2022
+- To use Azure MCP server from node you must have Node.js (LTS) installed and available on your system PATH — this provides both `npm` and `npx`. We recommend Node.js 20 LTS or later. To verify your installation run: `node --version`, `npm --version`, and `npx --version`.
+-  Configure your `mcp.json` file with the following:
 
-From within Visual Studio 2022 install [GitHub Copilot for Azure (VS 2022)](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022):
-1. Go to `Extensions | Manage Extensions...`
-2. Switch to the `Browse` tab in `Extension Manager`
-3. Search for `Github Copilot for Azure`
-4. Click `Install`
-
-### IntelliJ IDEA
-
-1. Install either the [IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download) or [IntelliJ IDEA Community](https://www.jetbrains.com/idea/download) edition.
-1. Install the [GitHub Copilot](https://plugins.jetbrains.com/plugin/17718-github-copilot) plugin.
-1. Install the [Azure Toolkit for Intellij](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij) plugin.
-
-### Manual Setup
-Azure MCP Server can also be configured across other IDEs, CLIs, and MCP clients:
-
-<details>
-<summary>Manual setup instructions</summary>
-
-#### Sample Configuration
-
-Copy this configuration to your client's MCP configuration file:
-```json
-{
-    "mcpServers": {
-        "azure-mcp-server": {
-        "command": "npx",
-        "args": [
-            "-y",
-            "@azure/mcp@latest",
-            "server",
-            "start"
-            ]
+    ```json
+    {
+        "mcpServers": {
+            "azure-mcp-server": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@azure/mcp@latest",
+                "server",
+                "start"
+                ]
+            }
         }
     }
-}
-```
+    ```
 **Note:** When manually configuring Visual Studio and Visual Studio Code, use `servers` instead of `mcpServers` as the root object.
 
 **Client-Specific Configuration**
@@ -99,69 +54,6 @@ Copy this configuration to your client's MCP configuration file:
 | **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) |
-</details>
-
-
-## Package Manager
-Package manager installation offers several advantages over IDE-specific setup, including centralized dependency management, CI/CD integration, support for headless/server environments, version control, and project portability.
-
-Install Azure MCP Server via a package manager:
-
-### NuGet
-
-Install the .NET Tool: [Azure.Mcp](https://www.nuget.org/packages/Azure.Mcp).
-
-```bash
-dotnet tool install --global Azure.Mcp
-```
-
-### NPM
-
-Install the Node.js package: [@azure/mcp](https://www.npmjs.com/package/@azure/mcp).
-
-```bash
-npm install -g @azure/mcp
-```
-
-### Docker
-
-Run the Azure MCP server as a Docker container for easy deployment and isolation. The container image is available at [mcr.microsoft.com/azure-sdk/azure-mcp](https://mcr.microsoft.com/artifact/mar/azure-sdk/azure-mcp).
-
-<details>
-<summary>Docker instructions</summary>
-
-#### Create an env file with Azure credentials
-
-1. Create a `.env` file with Azure credentials ([see EnvironmentCredential options](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential)):
-
-```bash
-AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
-AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
-AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
-```
-
-#### Configure your MCP client to use Docker
-
-2. Add or update existing `mcp.json`.  Replace `/full/path/to/your/.env` with the actual `.env` file path.
-
-```json
-   {
-      "mcpServers": {
-         "Azure MCP Server": {
-            "command": "docker",
-            "args": [
-               "run",
-               "-i",
-               "--rm",
-               "--env-file",
-               "/full/path/to/your/.env",
-               "mcr.microsoft.com/azure-sdk/azure-mcp:latest"
-            ]
-         }
-      }
-   }
-```
-</details>
 
 To use Azure Entra ID, review the [troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/TROUBLESHOOTING.md#using-azure-entra-id-with-docker).
 
@@ -189,7 +81,7 @@ To use Azure Entra ID, review the [troubleshooting guide](https://github.com/mic
 * List foundry model deployments
 * List knowledge indexes
 * Get knowledge index schema configuration
-  
+
 ### 🔎 Azure AI Search
 
 * "What indexes do I have in my Azure AI Search service 'mysvc'?"
@@ -218,6 +110,13 @@ To use Azure Entra ID, review the [troubleshooting guide](https://github.com/mic
 * "Get the details for website 'my-website'"
 * "Get the details for app service plan 'my-app-service-plan'"
 
+### 📞 Azure Communication Services
+
+* "Send an SMS message to +1234567890"
+* "Send SMS with delivery reporting enabled"
+* "Send a broadcast SMS to multiple recipients"
+* "Send SMS with custom tracking tag"
+
 ### 📦 Azure Container Apps
 
 * "List the container apps in my subscription"
@@ -229,13 +128,6 @@ To use Azure Entra ID, review the [troubleshooting guide](https://github.com/mic
 * "Show me my container registries in the 'my-resource-group' 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"
-* "List the node pools for my AKS cluster"
-* "Get details for the node pool 'np1' of my AKS cluster 'my-aks-cluster' in the 'my-resource-group' resource group"
-
 ### 📊 Azure Cosmos DB
 
 * "Show me all my Cosmos DB databases"
@@ -268,10 +160,19 @@ To use Azure Entra ID, review the [troubleshooting guide](https://github.com/mic
 * "Import a certificate file into key vault 'my-vault' using the name 'tls-cert'"
 * "Get the account settings for my key vault 'my-vault'"
 
+### ☸️ Azure Kubernetes Service (AKS)
+
+* "List my AKS clusters in my subscription"
+* "Show me all my Azure Kubernetes Service clusters"
+* "List the node pools for my AKS cluster"
+* "Get details for the node pool 'np1' of my AKS cluster 'my-aks-cluster' in the 'my-resource-group' resource group"
+
 ### ⚡ Azure Managed Lustre
 
 * "List the Azure Managed Lustre clusters in resource group 'my-resource-group'"
 * "How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?"
+* "Check if 'my-subnet-id' can host an Azure Managed Lustre with 'my-size' TiB and 'my-sku' in 'my-region'
+* Create a 4 TIB Azure Managed Lustre filesystem in 'my-region' attaching to 'my-subnet' in virtual network 'my-virtual-network'
 
 ### 📊 Azure Monitor
 
@@ -311,7 +212,7 @@ To use Azure Entra ID, review the [troubleshooting guide](https://github.com/mic
 
 ## Complete List of Supported Azure Services
 
-The Azure MCP Server provides tools for interacting with **30+ Azure service areas**:
+The Azure MCP Server provides tools for interacting with **40+ Azure service areas**:
 
 - 🧮 **Azure AI Foundry** - AI model management, AI model deployment, and knowledge index management
 - 🔎 **Azure AI Search** - Search engine/vector database operations
@@ -319,6 +220,8 @@ The Azure MCP Server provides tools for interacting with **30+ Azure service are
 - ⚙️ **Azure App Configuration** - Configuration management
 - 🕸️ **Azure App Service** - Web app hosting
 - 🛡️ **Azure Best Practices** - Secure, production-grade guidance
+- 📞 **Azure Communication Services** - SMS messaging and communication
+- 🔐 **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
@@ -340,11 +243,11 @@ The Azure MCP Server provides tools for interacting with **30+ Azure service are
 - 🎭 **Azure RBAC** - Access control management
 - 🔴 **Azure Redis Cache** - In-memory data store
 - 🏗️ **Azure Resource Groups** - Resource organization
+- 🚌 **Azure Service Bus** - Message queuing
+- 🏥 **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 Service Bus** - Message queuing
-- 🏥 **Azure Service Health** - Resource health status and availability
 - 💾 **Azure Storage** - Blob storage
 - 📋 **Azure Subscription** - Subscription management
 - 🏗️ **Azure Terraform Best Practices** - Infrastructure as code guidance
@@ -358,7 +261,7 @@ The Azure MCP Server provides tools for interacting with **30+ Azure service are
 ## 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 [Azure MCP Commands](https://github.com/microsoft/mcp/blob/main/docs/azmcp-commands.md).
+- 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).
 
 ## Feedback and Support
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/mcp",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "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 @@
     "x64"
   ],
   "optionalDependencies": {
-    "@azure/mcp-linux-arm64": "0.8.3",
-    "@azure/mcp-linux-x64": "0.8.3",
-    "@azure/mcp-darwin-arm64": "0.8.3",
-    "@azure/mcp-darwin-x64": "0.8.3",
-    "@azure/mcp-win32-arm64": "0.8.3",
-    "@azure/mcp-win32-x64": "0.8.3"
+    "@azure/mcp-linux-arm64": "0.8.5",
+    "@azure/mcp-linux-x64": "0.8.5",
+    "@azure/mcp-darwin-arm64": "0.8.5",
+    "@azure/mcp-darwin-x64": "0.8.5",
+    "@azure/mcp-win32-arm64": "0.8.5",
+    "@azure/mcp-win32-x64": "0.8.5"
   },
   "scripts": {
     "postinstall": "node ./scripts/post-install-script.js"