@azure/mcp-win32-arm64 0.2.0 โ 0.2.1
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 +112 -101
- package/dist/Humanizer.dll +0 -0
- package/dist/Json.More.dll +0 -0
- package/dist/JsonPointer.Net.dll +0 -0
- package/dist/JsonSchema.Net.dll +0 -0
- package/dist/azmcp.deps.json +70 -2
- package/dist/azmcp.dll +0 -0
- package/dist/azmcp.exe +0 -0
- package/dist/createdump.exe +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,24 +1,51 @@
|
|
|
1
1
|
# ๐ Azure MCP Server
|
|
2
2
|
|
|
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.
|
|
3
4
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
The Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and key Azure services like Azure Storage, Cosmos DB, and more.
|
|
7
|
-
|
|
8
|
-
> Please note that this project is in Public Preview and implementation may significantly change prior to our General Availability.
|
|
9
|
-
|
|
10
|
-
## ๐ Table of contents
|
|
11
|
-
1. [๐ฏ Overview](#-overview)
|
|
12
|
-
2. [๐ ๏ธ Currently Supported Tools](#%EF%B8%8F-currently-supported-tools)
|
|
13
|
-
3. [๐ Installation & Getting Started](#-getting-started)
|
|
14
|
-
4. [๐งช Using Azure MCP Server](#-test-the-azure-mcp-server)
|
|
15
|
-
5. [๐ Troubleshooting Issues](#-troubleshooting)
|
|
16
|
-
6. [๐ฅ Contributing to Azure MCP Server](#-contributing)
|
|
17
|
-
|
|
5
|
+
Here's a short (16 seconds) video to help you get the Azure MCP Server installed in VS Code.
|
|
6
|
+
<video src="https://github.com/user-attachments/assets/535f393c-0ed2-479d-9b24-5ca933293c92" width="1080" height="1920" controls></video>
|
|
18
7
|
|
|
19
|
-
|
|
8
|
+
### โ๏ธ VS Code Install Steps (Recommended)
|
|
9
|
+
1. Install either the stable or Insiders release of VS Code:
|
|
10
|
+
* [๐ซ Stable release](https://code.visualstudio.com/download)
|
|
11
|
+
* [๐ฎ Insiders release](https://code.visualstudio.com/insiders)
|
|
12
|
+
2. 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
|
|
13
|
+
3. Install [Node.js](https://nodejs.org/en/download) 20 or later
|
|
14
|
+
* Ensure `node` and `npm` are in your path
|
|
15
|
+
4. Open VS Code in an empty folder
|
|
16
|
+
5. Install any of the available Azure MCP Server(s) for either the stable or Insiders release of VS Code
|
|
17
|
+
6. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
|
|
18
|
+
7. Click `refresh` on the tools list.
|
|
19
|
+
|
|
20
|
+
#### ๐ค Available Azure MCP Servers
|
|
21
|
+
|
|
22
|
+
| Name | Description | VS Code | VS Code Insiders |
|
|
23
|
+
|--------------|-----------------------------------------------------------------------------------------------|---------|------------------|
|
|
24
|
+
| 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) |
|
|
28
|
+
| Storage | Storage operations - Manage/access Azure Storage resources. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Storage&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%22storage%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Storage&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%22storage%22%5D%7D&quality=insiders) |
|
|
29
|
+
| Monitor | Azure Monitor operations - Query/analyze logs and metrics. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Monitor&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%22monitor%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Monitor&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%22monitor%22%5D%7D&quality=insiders) |
|
|
30
|
+
| App Configuration | App Configuration operations - Manage App Configuration stores. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20App%20Config&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%22appconfig%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20App%20Config&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%22appconfig%22%5D%7D&quality=insiders) |
|
|
31
|
+
| Search | Search operations - Manage/list Azure AI Search services. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Search&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%22search%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Search&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%22search%22%5D%7D&quality=insiders) |
|
|
32
|
+
| PostgreSQL | PostgreSQL operations - Manage Azure Database for PostgreSQL - Flexible server. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20PostgreSQL&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%22postgres%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20PostgreSQL&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%22postgres%22%5D%7D&quality=insiders) |
|
|
33
|
+
| Key Vault | Key Vault operations - Manage/access Azure Key Vault resources. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Key%20Vault&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%22keyvault%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Key%20Vault&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%22keyvault%22%5D%7D&quality=insiders) |
|
|
34
|
+
| Subscription | Azure subscription operations - List/manage Azure subscriptions. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Subscription&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%22subscription%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Subscription&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%22subscription%22%5D%7D&quality=insiders) |
|
|
35
|
+
| 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) |
|
|
37
|
+
| Redis Cache | Redis Cache operations - Manage/access Azure Redis Cache resources. | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Redis%20Cache&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%22redis%22%5D%7D) | [](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20Redis%20Cache&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%22redis%22%5D%7D&quality=insiders) |
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
### โถ๏ธ Getting Started
|
|
42
|
+
1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
|
|
43
|
+
2. You should see the Azure MCP Server in the list of tools
|
|
44
|
+
3. Try a prompt that tells the agent to use the Azure MCP Server, such as "List my Azure Storage containers"
|
|
45
|
+
4. The agent should be able to use the Azure MCP Server tools to complete your query
|
|
46
|
+
5. For help with common issues see [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md).
|
|
20
47
|
|
|
21
|
-
|
|
48
|
+
## โจ What can you do with the Azure MCP Server?
|
|
22
49
|
|
|
23
50
|
The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
|
|
24
51
|
|
|
@@ -48,18 +75,10 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
|
|
|
48
75
|
- "List my Azure CDN endpoints"
|
|
49
76
|
- "Help me build an Azure application using Node.js"
|
|
50
77
|
|
|
51
|
-
### ๐ How It Works
|
|
52
|
-
|
|
53
|
-
The Azure MCP Server creates a seamless integration between AI agents and Azure services through:
|
|
54
|
-
|
|
55
|
-
- ๐ Smart JSON communication that AI agents understand
|
|
56
|
-
- ๐๏ธ Natural language commands that get translated to Azure operations
|
|
57
|
-
- ๐ก Intelligent parameter suggestions and auto-completion
|
|
58
|
-
- โก Consistent error handling that makes sense
|
|
59
78
|
|
|
60
79
|
## ๐ ๏ธ Currently Supported Tools
|
|
61
|
-
|
|
62
|
-
The Azure MCP Server provides tools for interacting with the following Azure services
|
|
80
|
+
<details>
|
|
81
|
+
<summary>The Azure MCP Server provides tools for interacting with the following Azure services</summary>
|
|
63
82
|
|
|
64
83
|
### ๐ Azure AI Search (search engine/vector database)
|
|
65
84
|
- List Azure AI Search services
|
|
@@ -91,7 +110,7 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
|
|
|
91
110
|
- List and query Storage tables
|
|
92
111
|
- Get container properties and metadata
|
|
93
112
|
|
|
94
|
-
### ๐ Azure Monitor
|
|
113
|
+
### ๐ Azure Monitor
|
|
95
114
|
#### Log Analytics
|
|
96
115
|
- List Log Analytics workspaces
|
|
97
116
|
- Query logs using KQL
|
|
@@ -130,46 +149,72 @@ Agents and models can discover and learn best practices and usage guidelines for
|
|
|
130
149
|
|
|
131
150
|
### ๐ก๏ธ Azure Best Practices
|
|
132
151
|
- Get secure, production-grade Azure SDK best practices for effective code generation.
|
|
152
|
+
</details>
|
|
133
153
|
|
|
134
154
|
For detailed command documentation and examples, see [Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md).
|
|
135
155
|
|
|
136
|
-
##
|
|
156
|
+
## ๐๏ธ Upgrading Existing Installs to the Latest Version
|
|
137
157
|
|
|
138
|
-
|
|
158
|
+
<details>
|
|
159
|
+
<summary>How to stay current with releases of Azure MCP Server</summary>
|
|
139
160
|
|
|
140
|
-
|
|
161
|
+
#### NPX
|
|
141
162
|
|
|
142
|
-
|
|
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.
|
|
143
164
|
|
|
144
|
-
|
|
145
|
-
1. Install either the stable or Insiders release of VS Code:
|
|
146
|
-
* [๐ซ Stable release](https://code.visualstudio.com/download)
|
|
147
|
-
* [๐ฎ Insiders release](https://code.visualstudio.com/insiders)
|
|
148
|
-
2. 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
|
|
149
|
-
3. Install [Node.js](https://nodejs.org/en/download) 20 or later
|
|
150
|
-
* Ensure `node` and `npm` are in your path
|
|
151
|
-
4. Open VS Code in an empty folder
|
|
165
|
+
#### NPM
|
|
152
166
|
|
|
153
|
-
|
|
167
|
+
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`.
|
|
154
168
|
|
|
155
|
-
####
|
|
169
|
+
#### Docker
|
|
156
170
|
|
|
157
|
-
|
|
171
|
+
There is no version update built into the docker image. To update, just pull the latest from the repo and repeat the [docker installation instructions](#docker-install).
|
|
158
172
|
|
|
159
|
-
|
|
173
|
+
#### VS Code
|
|
160
174
|
|
|
161
|
-
|
|
175
|
+
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.
|
|
176
|
+
</details>
|
|
162
177
|
|
|
163
|
-
|
|
178
|
+
## โ๏ธ Advanced Install Scenarios (Optional)
|
|
179
|
+
<details>
|
|
180
|
+
<summary>Docker containers, custom MCP clients, and manual install options</summary>
|
|
164
181
|
|
|
165
|
-
|
|
182
|
+
#### ๐ Docker Install Steps (Optional)
|
|
183
|
+
For a step-by-step Docker installation, follow these instructions:
|
|
166
184
|
|
|
167
|
-
|
|
185
|
+
1. Clone repository
|
|
186
|
+
2. From repository root, build Docker image: `docker build -t azure/azuremcp .`
|
|
187
|
+
3. Create an `.env` file with environment variables that [match one of the `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) sets. For example, a `.env` file using a service principal could look like:
|
|
188
|
+
```json
|
|
189
|
+
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
|
|
190
|
+
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
|
|
191
|
+
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
192
|
+
```
|
|
193
|
+
4. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
|
|
194
|
+
```json
|
|
195
|
+
{
|
|
196
|
+
"servers": {
|
|
197
|
+
"Azure MCP Server": {
|
|
198
|
+
"command": "docker",
|
|
199
|
+
"args": [
|
|
200
|
+
"run",
|
|
201
|
+
"-i",
|
|
202
|
+
"--rm",
|
|
203
|
+
"--env-file",
|
|
204
|
+
"/full/path/to/.env"
|
|
205
|
+
"azure/azuremcp",
|
|
206
|
+
]
|
|
207
|
+
}
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
```
|
|
168
211
|
|
|
169
|
-
|
|
212
|
+
Optionally, customers can use `--env` or `--volume` to pass authentication values.
|
|
170
213
|
|
|
171
|
-
####
|
|
214
|
+
#### ๐ค Custom MCP Client Install Steps (Optional)
|
|
215
|
+
You can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO or SSE.
|
|
172
216
|
|
|
217
|
+
#### ๐ง Manual Install Steps (Optional)
|
|
173
218
|
For a step-by-step installation, follow these instructions:
|
|
174
219
|
|
|
175
220
|
1. Add `.vscode/mcp.json`:
|
|
@@ -189,67 +234,27 @@ For a step-by-step installation, follow these instructions:
|
|
|
189
234
|
}
|
|
190
235
|
```
|
|
191
236
|
|
|
192
|
-
|
|
237
|
+
You can optionally set the `--service <service>` flag to install tools for the specified Azure product or service.
|
|
193
238
|
|
|
194
|
-
|
|
195
|
-
1. Clone repository
|
|
196
|
-
2. From repository root, build Docker image: `docker build -t azure/azuremcp .`
|
|
197
|
-
3. Create an `.env` file with environment variables that [match one of the `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) sets. For example, a `.env` file using a service principal could look like:
|
|
198
|
-
```json
|
|
199
|
-
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
|
|
200
|
-
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
|
|
201
|
-
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
202
|
-
```
|
|
203
|
-
1. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
|
|
239
|
+
1. Add `.vscode/mcp.json`:
|
|
204
240
|
```json
|
|
205
241
|
{
|
|
206
242
|
"servers": {
|
|
207
|
-
"Azure
|
|
208
|
-
"command": "
|
|
243
|
+
"Azure Best Practices": {
|
|
244
|
+
"command": "npx",
|
|
209
245
|
"args": [
|
|
210
|
-
"
|
|
211
|
-
"
|
|
212
|
-
"
|
|
213
|
-
"
|
|
214
|
-
"--
|
|
215
|
-
"
|
|
246
|
+
"-y",
|
|
247
|
+
"@azure/mcp@latest",
|
|
248
|
+
"server",
|
|
249
|
+
"start",
|
|
250
|
+
"--service",
|
|
251
|
+
"bestpractices" // Any of the available MCP servers can be referenced here.
|
|
216
252
|
]
|
|
217
253
|
}
|
|
218
254
|
}
|
|
219
255
|
}
|
|
220
256
|
```
|
|
221
257
|
|
|
222
|
-
Optionally, customers can use `--env` or `--volume` to pass authentication values.
|
|
223
|
-
|
|
224
|
-
### ๐๏ธ Updates
|
|
225
|
-
|
|
226
|
-
#### NPX
|
|
227
|
-
|
|
228
|
-
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.
|
|
229
|
-
|
|
230
|
-
#### NPM
|
|
231
|
-
|
|
232
|
-
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`.
|
|
233
|
-
|
|
234
|
-
#### Docker
|
|
235
|
-
|
|
236
|
-
There is no version update built into the docker image. To update, just pull the latest from the repo and repeat the [docker installation instructions](#docker-install).
|
|
237
|
-
|
|
238
|
-
#### VS Code
|
|
239
|
-
|
|
240
|
-
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.
|
|
241
|
-
|
|
242
|
-
## ๐งช Test the Azure MCP Server
|
|
243
|
-
|
|
244
|
-
1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
|
|
245
|
-
2. You should see the Azure MCP Server in the list of tools
|
|
246
|
-
3. Try a prompt that tells the agent to use the Azure MCP Server, such as "List my Azure Storage containers"
|
|
247
|
-
4. The agent should be able to use the Azure MCP Server tools to complete your query
|
|
248
|
-
|
|
249
|
-
## ๐ค Custom MCP Clients
|
|
250
|
-
|
|
251
|
-
You can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO or SSE.
|
|
252
|
-
|
|
253
258
|
### Using standard IO
|
|
254
259
|
|
|
255
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).
|
|
@@ -272,12 +277,18 @@ Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. Fo
|
|
|
272
277
|
|
|
273
278
|
|
|
274
279
|
More end-to-end MCP client/agent guides are coming soon!
|
|
280
|
+
</details>
|
|
281
|
+
|
|
282
|
+
|
|
275
283
|
|
|
276
284
|
## ๐ Troubleshooting
|
|
277
285
|
|
|
278
286
|
See [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
279
287
|
|
|
280
|
-
|
|
288
|
+
### ๐ Authentication
|
|
289
|
+
|
|
290
|
+
<details>
|
|
291
|
+
<summary>We use Azure Identity SDK under the hood via DefaultAzureCredential, which tries these credentials in order:</summary>
|
|
281
292
|
|
|
282
293
|
The Azure MCP Server seamlessly integrates with your host operating system's authentication mechanisms, making it super easy to get started! We use Azure Identity under the hood via [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac), which tries these credentials in order:
|
|
283
294
|
|
|
@@ -302,6 +313,7 @@ AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true
|
|
|
302
313
|
```
|
|
303
314
|
|
|
304
315
|
This is useful when running on Azure services where you want to use managed identities.
|
|
316
|
+
</details>
|
|
305
317
|
|
|
306
318
|
## ๐ก๏ธ Security Note
|
|
307
319
|
|
|
@@ -310,7 +322,6 @@ Your credentials are always handled securely through the official [Azure Identit
|
|
|
310
322
|
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.
|
|
311
323
|
|
|
312
324
|
## ๐ฅ Contributing
|
|
313
|
-
|
|
314
325
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
315
326
|
|
|
316
327
|
Please read our [Contributing Guide](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) for guidelines on:
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/dist/azmcp.deps.json
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
"targets": {
|
|
8
8
|
".NETCoreApp,Version=v9.0": {},
|
|
9
9
|
".NETCoreApp,Version=v9.0/win-arm64": {
|
|
10
|
-
"azmcp/0.2.
|
|
10
|
+
"azmcp/0.2.1": {
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"Azure.Core": "1.46.1",
|
|
13
13
|
"Azure.Data.AppConfiguration": "1.6.1",
|
|
@@ -29,6 +29,7 @@
|
|
|
29
29
|
"Azure.Search.Documents": "11.7.0-beta.4",
|
|
30
30
|
"Azure.Security.KeyVault.Keys": "4.7.0",
|
|
31
31
|
"Azure.Storage.Blobs": "12.24.0",
|
|
32
|
+
"JsonSchema.Net": "7.3.4",
|
|
32
33
|
"Microsoft.Azure.Cosmos": "3.51.0",
|
|
33
34
|
"Microsoft.Azure.Kusto.Data": "13.0.2",
|
|
34
35
|
"Microsoft.Extensions.Azure": "1.11.0",
|
|
@@ -1664,6 +1665,45 @@
|
|
|
1664
1665
|
}
|
|
1665
1666
|
}
|
|
1666
1667
|
},
|
|
1668
|
+
"Humanizer.Core/2.14.1": {
|
|
1669
|
+
"runtime": {
|
|
1670
|
+
"lib/net6.0/Humanizer.dll": {
|
|
1671
|
+
"assemblyVersion": "2.14.0.0",
|
|
1672
|
+
"fileVersion": "2.14.1.48190"
|
|
1673
|
+
}
|
|
1674
|
+
}
|
|
1675
|
+
},
|
|
1676
|
+
"Json.More.Net/2.1.1": {
|
|
1677
|
+
"runtime": {
|
|
1678
|
+
"lib/net9.0/Json.More.dll": {
|
|
1679
|
+
"assemblyVersion": "2.0.0.0",
|
|
1680
|
+
"fileVersion": "2.1.1.0"
|
|
1681
|
+
}
|
|
1682
|
+
}
|
|
1683
|
+
},
|
|
1684
|
+
"JsonPointer.Net/5.3.1": {
|
|
1685
|
+
"dependencies": {
|
|
1686
|
+
"Humanizer.Core": "2.14.1",
|
|
1687
|
+
"Json.More.Net": "2.1.1"
|
|
1688
|
+
},
|
|
1689
|
+
"runtime": {
|
|
1690
|
+
"lib/net9.0/JsonPointer.Net.dll": {
|
|
1691
|
+
"assemblyVersion": "5.0.0.0",
|
|
1692
|
+
"fileVersion": "5.3.1.0"
|
|
1693
|
+
}
|
|
1694
|
+
}
|
|
1695
|
+
},
|
|
1696
|
+
"JsonSchema.Net/7.3.4": {
|
|
1697
|
+
"dependencies": {
|
|
1698
|
+
"JsonPointer.Net": "5.3.1"
|
|
1699
|
+
},
|
|
1700
|
+
"runtime": {
|
|
1701
|
+
"lib/net9.0/JsonSchema.Net.dll": {
|
|
1702
|
+
"assemblyVersion": "7.0.0.0",
|
|
1703
|
+
"fileVersion": "7.3.4.0"
|
|
1704
|
+
}
|
|
1705
|
+
}
|
|
1706
|
+
},
|
|
1667
1707
|
"Microsoft.Azure.Amqp/2.6.9": {
|
|
1668
1708
|
"runtime": {
|
|
1669
1709
|
"lib/netstandard2.0/Microsoft.Azure.Amqp.dll": {
|
|
@@ -2958,7 +2998,7 @@
|
|
|
2958
2998
|
}
|
|
2959
2999
|
},
|
|
2960
3000
|
"libraries": {
|
|
2961
|
-
"azmcp/0.2.
|
|
3001
|
+
"azmcp/0.2.1": {
|
|
2962
3002
|
"type": "project",
|
|
2963
3003
|
"serviceable": false,
|
|
2964
3004
|
"sha512": ""
|
|
@@ -3141,6 +3181,34 @@
|
|
|
3141
3181
|
"path": "azure.storage.common/12.23.0",
|
|
3142
3182
|
"hashPath": "azure.storage.common.12.23.0.nupkg.sha512"
|
|
3143
3183
|
},
|
|
3184
|
+
"Humanizer.Core/2.14.1": {
|
|
3185
|
+
"type": "package",
|
|
3186
|
+
"serviceable": true,
|
|
3187
|
+
"sha512": "sha512-lQKvtaTDOXnoVJ20ibTuSIOf2i0uO0MPbDhd1jm238I+U/2ZnRENj0cktKZhtchBMtCUSRQ5v4xBCUbKNmyVMw==",
|
|
3188
|
+
"path": "humanizer.core/2.14.1",
|
|
3189
|
+
"hashPath": "humanizer.core.2.14.1.nupkg.sha512"
|
|
3190
|
+
},
|
|
3191
|
+
"Json.More.Net/2.1.1": {
|
|
3192
|
+
"type": "package",
|
|
3193
|
+
"serviceable": true,
|
|
3194
|
+
"sha512": "sha512-ZXAKl2VsdnIZeUo1PFII3Oi1m1L4YQjEyDjygHfHln5vgsjgIo749X6xWkv7qFYp8RROES+vOEfDcvvoVgs8kA==",
|
|
3195
|
+
"path": "json.more.net/2.1.1",
|
|
3196
|
+
"hashPath": "json.more.net.2.1.1.nupkg.sha512"
|
|
3197
|
+
},
|
|
3198
|
+
"JsonPointer.Net/5.3.1": {
|
|
3199
|
+
"type": "package",
|
|
3200
|
+
"serviceable": true,
|
|
3201
|
+
"sha512": "sha512-3e2OJjU0OaE26XC/klgxbJuXvteFWTDJIJv0ITYWcJEoskq7jzUwPSC1s0iz4wPPQnfN7vwwFmg2gJfwRAPwgw==",
|
|
3202
|
+
"path": "jsonpointer.net/5.3.1",
|
|
3203
|
+
"hashPath": "jsonpointer.net.5.3.1.nupkg.sha512"
|
|
3204
|
+
},
|
|
3205
|
+
"JsonSchema.Net/7.3.4": {
|
|
3206
|
+
"type": "package",
|
|
3207
|
+
"serviceable": true,
|
|
3208
|
+
"sha512": "sha512-7GggWrdzKrtGWETRn3dcMnmuLSyWaDkBK94TK80LEHQEVz4bmsQc7FYO7qL40RDdZU2YPz5d98aT9lW5OYExuA==",
|
|
3209
|
+
"path": "jsonschema.net/7.3.4",
|
|
3210
|
+
"hashPath": "jsonschema.net.7.3.4.nupkg.sha512"
|
|
3211
|
+
},
|
|
3144
3212
|
"Microsoft.Azure.Amqp/2.6.9": {
|
|
3145
3213
|
"type": "package",
|
|
3146
3214
|
"serviceable": true,
|
package/dist/azmcp.dll
CHANGED
|
Binary file
|
package/dist/azmcp.exe
CHANGED
|
Binary file
|
package/dist/createdump.exe
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure/mcp-win32-arm64",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Azure MCP Server - Model Context Protocol implementation for Azure, for win32 on arm64",
|
|
5
5
|
"author": "Microsoft Corporation",
|
|
6
6
|
"homepage": "https://github.com/Azure/azure-mcp#readme",
|