Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions eng/pipelines/templates/jobs/verify-packages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -55,5 +55,3 @@ jobs:
-ArtifactsDirectory $(Pipeline.Workspace)
-TargetOs ${{ parameters.OSName }}
-TargetArch $(Architecture)
-WorkingDirectory $(Agent.TempDirectory)
condition: and(succeeded(), eq(variables['RunUnitTests'], 'true')) # skipping on arm64 machines until #753 is fixed
51 changes: 46 additions & 5 deletions servers/Azure.Mcp.Server/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,56 @@

The Azure MCP Server updates automatically by default whenever a new release comes out 🚀. We ship updates twice a week on Tuesdays and Thursdays 😊

## 0.9.10 (Unreleased)
## 1.0.0 (2025-10-27)
Comment thread
joshfree marked this conversation as resolved.

### Features Added
**🎉 First Stable Release**

### Breaking Changes
We're excited to announce the first stable release of the Azure MCP Server! This milestone represents months of development, extensive testing, and valuable feedback from our community. The Azure MCP Server provides seamless integration between AI agents and 40+ Azure services through the Model Context Protocol (MCP) specification.

### Bugs Fixed
### What's Included in 1.0.0

### Other Changes
The Azure MCP Server now offers:

- **Comprehensive Azure Service Coverage**: Support for 40+ Azure services including Storage, Key Vault, Cosmos DB, SQL, Kubernetes (AKS), AI Foundry, Event Hubs, Service Bus, PostgreSQL, MySQL, Redis, Azure Monitor, Application Insights, and many more
- **Multiple Installation Methods**: Available through NuGet, NPM, and Docker; or as an extension/plugin for VS Code, Visual Studio 2022, and IntelliJ IDEA.
- **Flexible Server Modes**:
- Namespace mode (default): Organizes tools by service for easy discovery
- Consolidated mode: Groups tools by tasks and actions for streamlined workflows
- Single mode: All tools behind one unified "azure" tool
- All mode: Exposes every tool individually for maximum control
- **Advanced Authentication**: Supports multiple Azure authentication methods with credential chaining
- **Production Ready**: Includes comprehensive error handling, retry policies, telemetry, and extensive test coverage
- **Developer Friendly**: Native AOT compilation support, read-only mode for safe exploration, and detailed documentation

### Key Features

- **170+ Azure Commands** across Storage, Databases, AI Services, Monitoring, and more
- **Enterprise Support**: Proxy configuration, managed identity authentication, and secure credential handling
- **Performance Optimizations**: Selective caching for expensive operations and efficient HTTP client management

### Getting Started

Install the Azure MCP Server from your preferred platform:

- **VS Code**: Install the [Azure MCP Server extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server)
- **Visual Studio 2022**: Install [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022)
- **IntelliJ IDEA**: Install [Azure Toolkit for IntelliJ](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij)
- **NuGet**: `dotnet tool install -g Azure.Mcp --version 1.0.0`
- **npm**: `npx @azure/mcp@1.0.0`
- **Docker**: `docker pull mcr.microsoft.com/azure-mcp:1.0.0`

### Documentation

