@azure/mcp 0.0.14 โ 0.0.16
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 +46 -8
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
[](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) [](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)
|
|
5
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.
|
|
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
7
|
|
|
8
8
|
> Please note that this project is in Public Preview and implementation may significantly change prior to our General Availability.
|
|
9
9
|
|
|
@@ -101,6 +101,10 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
|
|
|
101
101
|
- List resource groups
|
|
102
102
|
- Resource group management operations
|
|
103
103
|
|
|
104
|
+
### ๐ Azure Service Bus
|
|
105
|
+
- Peek at messages from subscriptions and queues
|
|
106
|
+
- Examine properties and runtime information about queues, topics, and subscriptions
|
|
107
|
+
|
|
104
108
|
### ๐ง Azure CLI Extension
|
|
105
109
|
- Execute Azure CLI commands directly
|
|
106
110
|
- Support for all Azure CLI functionality
|
|
@@ -112,7 +116,7 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
|
|
|
112
116
|
- Support for template discovery, template initialization, provisioning and deployment
|
|
113
117
|
- Cross-platform compatibility
|
|
114
118
|
|
|
115
|
-
For detailed command documentation and examples, see [Azure MCP Commands](docs/azmcp-commands.md).
|
|
119
|
+
For detailed command documentation and examples, see [Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md).
|
|
116
120
|
|
|
117
121
|
## ๐ Getting Started
|
|
118
122
|
|
|
@@ -127,7 +131,9 @@ The Azure MCP Server provides Azure SDK and Azure CLI developer tools. It can be
|
|
|
127
131
|
* [๐ซ Stable release](https://code.visualstudio.com/download)
|
|
128
132
|
* [๐ฎ Insiders release](https://code.visualstudio.com/insiders)
|
|
129
133
|
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
|
|
130
|
-
3.
|
|
134
|
+
3. Install [Node.js](https://nodejs.org/en/download) 20 or later
|
|
135
|
+
* Ensure `node` and `npm` are in your path
|
|
136
|
+
4. Open VS Code in an empty folder
|
|
131
137
|
|
|
132
138
|
### Installation
|
|
133
139
|
|
|
@@ -160,6 +166,38 @@ For a step-by-step installation, follow these instructions:
|
|
|
160
166
|
}
|
|
161
167
|
```
|
|
162
168
|
|
|
169
|
+
#### Docker Install
|
|
170
|
+
|
|
171
|
+
For a step-by-step installation, follow these instructions:
|
|
172
|
+
1. Clone repository
|
|
173
|
+
2. From repository root, build Docker image: `docker build -t azure/azuremcp .`
|
|
174
|
+
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:
|
|
175
|
+
```json
|
|
176
|
+
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
|
|
177
|
+
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
|
|
178
|
+
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
|
|
179
|
+
```
|
|
180
|
+
1. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
|
|
181
|
+
```json
|
|
182
|
+
{
|
|
183
|
+
"servers": {
|
|
184
|
+
"Azure MCP Server": {
|
|
185
|
+
"command": "docker",
|
|
186
|
+
"args": [
|
|
187
|
+
"run",
|
|
188
|
+
"-i",
|
|
189
|
+
"--rm",
|
|
190
|
+
"azure/azuremcp",
|
|
191
|
+
"--env-file",
|
|
192
|
+
"/full/path/to/.env"
|
|
193
|
+
]
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
Optionally, customers can use `--env` or `--volume` to pass authentication values.
|
|
200
|
+
|
|
163
201
|
## ๐งช Test the Azure MCP Server
|
|
164
202
|
|
|
165
203
|
1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
|
|
@@ -196,7 +234,7 @@ More end-to-end MCP client/agent guides are coming soon!
|
|
|
196
234
|
|
|
197
235
|
## ๐ Troubleshooting
|
|
198
236
|
|
|
199
|
-
See [Troubleshooting guide](/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
237
|
+
See [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) for help with common issues and logging.
|
|
200
238
|
|
|
201
239
|
## ๐ Authentication
|
|
202
240
|
|
|
@@ -210,9 +248,9 @@ The Azure MCP Server seamlessly integrates with your host operating system's aut
|
|
|
210
248
|
6. **Azure Developer CLI** (`AzureDeveloperCliCredential`) - Uses your azd login
|
|
211
249
|
7. **Interactive Browser** (`InteractiveBrowserCredential`) - Falls back to browser-based login if needed
|
|
212
250
|
|
|
213
|
-
If you're already logged in through any of these methods, the Azure MCP Server will automatically use those credentials.
|
|
251
|
+
If you're already logged in through any of these methods, the Azure MCP Server will automatically use those credentials. Ensure that you have the correct authorization permissions in Azure (e.g. read access to your Storage account) via RBAC (Role-Based Access Control). To learn more about Azure's RBAC authorization system, visit this [link](https://learn.microsoft.com/azure/role-based-access-control/overview).
|
|
214
252
|
|
|
215
|
-
If you're running into any issues with authentication, visit our [troubleshooting guide](/TROUBLESHOOTING.md).
|
|
253
|
+
If you're running into any issues with authentication, visit our [troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md).
|
|
216
254
|
|
|
217
255
|
### Production Credentials
|
|
218
256
|
|
|
@@ -234,7 +272,7 @@ MCP as a phenomenon is very novel and cutting-edge. As with all new technology s
|
|
|
234
272
|
|
|
235
273
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
236
274
|
|
|
237
|
-
Please read our [Contributing Guide](/CONTRIBUTING.md) for guidelines on:
|
|
275
|
+
Please read our [Contributing Guide](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) for guidelines on:
|
|
238
276
|
|
|
239
277
|
- ๐ ๏ธ Setting up your development environment
|
|
240
278
|
- โจ Adding new commands
|
|
@@ -248,4 +286,4 @@ This project has adopted the
|
|
|
248
286
|
For more information, see the
|
|
249
287
|
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
|
250
288
|
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com)
|
|
251
|
-
with any additional questions or comments.
|
|
289
|
+
with any additional questions or comments.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure/mcp",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.16",
|
|
4
4
|
"description": "Azure MCP Server - Model Context Protocol implementation for Azure",
|
|
5
5
|
"author": "Microsoft Corporation",
|
|
6
6
|
"homepage": "https://github.com/Azure/azure-mcp#readme",
|
|
@@ -33,11 +33,11 @@
|
|
|
33
33
|
"arm64"
|
|
34
34
|
],
|
|
35
35
|
"optionalDependencies": {
|
|
36
|
-
"@azure/mcp-darwin-x64": "0.0.
|
|
37
|
-
"@azure/mcp-linux-arm64": "0.0.
|
|
38
|
-
"@azure/mcp-darwin-arm64": "0.0.
|
|
39
|
-
"@azure/mcp-win32-x64": "0.0.
|
|
40
|
-
"@azure/mcp-linux-x64": "0.0.
|
|
41
|
-
"@azure/mcp-win32-arm64": "0.0.
|
|
36
|
+
"@azure/mcp-darwin-x64": "0.0.16",
|
|
37
|
+
"@azure/mcp-linux-arm64": "0.0.16",
|
|
38
|
+
"@azure/mcp-darwin-arm64": "0.0.16",
|
|
39
|
+
"@azure/mcp-win32-x64": "0.0.16",
|
|
40
|
+
"@azure/mcp-linux-x64": "0.0.16",
|
|
41
|
+
"@azure/mcp-win32-arm64": "0.0.16"
|
|
42
42
|
}
|
|
43
43
|
}
|