You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Sep 4, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+45-6Lines changed: 45 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,12 +13,30 @@ Here's a short (16 seconds) video to help you get the Azure MCP Server installed
13
13
3. Install [Node.js](https://nodejs.org/en/download) 20 or later
14
14
* Ensure `node` and `npm` are in your path
15
15
4. Open VS Code in an empty folder
16
-
5. Install Azure MCP Server for either the stable or Insiders release of VS Code:
17
-
*[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D)
18
-
*[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D&quality=insiders)
16
+
5. Install any of the available Azure MCP Server(s) for either the stable or Insiders release of VS Code
19
17
6. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
20
18
7. Click `refresh` on the tools list.
21
19
20
+
#### 🤖 Available Azure MCP Servers
21
+
22
+
| Name | Description | VS Code | VS Code Insiders |
| All | All Azure tools in a single MCP server |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D&quality=insiders)|
25
+
| Best Practices | Returns secure, production-grade Azure SDK best practices. |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Best%20Practices&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22bestpractices%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Best%20Practices&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22bestpractices%22%5D%7D&quality=insiders)|
26
+
| Cosmos DB | Cosmos DB operations - Manage/query Cosmos DB resources. |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Cosmos&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22cosmos%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Cosmos&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22cosmos%22%5D%7D&quality=insiders)|
27
+
| Kusto | Kusto operations - Manage/query Azure Data Explorer clusters. |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Kusto&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22kusto%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Kusto&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22kusto%22%5D%7D&quality=insiders)|
| Resource Group | Resource group operations - List/manage Azure resource groups. |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Resource%20Group&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22group%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Resource%20Group&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22group%22%5D%7D&quality=insiders)|
36
+
| Service Bus | Service Bus operations - Manage Azure Service Bus resources. |[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Service%20Bus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22servicebus%22%5D%7D)|[](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Service%20Bus&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%2C%22--service%22%2C%22servicebus%22%5D%7D&quality=insiders)|
1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
@@ -92,7 +110,7 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
92
110
- List and query Storage tables
93
111
- Get container properties and metadata
94
112
95
-
### 📈 Azure Monitor
113
+
### 📈 Azure Monitor
96
114
#### Log Analytics
97
115
- List Log Analytics workspaces
98
116
- Query logs using KQL
@@ -139,7 +157,7 @@ For detailed command documentation and examples, see [Azure MCP Commands](https:
139
157
140
158
<details>
141
159
<summary>How to stay current with releases of Azure MCP Server</summary>
142
-
160
+
143
161
#### NPX
144
162
145
163
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.
1. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
193
+
4. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
176
194
```json
177
195
{
178
196
"servers": {
@@ -216,6 +234,27 @@ For a step-by-step installation, follow these instructions:
216
234
}
217
235
```
218
236
237
+
You can optionally set the `--service <service>` flag to install tools for the specified Azure product or service.
238
+
239
+
1. Add `.vscode/mcp.json`:
240
+
```json
241
+
{
242
+
"servers": {
243
+
"Azure Best Practices": {
244
+
"command": "npx",
245
+
"args": [
246
+
"-y",
247
+
"@azure/mcp@latest",
248
+
"server",
249
+
"start",
250
+
"--service",
251
+
"bestpractices"// Any of the available MCP servers can be referenced here.
252
+
]
253
+
}
254
+
}
255
+
}
256
+
```
257
+
219
258
### Using standard IO
220
259
221
260
Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. For instructions on using , follow instructions in [Quick install with VS Code](#-quick-install-with-vs-code) or [Manual Install](#-manual-install).
0 commit comments