@azure/mcp 0.0.15 โ 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 +42 -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
|
|
|
@@ -116,7 +116,7 @@ The Azure MCP Server provides tools for interacting with the following Azure ser
|
|
|
116
116
|
- Support for template discovery, template initialization, provisioning and deployment
|
|
117
117
|
- Cross-platform compatibility
|
|
118
118
|
|
|
119
|
-
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).
|
|
120
120
|
|
|
121
121
|
## ๐ Getting Started
|
|
122
122
|
|
|
@@ -131,7 +131,9 @@ The Azure MCP Server provides Azure SDK and Azure CLI developer tools. It can be
|
|
|
131
131
|
* [๐ซ Stable release](https://code.visualstudio.com/download)
|
|
132
132
|
* [๐ฎ Insiders release](https://code.visualstudio.com/insiders)
|
|
133
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
|
|
134
|
-
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
|
|
135
137
|
|
|
136
138
|
### Installation
|
|
137
139
|
|
|
@@ -164,6 +166,38 @@ For a step-by-step installation, follow these instructions:
|
|
|
164
166
|
}
|
|
165
167
|
```
|
|
166
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
|
+
|
|
167
201
|
## ๐งช Test the Azure MCP Server
|
|
168
202
|
|
|
169
203
|
1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)
|
|
@@ -200,7 +234,7 @@ More end-to-end MCP client/agent guides are coming soon!
|
|
|
200
234
|
|
|
201
235
|
## ๐ Troubleshooting
|
|
202
236
|
|
|
203
|
-
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.
|
|
204
238
|
|
|
205
239
|
## ๐ Authentication
|
|
206
240
|
|
|
@@ -214,9 +248,9 @@ The Azure MCP Server seamlessly integrates with your host operating system's aut
|
|
|
214
248
|
6. **Azure Developer CLI** (`AzureDeveloperCliCredential`) - Uses your azd login
|
|
215
249
|
7. **Interactive Browser** (`InteractiveBrowserCredential`) - Falls back to browser-based login if needed
|
|
216
250
|
|
|
217
|
-
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).
|
|
218
252
|
|
|
219
|
-
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).
|
|
220
254
|
|
|
221
255
|
### Production Credentials
|
|
222
256
|
|
|
@@ -238,7 +272,7 @@ MCP as a phenomenon is very novel and cutting-edge. As with all new technology s
|
|
|
238
272
|
|
|
239
273
|
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
|
|
240
274
|
|
|
241
|
-
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:
|
|
242
276
|
|
|
243
277
|
- ๐ ๏ธ Setting up your development environment
|
|
244
278
|
- โจ Adding new commands
|
|
@@ -252,4 +286,4 @@ This project has adopted the
|
|
|
252
286
|
For more information, see the
|
|
253
287
|
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
|
|
254
288
|
or contact [opencode@microsoft.com](mailto:opencode@microsoft.com)
|
|
255
|
-
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
|
}
|