- [Complete Command Reference](https://github.com/microsoft/mcp/blob/release/azure/1.x/servers/Azure.Mcp.Server/docs/azmcp-commands.md)
- [Authentication Guide](https://github.com/microsoft/mcp/blob/release/azure/1.x/docs/Authentication.md)
- [Troubleshooting](https://github.com/microsoft/mcp/blob/release/azure/1.x/servers/Azure.Mcp.Server/TROUBLESHOOTING.md)
- [Contributing Guidelines](https://github.com/microsoft/mcp/blob/release/azure/1.x/CONTRIBUTING.md)

### Thank You

This release wouldn't have been possible without the contributions from our community, extensive testing from early adopters, and collaboration with the MCP ecosystem. Thank you for your feedback, bug reports, and feature requests that helped shape this stable release.

For a complete history of pre-release changes, see versions [0.9.9](#099-2025-10-24) through [0.0.10](#0010-2025-04-17) below.

## 0.9.9 (2025-10-24)
Comment thread
vcolin7 marked this conversation as resolved.

Expand Down
35 changes: 32 additions & 3 deletions servers/Azure.Mcp.Server/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP

## Table of Contents
- [Overview](#overview)
- [Installation](#installation)<!-- remove-section: start nuget;vsix;npm remove_installatiion_sub_sections -->
- [Installation](#installation)<!-- remove-section: start nuget;vsix;npm remove_installation_sub_sections -->
- [IDE](#ide)
- [VS Code (Recommended)](#vs-code-recommended)
- [Visual Studio 2022](#visual-studio-2022)
Expand All @@ -24,7 +24,7 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
- [Package Manager](#package-manager)
- [NuGet](#nuget)
- [NPM](#npm)
- [Docker](#docker)<!-- remove-section: end remove_installatiion_sub_sections -->
- [Docker](#docker)<!-- remove-section: end remove_installation_sub_sections -->
- [Usage](#usage)
- [Getting Started](#getting-started)
- [What can you do with the Azure MCP Server?](#what-can-you-do-with-the-azure-mcp-server)
Expand All @@ -33,7 +33,12 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
- [Documentation](#documentation)
- [Feedback and Support](#feedback-and-support)
- [Security](#security)
- [Permissions and Risk](#permissions-and-risk)
- [Data Collection](#data-collection)
- [Compliance Responsibility](#compliance-responsibility)
- [Third Party Components](#third-party-components)
- [Export Control](#export-control)
- [No Warranty / Limitation of Liability](#no-warranty--limitation-of-liability)
- [Contributing](#contributing)
- [Code of Conduct](#code-of-conduct)

Expand Down Expand Up @@ -101,6 +106,8 @@ Start using Azure MCP with your favorite IDE. We recommend VS Code:
### VS Code (Recommended)
Compatible with both the [Stable](https://code.visualstudio.com/download) and [Insiders](https://code.visualstudio.com/insiders) builds of VS Code.

![Install Azure MCP Server Extension](images/install_azure_mcp_server_extension.gif)

1. Install the [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extension.
1. Install the [Azure MCP Server](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server) extension.
1. Sign in to Azure ([Command Palette](https://code.visualstudio.com/docs/getstarted/getting-started#_access-commands-with-the-command-palette): `Azure: Sign In`).
Expand Down Expand Up @@ -542,6 +549,12 @@ Your credentials are always handled securely through the official [Azure Identit

MCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Azure MCP Server, but any MCP client/agent that you choose to implement down to the model provider.

You should follow Microsoft security guidance for MCP servers, including enabling Entra ID authentication, secure token management, and network isolation. Refer to [Microsoft Security Documentation](https://learn.microsoft.com/azure/api-management/secure-mcp-servers) for details.

## Permissions and Risk

MCP clients can invoke operations based on the user’s Azure RBAC permissions. Autonomous or misconfigured clients may perform destructive actions. You should review and apply least-privilege RBAC roles and implement safeguards before deployment. Certain safeguards, such as flags to prevent destructive operations, are not standardized in the MCP specification and may not be supported by all clients.

## Data Collection

<!-- remove-section: start vsix remove_data_collection_section_content -->
Expand All @@ -557,6 +570,22 @@ Telemetry collection is on by default.
To opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false` in your environment.
<!-- remove-section: end remove_telemetry_config_section -->

## Compliance Responsibility

This MCP server may interact with clients and services outside Microsoft compliance boundaries. You are responsible for ensuring that any integration complies with applicable organizational, regulatory, and contractual requirements.

## Third Party Components

This MCP server may use or depend on third party components. You are responsible for reviewing and complying with the licenses and security posture of any third-party components.

## Export Control

Use of this software must comply with all applicable export laws and regulations, including U.S. Export Administration Regulations and local jurisdiction requirements.

## No Warranty / Limitation of Liability

This software is provided “as is” without warranties or conditions of any kind, either express or implied. Microsoft shall not be liable for any damages arising from use, misuse, or misconfiguration of this software.

## Contributing

We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
Expand All @@ -576,4 +605,4 @@ This project has adopted the
For more information, see the
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
or contact [open@microsoft.com](mailto:open@microsoft.com)
with any additional questions or comments.
with any additional questions or comments.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion servers/Azure.Mcp.Server/src/Azure.Mcp.Server.csproj
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<Version>0.9.10</Version>
<Version>1.0.0</Version>
<CliName>azmcp</CliName>
<AssemblyTitle>Azure MCP Server</AssemblyTitle>
<Description>Azure MCP Server - Model Context Protocol implementation for Azure</Description>
Expand Down
51 changes: 51 additions & 0 deletions servers/Azure.Mcp.Server/vscode/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,56 @@
# Release History

## 1.0.0 (2025-10-27)
Comment thread
vcolin7 marked this conversation as resolved.

**🎉 First Stable Release**

We're excited to announce the first stable release of the Azure MCP Server! This milestone represents months of development, extensive testing, and valuable feedback from our community. The Azure MCP Server provides seamless integration between AI agents and 40+ Azure services through the Model Context Protocol (MCP) specification.

### What's Included in 1.0.0

The Azure MCP Server now offers:

- **Comprehensive Azure Service Coverage**: Support for 40+ Azure services including Storage, Key Vault, Cosmos DB, SQL, Kubernetes (AKS), AI Foundry, Event Hubs, Service Bus, PostgreSQL, MySQL, Redis, Azure Monitor, Application Insights, and many more
- **Multiple Installation Methods**: Available through NuGet, NPM, and Docker; or as an extension/plugin for VS Code, Visual Studio 2022, and IntelliJ IDEA.
- **Flexible Server Modes**:
- Namespace mode (default): Organizes tools by service for easy discovery
- Consolidated mode: Groups tools by tasks and actions for streamlined workflows
- Single mode: All tools behind one unified "azure" tool
- All mode: Exposes every tool individually for maximum control
- **Advanced Authentication**: Supports multiple Azure authentication methods with credential chaining
- **Production Ready**: Includes comprehensive error handling, retry policies, telemetry, and extensive test coverage
- **Developer Friendly**: Native AOT compilation support, read-only mode for safe exploration, and detailed documentation

### Key Features

- **170+ Azure Commands** across Storage, Databases, AI Services, Monitoring, and more
- **Enterprise Support**: Proxy configuration, managed identity authentication, and secure credential handling
- **Performance Optimizations**: Selective caching for expensive operations and efficient HTTP client management

### Getting Started

Install the Azure MCP Server from your preferred platform:

- **VS Code**: Install the [Azure MCP Server extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server)
- **Visual Studio 2022**: Install [GitHub Copilot for Azure](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022)
- **IntelliJ IDEA**: Install [Azure Toolkit for IntelliJ](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij)
- **NuGet**: `dotnet tool install -g Azure.Mcp --version 1.0.0`
- **npm**: `npx @azure/mcp@1.0.0`
- **Docker**: `docker pull mcr.microsoft.com/azure-mcp:1.0.0`

### Documentation

- [Complete Command Reference](https://github.com/microsoft/mcp/blob/release/azure/1.x/servers/Azure.Mcp.Server/docs/azmcp-commands.md)
- [Authentication Guide](https://github.com/microsoft/mcp/blob/release/azure/1.x/docs/Authentication.md)
- [Troubleshooting](https://github.com/microsoft/mcp/blob/release/azure/1.x/servers/Azure.Mcp.Server/TROUBLESHOOTING.md)
- [Contributing Guidelines](https://github.com/microsoft/mcp/blob/release/azure/1.x/CONTRIBUTING.md)

### Thank You

This release wouldn't have been possible without the contributions from our community, extensive testing from early adopters, and collaboration with the MCP ecosystem. Thank you for your feedback, bug reports, and feature requests that helped shape this stable release.

For a complete history of pre-release changes, see versions [0.9.9](#099-2025-10-24) through [0.0.10](#0010-2025-04-17) below.

## 0.9.9 (2025-10-24)

### Other Changes
Expand Down