@azure/mcp 0.8.3 → 0.8.4

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
+# <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.  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)
-
-
 ## 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,7 +14,8 @@ 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
 
@@ -34,58 +23,24 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
 
 # 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
-
-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
+- 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:
 
-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'?"

package/package.json

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