@azure/mcp 0.5.13 β 0.7.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 +69 -36
- package/package.json +7 -7
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
|
|
|
@@ -43,16 +67,22 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
43
67
|
* "List my App Configuration stores"
|
|
44
68
|
* "Show my key-value pairs in App Config"
|
|
45
69
|
|
|
70
|
+
### βοΈ Azure App Lens
|
|
71
|
+
|
|
72
|
+
* "Help me diagnose issues with my app"
|
|
73
|
+
|
|
46
74
|
### π¦ Azure Container Registry (ACR)
|
|
47
75
|
|
|
48
76
|
* "List all my Azure Container Registries"
|
|
49
|
-
* "Show me my container registries in the '
|
|
77
|
+
* "Show me my container registries in the 'my-resource-group' resource group"
|
|
50
78
|
* "List all my Azure Container Registry repositories"
|
|
51
79
|
|
|
52
80
|
### βΈοΈ Azure Kubernetes Service (AKS)
|
|
53
81
|
|
|
54
82
|
* "List my AKS clusters in my subscription"
|
|
55
83
|
* "Show me all my Azure Kubernetes Service clusters"
|
|
84
|
+
* "List the node pools for my AKS cluster"
|
|
85
|
+
* "Get details for the node pool 'np1' of my AKS cluster 'my-aks-cluster' in the 'my-resource-group' resource group"
|
|
56
86
|
|
|
57
87
|
### π Azure Cosmos DB
|
|
58
88
|
|
|
@@ -68,11 +98,11 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
68
98
|
|
|
69
99
|
* "List all Event Grid topics in subscription 'my-subscription'"
|
|
70
100
|
* "Show me the Event Grid topics in my subscription"
|
|
71
|
-
* "List all Event Grid topics in resource group 'my-
|
|
101
|
+
* "List all Event Grid topics in resource group 'my-resource-group' in my subscription"
|
|
72
102
|
|
|
73
103
|
### β‘ Azure Managed Lustre
|
|
74
104
|
|
|
75
|
-
* "List the Azure Managed Lustre clusters in resource group 'my-
|
|
105
|
+
* "List the Azure Managed Lustre clusters in resource group 'my-resource-group'"
|
|
76
106
|
* "How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?"
|
|
77
107
|
|
|
78
108
|
### π Azure Monitor
|
|
@@ -94,6 +124,9 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
94
124
|
* "Delete a firewall rule from my Azure SQL server 'myserver'"
|
|
95
125
|
* "List all elastic pools in my Azure SQL server 'myserver'"
|
|
96
126
|
* "List Active Directory administrators for my Azure SQL server 'myserver'"
|
|
127
|
+
* "Create a new Azure SQL server in my resource group 'my-resource-group'"
|
|
128
|
+
* "Show me details about my Azure SQL server 'myserver'"
|
|
129
|
+
* "Delete my Azure SQL server 'myserver'"
|
|
97
130
|
|
|
98
131
|
### πΎ Azure Storage
|
|
99
132
|
|
|
@@ -107,7 +140,8 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
107
140
|
* "List files and directories in my File Share"
|
|
108
141
|
* "Send a message to my storage queue"
|
|
109
142
|
|
|
110
|
-
|
|
143
|
+
|
|
144
|
+
## <a id="currently-supported-tools"></a> π οΈ Currently Supported Tools
|
|
111
145
|
|
|
112
146
|
<details>
|
|
113
147
|
<summary>The Azure MCP Server provides tools for interacting with the following Azure services</summary>
|
|
@@ -129,11 +163,6 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
129
163
|
|
|
130
164
|
* Get secure, production-grade Azure SDK best practices for effective code generation.
|
|
131
165
|
|
|
132
|
-
### π₯οΈ Azure CLI Extension
|
|
133
|
-
|
|
134
|
-
* Execute Azure CLI commands directly
|
|
135
|
-
* Support for all Azure CLI functionality
|
|
136
|
-
|
|
137
166
|
### π¦ Azure Container Registry (ACR)
|
|
138
167
|
|
|
139
168
|
* List Azure Container Registries and repositories in a subscription
|
|
@@ -169,12 +198,6 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
169
198
|
* List and get schema for tables.
|
|
170
199
|
* List, get configuration and get/set parameters for servers.
|
|
171
200
|
|
|
172
|
-
### π οΈ Azure Developer CLI (azd) Extension
|
|
173
|
-
|
|
174
|
-
* Execute Azure Developer CLI commands directly
|
|
175
|
-
* Support for template discovery, template initialization, provisioning and deployment
|
|
176
|
-
* Cross-platform compatibility
|
|
177
|
-
|
|
178
201
|
### π Azure Deploy
|
|
179
202
|
|
|
180
203
|
* Generate Azure service architecture diagrams from source code
|
|
@@ -210,6 +233,8 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
210
233
|
### βΈοΈ Azure Kubernetes Service (AKS)
|
|
211
234
|
|
|
212
235
|
* List Azure Kubernetes Service clusters
|
|
236
|
+
* List node pools in an AKS managed cluster
|
|
237
|
+
* Get details of a node pool in an AKS managed cluster
|
|
213
238
|
|
|
214
239
|
### π¦ Azure Load Testing
|
|
215
240
|
|
|
@@ -217,7 +242,6 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
217
242
|
* List, create load tests
|
|
218
243
|
* Get, list, (create) run and rerun, update load test runs
|
|
219
244
|
|
|
220
|
-
|
|
221
245
|
### π Azure Managed Grafana
|
|
222
246
|
|
|
223
247
|
* List Azure Managed Grafana
|
|
@@ -226,6 +250,7 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
226
250
|
|
|
227
251
|
* List Azure Managed Lustre filesystems
|
|
228
252
|
* Get the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem
|
|
253
|
+
* Get information of Azure Managed Lustre SKUs available in a specific Azure region
|
|
229
254
|
|
|
230
255
|
### πͺ Azure Marketplace
|
|
231
256
|
|
|
@@ -294,14 +319,11 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
294
319
|
* List SQL server firewall rules
|
|
295
320
|
* Create SQL server firewall rules
|
|
296
321
|
* Delete SQL server firewall rules
|
|
297
|
-
|
|
298
|
-
### ποΈ Azure SQL Elastic Pool
|
|
299
|
-
|
|
300
322
|
* List elastic pools in SQL servers
|
|
301
|
-
|
|
302
|
-
### ποΈ Azure SQL Server
|
|
303
|
-
|
|
304
323
|
* List Microsoft Entra ID administrators for SQL servers
|
|
324
|
+
* Create new SQL servers
|
|
325
|
+
* Show details and properties of SQL servers
|
|
326
|
+
* Delete SQL servers
|
|
305
327
|
|
|
306
328
|
### πΎ Azure Storage
|
|
307
329
|
|
|
@@ -350,7 +372,7 @@ Agents and models can discover and learn best practices and usage guidelines for
|
|
|
350
372
|
|
|
351
373
|
For detailed command documentation and examples, see [Azure MCP Commands](https://github.com/microsoft/mcp/blob/main/docs/azmcp-commands.md).
|
|
352
374
|
|
|
353
|
-
## ποΈ Upgrading
|
|
375
|
+
## <a id="upgrading"></a> ποΈ Upgrading
|
|
354
376
|
|
|
355
377
|
<details>
|
|
356
378
|
<summary>How to stay current with releases of Azure MCP Server</summary>
|
|
@@ -361,7 +383,7 @@ If you use the default package spec of `@azure/mcp@latest`, npx will look for a
|
|
|
361
383
|
|
|
362
384
|
#### NPM
|
|
363
385
|
|
|
364
|
-
If you globally install the
|
|
386
|
+
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`.
|
|
365
387
|
|
|
366
388
|
#### Docker
|
|
367
389
|
|
|
@@ -370,9 +392,15 @@ There is no version update built into the docker image. To update, just pull th
|
|
|
370
392
|
#### VS Code
|
|
371
393
|
|
|
372
394
|
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.
|
|
395
|
+
|
|
396
|
+
#### IntelliJ
|
|
397
|
+
|
|
398
|
+
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.
|
|
399
|
+
|
|
373
400
|
</details>
|
|
374
401
|
|
|
375
|
-
|
|
402
|
+
|
|
403
|
+
## <a id="advanced-install-scenarios-optional"></a> βοΈ Advanced Install Scenarios (Optional)
|
|
376
404
|
|
|
377
405
|
<details>
|
|
378
406
|
<summary>Docker containers, custom MCP clients, and manual install options</summary>
|
|
@@ -468,7 +496,8 @@ For a step-by-step installation, follow these instructions:
|
|
|
468
496
|
More end-to-end MCP client/agent guides are coming soon!
|
|
469
497
|
</details>
|
|
470
498
|
|
|
471
|
-
|
|
499
|
+
|
|
500
|
+
## <a id="data-collection"></a> Data Collection
|
|
472
501
|
|
|
473
502
|
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
503
|
|
|
@@ -478,7 +507,8 @@ Telemetry collection is on by default.
|
|
|
478
507
|
|
|
479
508
|
To opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false` in your environment.
|
|
480
509
|
|
|
481
|
-
|
|
510
|
+
|
|
511
|
+
## <a id="troubleshooting"></a> π Troubleshooting
|
|
482
512
|
|
|
483
513
|
See [Troubleshooting guide](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
484
514
|
|
|
@@ -494,13 +524,15 @@ If you're running into any issues with authentication, visit our [troubleshootin
|
|
|
494
524
|
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
525
|
</details>
|
|
496
526
|
|
|
497
|
-
## π‘οΈ Security Note
|
|
527
|
+
## <a id="security-note"></a> π‘οΈ Security Note
|
|
498
528
|
|
|
499
529
|
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
530
|
|
|
501
531
|
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
532
|
|
|
503
|
-
|
|
533
|
+
|
|
534
|
+
|
|
535
|
+
## <a id="contributing"></a> π₯ Contributing
|
|
504
536
|
|
|
505
537
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
506
538
|
|
|
@@ -511,7 +543,8 @@ Please read our [Contributing Guide](https://github.com/microsoft/mcp/blob/main/
|
|
|
511
543
|
* π Code style and testing requirements
|
|
512
544
|
* π Making pull requests
|
|
513
545
|
|
|
514
|
-
|
|
546
|
+
|
|
547
|
+
## <a id="code-of-conduct"></a> π€ Code of Conduct
|
|
515
548
|
|
|
516
549
|
This project has adopted the
|
|
517
550
|
[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.7.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",
|
|
@@ -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.7.0",
|
|
37
|
+
"@azure/mcp-linux-x64": "0.7.0",
|
|
38
|
+
"@azure/mcp-darwin-arm64": "0.7.0",
|
|
39
|
+
"@azure/mcp-darwin-x64": "0.7.0",
|
|
40
|
+
"@azure/mcp-win32-arm64": "0.7.0",
|
|
41
|
+
"@azure/mcp-win32-x64": "0.7.0"
|
|
42
42
|
},
|
|
43
43
|
"scripts": {
|
|
44
44
|
"postinstall": "node ./scripts/post-install-script.js"
|