@azure/mcp-win32-arm64 0.1.2 โ 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 +114 -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,66 +149,39 @@ 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
|
-
##
|
|
137
|
-
|
|
138
|
-
The Azure MCP Server requires Node.js to install and run the server. If you don't have it installed, follow the instructions [here](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
|
|
139
|
-
|
|
140
|
-
### VS Code + GitHub Copilot
|
|
141
|
-
|
|
142
|
-
The Azure MCP Server provides Azure SDK and Azure CLI developer tools. It 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. If you're interested in broad developer support across a variety of Azure development scenarios not included in the Azure MCP Server, such as searching documentation on Microsoft Learn, we recommend this extension as well.
|
|
143
|
-
|
|
144
|
-
### Prerequisites
|
|
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
|
|
156
|
+
## ๐๏ธ Upgrading Existing Installs to the Latest Version
|
|
152
157
|
|
|
153
|
-
|
|
158
|
+
<details>
|
|
159
|
+
<summary>How to stay current with releases of Azure MCP Server</summary>
|
|
154
160
|
|
|
155
|
-
####
|
|
161
|
+
#### NPX
|
|
156
162
|
|
|
157
|
-
|
|
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.
|
|
158
164
|
|
|
159
|
-
|
|
165
|
+
#### NPM
|
|
160
166
|
|
|
161
|
-
|
|
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`.
|
|
162
168
|
|
|
163
|
-
|
|
169
|
+
#### Docker
|
|
164
170
|
|
|
165
|
-
|
|
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).
|
|
166
172
|
|
|
167
|
-
|
|
173
|
+
#### VS Code
|
|
168
174
|
|
|
169
|
-
|
|
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>
|
|
170
177
|
|
|
171
|
-
|
|
178
|
+
## โ๏ธ Advanced Install Scenarios (Optional)
|
|
179
|
+
<details>
|
|
180
|
+
<summary>Docker containers, custom MCP clients, and manual install options</summary>
|
|
172
181
|
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
{
|
|
176
|
-
"servers": {
|
|
177
|
-
"Azure MCP Server": {
|
|
178
|
-
"command": "npx",
|
|
179
|
-
"args": [
|
|
180
|
-
"-y",
|
|
181
|
-
"@azure/mcp@latest",
|
|
182
|
-
"server",
|
|
183
|
-
"start"
|
|
184
|
-
]
|
|
185
|
-
}
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
|
-
```
|
|
182
|
+
#### ๐ Docker Install Steps (Optional)
|
|
183
|
+
For a step-by-step Docker installation, follow these instructions:
|
|
189
184
|
|
|
190
|
-
#### Docker Install
|
|
191
|
-
|
|
192
|
-
For a step-by-step installation, follow these instructions:
|
|
193
185
|
1. Clone repository
|
|
194
186
|
2. From repository root, build Docker image: `docker build -t azure/azuremcp .`
|
|
195
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:
|
|
@@ -198,7 +190,7 @@ AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
|
|
|
198
190
|
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
|
|
199
191
|
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
200
192
|
```
|
|
201
|
-
|
|
193
|
+
4. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
|
|
202
194
|
```json
|
|
203
195
|
{
|
|
204
196
|
"servers": {
|
|
@@ -208,9 +200,9 @@ AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
|
208
200
|
"run",
|
|
209
201
|
"-i",
|
|
210
202
|
"--rm",
|
|
211
|
-
"azure/azuremcp",
|
|
212
203
|
"--env-file",
|
|
213
204
|
"/full/path/to/.env"
|
|
205
|
+
"azure/azuremcp",
|
|
214
206
|
]
|
|
215
207
|
}
|
|
216
208
|
}
|
|
@@ -219,38 +211,53 @@ AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
|
219
211
|
|
|
220
212
|
Optionally, customers can use `--env` or `--volume` to pass authentication values.
|
|
221
213
|
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
#### NPX
|
|
225
|
-
|
|
226
|
-
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.
|
|
227
|
-
|
|
228
|
-
#### NPM
|
|
229
|
-
|
|
230
|
-
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`.
|
|
231
|
-
|
|
232
|
-
#### Docker
|
|
233
|
-
|
|
234
|
-
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).
|
|
235
|
-
|
|
236
|
-
#### VS Code
|
|
237
|
-
|
|
238
|
-
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.
|
|
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.
|
|
239
216
|
|
|
240
|
-
|
|
217
|
+
#### ๐ง Manual Install Steps (Optional)
|
|
218
|
+
For a step-by-step installation, follow these instructions:
|
|
241
219
|
|
|
242
|
-
1.
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
220
|
+
1. Add `.vscode/mcp.json`:
|
|
221
|
+
```json
|
|
222
|
+
{
|
|
223
|
+
"servers": {
|
|
224
|
+
"Azure MCP Server": {
|
|
225
|
+
"command": "npx",
|
|
226
|
+
"args": [
|
|
227
|
+
"-y",
|
|
228
|
+
"@azure/mcp@latest",
|
|
229
|
+
"server",
|
|
230
|
+
"start"
|
|
231
|
+
]
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
```
|
|
246
236
|
|
|
247
|
-
|
|
237
|
+
You can optionally set the `--service <service>` flag to install tools for the specified Azure product or service.
|
|
248
238
|
|
|
249
|
-
|
|
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
|
+
```
|
|
250
257
|
|
|
251
258
|
### Using standard IO
|
|
252
259
|
|
|
253
|
-
Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. For instructions on using , follow instructions in [
|
|
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).
|
|
254
261
|
|
|
255
262
|
### Using SSE
|
|
256
263
|
|
|
@@ -270,12 +277,18 @@ Configure the MCP client to execute: `npx -y @azure/mcp@latest server start`. Fo
|
|
|
270
277
|
|
|
271
278
|
|
|
272
279
|
More end-to-end MCP client/agent guides are coming soon!
|
|
280
|
+
</details>
|
|
281
|
+
|
|
282
|
+
|
|
273
283
|
|
|
274
284
|
## ๐ Troubleshooting
|
|
275
285
|
|
|
276
286
|
See [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
277
287
|
|
|
278
|
-
|
|
288
|
+
### ๐ Authentication
|
|
289
|
+
|
|
290
|
+
<details>
|
|
291
|
+
<summary>We use Azure Identity SDK under the hood via DefaultAzureCredential, which tries these credentials in order:</summary>
|
|
279
292
|
|
|
280
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:
|
|
281
294
|
|
|
@@ -300,6 +313,7 @@ AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true
|
|
|
300
313
|
```
|
|
301
314
|
|
|
302
315
|
This is useful when running on Azure services where you want to use managed identities.
|
|
316
|
+
</details>
|
|
303
317
|
|
|
304
318
|
## ๐ก๏ธ Security Note
|
|
305
319
|
|
|
@@ -308,7 +322,6 @@ Your credentials are always handled securely through the official [Azure Identit
|
|
|
308
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.
|
|
309
323
|
|
|
310
324
|
## ๐ฅ Contributing
|
|
311
|
-
|
|
312
325
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
313
326
|
|
|
314
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.1
|
|
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.1
|
|
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.1
|
|
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",
|