@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.
Files changed (2) hide show
  1. package/README.md +42 -8
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  [![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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. Open VS Code in an empty folder
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.15",
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.15",
37
- "@azure/mcp-linux-arm64": "0.0.15",
38
- "@azure/mcp-darwin-arm64": "0.0.15",
39
- "@azure/mcp-win32-x64": "0.0.15",
40
- "@azure/mcp-linux-x64": "0.0.15",
41
- "@azure/mcp-win32-arm64": "0.0.15"
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
  }