@azure/mcp 0.5.13 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -14
- package/package.json +9 -9
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# <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
|
|
2
2
|
|
|
3
3
|
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.
|
|
4
4
|
|
|
@@ -9,7 +9,24 @@ The Azure MCP Server implements the [MCP specification](https://modelcontextprot
|
|
|
9
9
|
> SSE was deprecated in MCP `2025-03-26` due to [security vulnerabilities and architectural limitations](https://blog.fka.dev/blog/2025-06-06-why-mcp-deprecated-sse-and-go-with-streamable-http/). Users must discontinue use of SSE transport mode and upgrade to version `0.4.0` or newer to maintain compatibility with current MCP clients.
|
|
10
10
|
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
## Table of Contents
|
|
13
|
+
- Install
|
|
14
|
+
- [VS Code Install Guide (Recommended)](#vs-code-install-guide-recommended)
|
|
15
|
+
- [IntelliJ Install Guide](#intellij-install-guide)
|
|
16
|
+
- [Advanced Install Scenarios (Optional)](#advanced-install-scenarios-optional)
|
|
17
|
+
- [Upgrading](#upgrading)
|
|
18
|
+
- Usage
|
|
19
|
+
- [Quick Start](#quick-start)
|
|
20
|
+
- [What can you do with the Azure MCP Server?](#what-can-you-do-with-the-azure-mcp-server)
|
|
21
|
+
- [Currently Supported Tools](#currently-supported-tools)
|
|
22
|
+
- Support & Reference
|
|
23
|
+
- [Data Collection](#data-collection)
|
|
24
|
+
- [Troubleshooting](#troubleshooting)
|
|
25
|
+
- [Security Note](#security-note)
|
|
26
|
+
- [Contributing](#contributing)
|
|
27
|
+
- [Code of Conduct](#code-of-conduct)
|
|
28
|
+
|
|
29
|
+
## <a id="vs-code-install-guide-recommended"></a>✅ VS Code Install Guide (Recommended)
|
|
13
30
|
|
|
14
31
|
1. Install either the stable or Insiders release of VS Code:
|
|
15
32
|
* [💫 Stable release](https://code.visualstudio.com/download)
|
|
@@ -17,9 +34,17 @@ The Azure MCP Server implements the [MCP specification](https://modelcontextprot
|
|
|
17
34
|
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
|
|
18
35
|
1. Install the [Azure MCP Server](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server) extension
|
|
19
36
|
|
|
20
|
-
### 🚀 Quick Start
|
|
21
37
|
|
|
22
|
-
|
|
38
|
+
## <a id="intellij-install-guide"></a> IntelliJ Install Guide
|
|
39
|
+
|
|
40
|
+
1. Install either the [IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download) or [IntelliJ IDEA Community](https://www.jetbrains.com/idea/download) edition.
|
|
41
|
+
1. Install the [GitHub Copilot](https://plugins.jetbrains.com/plugin/17718-github-copilot) plugin.
|
|
42
|
+
1. Install the [Azure Toolkit for Intellij](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij) plugin.
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
## <a id="quick-start"></a> 🚀 Quick Start
|
|
46
|
+
|
|
47
|
+
1. Open GitHub Copilot in [VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) or [IntelliJ](https://github.blog/changelog/2025-05-19-agent-mode-and-mcp-support-for-copilot-in-jetbrains-eclipse-and-xcode-now-in-public-preview/#agent-mode) and switch to Agent mode.
|
|
23
48
|
1. Click `refresh` on the tools list
|
|
24
49
|
- You should see the Azure MCP Server in the list of tools
|
|
25
50
|
1. Try a prompt that tells the agent to use the Azure MCP Server, such as `List my Azure Storage containers`
|
|
@@ -28,8 +53,7 @@ The Azure MCP Server implements the [MCP specification](https://modelcontextprot
|
|
|
28
53
|
1. We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server
|
|
29
54
|
- 👉 [Open an issue in the public repository](https://github.com/microsoft/mcp/issues/new/choose)
|
|
30
55
|
|
|
31
|
-
|
|
32
|
-
## ✨ What can you do with the Azure MCP Server?
|
|
56
|
+
## <a id="what-can-you-do-with-the-azure-mcp-server"></a> ✨ What can you do with the Azure MCP Server?
|
|
33
57
|
|
|
34
58
|
The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
|
|
35
59
|
|
|
@@ -53,6 +77,7 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
53
77
|
|
|
54
78
|
* "List my AKS clusters in my subscription"
|
|
55
79
|
* "Show me all my Azure Kubernetes Service clusters"
|
|
80
|
+
* "List the node pools for my AKS cluster"
|
|
56
81
|
|
|
57
82
|
### 📊 Azure Cosmos DB
|
|
58
83
|
|
|
@@ -107,7 +132,8 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
107
132
|
* "List files and directories in my File Share"
|
|
108
133
|
* "Send a message to my storage queue"
|
|
109
134
|
|
|
110
|
-
|
|
135
|
+
|
|
136
|
+
## <a id="currently-supported-tools"></a> 🛠️ Currently Supported Tools
|
|
111
137
|
|
|
112
138
|
<details>
|
|
113
139
|
<summary>The Azure MCP Server provides tools for interacting with the following Azure services</summary>
|
|
@@ -350,7 +376,7 @@ Agents and models can discover and learn best practices and usage guidelines for
|
|
|
350
376
|
|
|
351
377
|
For detailed command documentation and examples, see [Azure MCP Commands](https://github.com/microsoft/mcp/blob/main/docs/azmcp-commands.md).
|
|
352
378
|
|
|
353
|
-
## 🔄️ Upgrading
|
|
379
|
+
## <a id="upgrading"></a> 🔄️ Upgrading
|
|
354
380
|
|
|
355
381
|
<details>
|
|
356
382
|
<summary>How to stay current with releases of Azure MCP Server</summary>
|
|
@@ -370,9 +396,15 @@ There is no version update built into the docker image. To update, just pull th
|
|
|
370
396
|
#### VS Code
|
|
371
397
|
|
|
372
398
|
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.
|
|
399
|
+
|
|
400
|
+
#### IntelliJ
|
|
401
|
+
|
|
402
|
+
If the Azure MCP server is configured by Azure Toolkit for IntelliJ plugin, the version is automatically updated to the latest version when the IntelliJ project starts. If the Azure MCP server is manually configured with `npx` command and `-y @azure/mcp@latest` args, npx will check for package updates each time IntelliJ starts the server. Using a docker container in IntelliJ has the same no-update limitation described above.
|
|
403
|
+
|
|
373
404
|
</details>
|
|
374
405
|
|
|
375
|
-
|
|
406
|
+
|
|
407
|
+
## <a id="advanced-install-scenarios-optional"></a> ⚙️ Advanced Install Scenarios (Optional)
|
|
376
408
|
|
|
377
409
|
<details>
|
|
378
410
|
<summary>Docker containers, custom MCP clients, and manual install options</summary>
|
|
@@ -468,7 +500,8 @@ For a step-by-step installation, follow these instructions:
|
|
|
468
500
|
More end-to-end MCP client/agent guides are coming soon!
|
|
469
501
|
</details>
|
|
470
502
|
|
|
471
|
-
|
|
503
|
+
|
|
504
|
+
## <a id="data-collection"></a> Data Collection
|
|
472
505
|
|
|
473
506
|
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's [privacy statement](https://www.microsoft.com/privacy/privacystatement). You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
|
|
474
507
|
|
|
@@ -478,7 +511,8 @@ Telemetry collection is on by default.
|
|
|
478
511
|
|
|
479
512
|
To opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false` in your environment.
|
|
480
513
|
|
|
481
|
-
|
|
514
|
+
|
|
515
|
+
## <a id="troubleshooting"></a> 📝 Troubleshooting
|
|
482
516
|
|
|
483
517
|
See [Troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
484
518
|
|
|
@@ -494,13 +528,15 @@ If you're running into any issues with authentication, visit our [troubleshootin
|
|
|
494
528
|
For enterprise authentication scenarios, including network restrictions, security policies, and protected resources, see [Authentication Scenarios in Enterprise Environments](https://github.com/microsoft/mcp/blob/main/docs/Authentication.md#authentication-scenarios-in-enterprise-environments).
|
|
495
529
|
</details>
|
|
496
530
|
|
|
497
|
-
## 🛡️ Security Note
|
|
531
|
+
## <a id="security-note"></a> 🛡️ Security Note
|
|
498
532
|
|
|
499
533
|
Your credentials are always handled securely through the official [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) - **we never store or manage tokens directly**.
|
|
500
534
|
|
|
501
535
|
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.
|
|
502
536
|
|
|
503
|
-
|
|
537
|
+
|
|
538
|
+
|
|
539
|
+
## <a id="contributing"></a> 👥 Contributing
|
|
504
540
|
|
|
505
541
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
506
542
|
|
|
@@ -511,7 +547,8 @@ Please read our [Contributing Guide](https://github.com/microsoft/mcp/blob/main/
|
|
|
511
547
|
* 📝 Code style and testing requirements
|
|
512
548
|
* 🔄 Making pull requests
|
|
513
549
|
|
|
514
|
-
|
|
550
|
+
|
|
551
|
+
## <a id="code-of-conduct"></a> 🤝 Code of Conduct
|
|
515
552
|
|
|
516
553
|
This project has adopted the
|
|
517
554
|
[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Azure MCP Server - Model Context Protocol implementation for Azure",
|
|
5
5
|
"author": "Microsoft",
|
|
6
6
|
"homepage": "https://github.com/Microsoft/mcp/blob/main/servers/Azure.Mcp.Server#readme",
|
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
"url": "https://github.com/microsoft/mcp/issues"
|
|
15
15
|
},
|
|
16
16
|
"repository": {
|
|
17
|
-
"
|
|
18
|
-
"
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "https://github.com/microsoft/mcp.git"
|
|
19
19
|
},
|
|
20
20
|
"engines": {
|
|
21
21
|
"node": ">=20.0.0"
|
|
@@ -33,12 +33,12 @@
|
|
|
33
33
|
"x64"
|
|
34
34
|
],
|
|
35
35
|
"optionalDependencies": {
|
|
36
|
-
"@azure/mcp-linux-arm64": "0.
|
|
37
|
-
"@azure/mcp-linux-x64": "0.
|
|
38
|
-
"@azure/mcp-darwin-arm64": "0.
|
|
39
|
-
"@azure/mcp-darwin-x64": "0.
|
|
40
|
-
"@azure/mcp-win32-arm64": "0.
|
|
41
|
-
"@azure/mcp-win32-x64": "0.
|
|
36
|
+
"@azure/mcp-linux-arm64": "0.6.0",
|
|
37
|
+
"@azure/mcp-linux-x64": "0.6.0",
|
|
38
|
+
"@azure/mcp-darwin-arm64": "0.6.0",
|
|
39
|
+
"@azure/mcp-darwin-x64": "0.6.0",
|
|
40
|
+
"@azure/mcp-win32-arm64": "0.6.0",
|
|
41
|
+
"@azure/mcp-win32-x64": "0.6.0"
|
|
42
42
|
},
|
|
43
43
|
"scripts": {
|
|
44
44
|
"postinstall": "node ./scripts/post-install-script.js"
|