@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.
Files changed (2) hide show
  1. package/README.md +46 -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
 
@@ -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. 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
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.14",
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.14",
37
- "@azure/mcp-linux-arm64": "0.0.14",
38
- "@azure/mcp-darwin-arm64": "0.0.14",
39
- "@azure/mcp-win32-x64": "0.0.14",
40
- "@azure/mcp-linux-x64": "0.0.14",
41
- "@azure/mcp-win32-arm64": "0.0.14"
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
  }