@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.
Files changed (2) hide show
  1. package/README.md +69 -36
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # 🌟 Azure MCP Server
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
- ### βœ… VS Code Install Guide (Recommended)
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
- 1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
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 'myproject' resource group"
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-resourcegroup' in my subscription"
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-resourcegroup'"
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
- ## πŸ› οΈ Currently Supported Tools
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 Existing Installs to the Latest Version
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 cli via `npm install -g @azure/mcp` it will use the installed version until you manually update it with `npm update -g @azure/mcp`.
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
- ## βš™οΈ Advanced Install Scenarios (Optional)
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
- ## Data Collection
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
- ## πŸ“ Troubleshooting
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
- ## πŸ‘₯ Contributing
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
- ## 🀝 Code of Conduct
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.5.13",
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.5.13",
37
- "@azure/mcp-linux-x64": "0.5.13",
38
- "@azure/mcp-darwin-arm64": "0.5.13",
39
- "@azure/mcp-darwin-x64": "0.5.13",
40
- "@azure/mcp-win32-arm64": "0.5.13",
41
- "@azure/mcp-win32-x64": "0.5.13"
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"