@azure/mcp 0.0.20 → 0.1.0

package/README.md

@@ -7,6 +7,15 @@ The Azure MCP Server implements the [MCP specification](https://modelcontextprot
 
 > Please note that this project is in Public Preview and implementation may significantly change prior to our General Availability.
 
+## 📑 Table of contents
+1. [🎯 Overview](#-overview)
+2. [🛠️ Currently Supported Tools](#%EF%B8%8F-currently-supported-tools)
+3. [🔌 Installation & Getting Started](#-getting-started)
+4. [🧪 Using Azure MCP Server](#-test-the-azure-mcp-server)
+5. [📝 Troubleshooting Issues](#-troubleshooting)
+6. [👥 Contributing to Azure MCP Server](#-contributing)
+
+
 ## 🎯 Overview
 
 ### ✨ What can you do with the Azure MCP Server?
@@ -82,11 +91,14 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
 - List and query Storage tables
 - Get container properties and metadata
 
-### 📈 Azure Monitor (Log Analytics)
+### 📈 Azure Monitor 
+#### Log Analytics
 - List Log Analytics workspaces
 - Query logs using KQL
 - List available tables
-- Configure monitoring options
+
+#### Health Models
+- Get health of an entity
 
 ### ⚙️ Azure App Configuration
 - List App Configuration stores
@@ -99,10 +111,8 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
 
 ### 📦 Azure Resource Groups
 - List resource groups
-- Resource group management operations
 
 ### 🚌 Azure Service Bus
-- Peek at messages from subscriptions and queues
 - Examine properties and runtime information about queues, topics, and subscriptions
 
 ### 🔧 Azure CLI Extension
@@ -116,12 +126,13 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
 - Support for template discovery, template initialization, provisioning and deployment
 - Cross-platform compatibility
 
+Agents and models can discover and learn best practices and usage guidelines for the `azd` MCP tool. For more information, see [AZD Best Practices](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt).
+
 ### 🛡️ Azure Best Practices
 - Get secure, production-grade Azure SDK best practices for effective code generation.
 
 For detailed command documentation and examples, see [Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md).
 
-
 ## 🔌 Getting Started
 
 The Azure MCP Server requires Node.js to install and run the server. If you don't have it installed, follow the instructions [here](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
@@ -202,6 +213,24 @@ AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
 
 Optionally, customers can use `--env` or `--volume` to pass authentication values.
 
+### 🔄️ Updates
+
+#### NPX
+
+If you use the default package spec of `@azure/mcp@latest`, npx will look for a new version on each server start. If you use just `@azure/mcp`, npx will continue to use its cached version until its cache is cleared.
+
+#### NPM
+
+If you globally install the cli via `npm install -g @azure/mcp` it will use the installed version until you manually update it with `npm update -g @azure/mcp`.
+
+#### Docker
+
+There is no version update built into the docker image.  To update, just pull the latest from the repo and repeat the [docker installation instructions](#docker-install).
+
+#### VS Code
+
+Installation in VS Code should be in one of the previous forms and the update instructions are the same. If you installed the mcp server with the `npx` command and  `-y @azure/mcp@latest` args, npx will check for package updates each time VS Code starts the server. Using a docker container in VS Code has the same no-update limitation described above.
+
 ## 🧪 Test the Azure MCP Server
 
 1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
@@ -215,7 +244,7 @@ You can easily configure your MCP client to use the Azure MCP Server. Have your
 
 ### Using standard IO
 
-Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. For instructions on using VS Code, follow instructions in [One-Click Install](#-one-click-install) or [Manual Install](#-manual-install).
+Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. For instructions on using , follow instructions in [One-Click Install](#-one-click-install) or [Manual Install](#-manual-install).
 
 ### Using SSE
 
@@ -289,5 +318,5 @@ This project has adopted the
 [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 For more information, see the
 [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
-or contact [opencode@microsoft.com](mailto:opencode@microsoft.com)
+or contact [open@microsoft.com](mailto:open@microsoft.com)
 with any additional questions or comments.

package/index.js

@@ -4,7 +4,7 @@ const os = require('os')
 
 // Check if DEBUG environment variable is set
 const isDebugMode = process.env.DEBUG && (
-  process.env.DEBUG.toLowerCase() === 'true' || 
+  process.env.DEBUG.toLowerCase() === 'true' ||
   process.env.DEBUG.includes('azure-mcp') ||
   process.env.DEBUG === '*'
 )
@@ -12,7 +12,7 @@ const isDebugMode = process.env.DEBUG && (
 // Helper function for debug logging
 function debugLog(...args) {
   if (isDebugMode) {
-    console.log(...args)
+    console.error(...args)
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure/mcp",
-  "version": "0.0.20",
+  "version": "0.1.0",
   "description": "Azure MCP Server - Model Context Protocol implementation for Azure",
   "author": "Microsoft Corporation",
   "homepage": "https://github.com/Azure/azure-mcp#readme",
@@ -33,11 +33,11 @@
     "arm64"
   ],
   "optionalDependencies": {
-    "@azure/mcp-darwin-x64": "0.0.20",
-    "@azure/mcp-linux-arm64": "0.0.20",
-    "@azure/mcp-darwin-arm64": "0.0.20",
-    "@azure/mcp-win32-x64": "0.0.20",
-    "@azure/mcp-linux-x64": "0.0.20",
-    "@azure/mcp-win32-arm64": "0.0.20"
+    "@azure/mcp-darwin-x64": "0.1.0",
+    "@azure/mcp-linux-arm64": "0.1.0",
+    "@azure/mcp-darwin-arm64": "0.1.0",
+    "@azure/mcp-win32-x64": "0.1.0",
+    "@azure/mcp-linux-x64": "0.1.0",
+    "@azure/mcp-win32-arm64": "0.1.0"
   }
 }