You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: servers/Azure.Mcp.Server/CHANGELOG.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,10 @@ The Azure MCP Server updates automatically by default whenever a new release com
4
4
5
5
## 0.8.2 (2025-09-25)
6
6
7
+
### Features Added
8
+
9
+
-- Added support for publishing custom events to Event Grid topics via the command `azmcp_eventgrid_events_publish`. Supports EventGrid, CloudEvents, and custom schemas with structured event data delivery for event-driven architectures. [[#514](https://github.com/microsoft/mcp/pull/514)]
10
+
7
11
### Bugs Fixed
8
12
9
13
- Fixed `azmcp_subscription_list` to return empty enumerable instead of `null` when no subscriptions are found. [[#508](https://github.com/microsoft/mcp/pull/508)]
1. 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
47
49
1. Install the [Azure MCP Server](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server) extension
48
50
49
-
### <aid="visual-studio-2022"></a> 💜 Visual Studio 2022
51
+
### Visual Studio 2022
50
52
51
53
From within Visual Studio 2022 install [GitHub Copilot for Azure (VS 2022)](https://marketplace.visualstudio.com/items?itemName=github-copilot-azure.GitHubCopilotForAzure2022):
52
54
1. Go to `Extensions | Manage Extensions...`
53
55
2. Switch to the `Browse` tab in `Extension Manager`
54
56
3. Search for `Github Copilot for Azure`
55
57
4. Click `Install`
56
58
57
-
### <aid="intellij-idea"></a> ☕ IntelliJ IDEA
59
+
### IntelliJ IDEA
58
60
59
61
1. Install either the [IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download) or [IntelliJ IDEA Community](https://www.jetbrains.com/idea/download) edition.
60
62
1. Install the [GitHub Copilot](https://plugins.jetbrains.com/plugin/17718-github-copilot) plugin.
61
63
1. Install the [Azure Toolkit for Intellij](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij) plugin.
62
64
63
-
## <aid="package-managers"></a> Package Managers
64
-
65
-
### <aid="nuget"></a> 🤖 NuGet
66
-
67
-
Microsoft publishes an official Azure MCP Server .NET Tool on NuGet: [Azure.Mcp](https://www.nuget.org/packages/Azure.Mcp).
68
-
69
-
### <aid="npm"></a> 📦 NPM
70
-
71
-
Microsoft publishes an official Azure MCP Server npm package for Node.js: [@azure/mcp](https://www.npmjs.com/package/@azure/mcp).
72
-
73
-
### <aid="docker"></a> 🐋 Docker
65
+
### Additional IDEs
74
66
75
-
Microsoft publishes an official Azure MCP Server Docker container on the [Microsoft Artifact Registry](https://mcr.microsoft.com/artifact/mar/azure-sdk/azure-mcp).
67
+
For IDEs not listed above, manually setup Azure MCP Server within the IDE.
76
68
77
69
<details>
78
-
<summary>For a step-by-step Docker installation, follow these instructions:</summary>
79
-
80
-
1. 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:
81
-
82
-
```bash
83
-
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
84
-
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
85
-
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
86
-
```
70
+
<summary>Manual setup instructions</summary>
87
71
88
-
2. Add `.vscode/mcp.json`or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.
72
+
Configure via `mcp.json`(VS Code example - adapt structure for your IDE):
89
73
90
-
```json
74
+
```json
91
75
{
92
76
"servers": {
93
77
"Azure MCP Server": {
94
-
"command": "docker",
78
+
"command": "npx",
95
79
"args": [
96
-
"run",
97
-
"-i",
98
-
"--rm",
99
-
"--env-file",
100
-
"/full/path/to/.env",
101
-
"mcr.microsoft.com/azure-sdk/azure-mcp:latest",
80
+
"-y",
81
+
"@azure/mcp@latest",
82
+
"server",
83
+
"start"
102
84
]
103
85
}
104
86
}
105
87
}
106
-
```
88
+
```
89
+
90
+
In some environments you may need to run the server directly:
91
+
92
+
```bash
93
+
npx -y @azure/mcp@latest server start
94
+
```
107
95
108
-
Optionally, use `--env` or `--volume` to pass authentication values.
109
96
</details>
110
97
111
-
## <a id="custom-clients"></a> 🤖 Custom Clients
112
98
113
-
You can easily configure your MCP client to use the Azure MCP Server.
99
+
## Package Manager
114
100
115
-
<details>
116
-
<summary>Have your client run the following command and access it via standard IO:</summary>
101
+
Install Azure MCP Server via a package manager:
102
+
103
+
### NuGet
104
+
105
+
Install the .NET Tool: [Azure.Mcp](https://www.nuget.org/packages/Azure.Mcp).
117
106
118
107
```bash
119
-
npx -y @azure/mcp@latest server start
108
+
dotnet tool install --global Azure.Mcp
120
109
```
121
110
122
-
For example, add the following `mcp.json` to VS Code. Other clients will look similar, but may be structured slightly different. Consult the documentation of the custom client for details.
111
+
### NPM
123
112
124
-
1. Example `mcp.json`:
113
+
Install the Node.js package: [@azure/mcp](https://www.npmjs.com/package/@azure/mcp).
125
114
126
-
```json
127
-
{
115
+
```bash
116
+
npm install -g @azure/mcp
117
+
```
118
+
119
+
### Docker
120
+
121
+
Microsoft publishes an official Azure MCP Server Docker container on the [Microsoft Artifact Registry](https://mcr.microsoft.com/artifact/mar/azure-sdk/azure-mcp).
122
+
123
+
<details>
124
+
<summary>Docker setup instructions</summary>
125
+
126
+
1. Create a `.env` file with Azure credentials ([see EnvironmentCredential options](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential)):
127
+
128
+
```bash
129
+
AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
130
+
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
131
+
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}
132
+
```
133
+
134
+
2. Configure your MCP client with the Docker command:
135
+
136
+
```json
137
+
{
128
138
"servers": {
129
-
"Azure MCP Server": {
130
-
"command": "npx",
131
-
"args": [
132
-
"-y",
133
-
"@azure/mcp@latest",
134
-
"server",
135
-
"start"
136
-
]
137
-
}
139
+
"Azure MCP Server": {
140
+
"command": "docker",
141
+
"args": [
142
+
"run",
143
+
"-i",
144
+
"--rm",
145
+
"--env-file",
146
+
"/full/path/to/.env",
147
+
"mcr.microsoft.com/azure-sdk/azure-mcp:latest"
148
+
]
149
+
}
138
150
}
139
-
}
140
-
```
151
+
}
152
+
```
153
+
154
+
Replace `/full/path/to/.env` with your actual .env file path. Alternatively, use individual `--env` flags or `--volume` mounts for credentials.
141
155
</details>
142
156
143
-
#<a id="usage"></a> Usage
157
+
# Usage
144
158
145
-
## <a id="getting-started"></a> 🚀 Getting Started
159
+
## Getting Started
146
160
147
161
1. Open GitHub Copilot in [VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) or [IntelliJ](https://github.blog/changelog/2025-05-19-agent-mode-and-mcp-support-for-copilot-in-jetbrains-eclipse-and-xcode-now-in-public-preview/#agent-mode) and switch to Agent mode.
148
162
1. Click `refresh` on the tools list
@@ -153,9 +167,9 @@ For example, add the following `mcp.json` to VS Code. Other clients will look s
153
167
1. We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server
154
168
- 👉 [Open an issue in the public repository](https://github.com/microsoft/mcp/issues/new/choose)
155
169
156
-
## <a id="what-can-you-do-with-the-azure-mcp-server"></a> ✨ What can you do with the Azure MCP Server?
170
+
## What can you do with the Azure MCP Server?
157
171
158
-
The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
172
+
✨ The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
159
173
160
174
### 🧮 Azure AI Foundry
161
175
@@ -211,6 +225,8 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
211
225
* "List Event Grid subscriptions for topic 'my-topic' in subscription 'my-subscription'"
212
226
* "List Event Grid Subscriptions in subscription 'my-subscription'"
213
227
* "List Event Grid subscriptions for topic 'my-topic' in location 'my-location'"
228
+
* "Publish an event with data '{\"name\": \"test\"}' to topic 'my-topic' using CloudEvents schema"
229
+
* "Send custom event data to Event Grid topic 'analytics-events' with EventGrid schema"
214
230
215
231
### 🔑 Azure Key Vault
216
232
@@ -264,7 +280,7 @@ The Azure MCP Server supercharges your agents with Azure context. Here are some
264
280
* "Upload my file to the blob container"
265
281
266
282
267
-
## <a id="complete-list-of-supported-azure-services"></a> 🛠️ Complete List of Supported Azure Services
283
+
## Complete List of Supported Azure Services
268
284
269
285
The Azure MCP Server provides tools for interacting with **30+ Azure service areas**:
270
286
@@ -305,26 +321,26 @@ The Azure MCP Server provides tools for interacting with **30+ Azure service are
# <a id="support-and-reference"></a> Support & Reference
324
+
# Support and Reference
309
325
310
-
## <a id="documentation"></a> Documentation
326
+
## Documentation
311
327
312
328
- See our [official documentation on learn.microsoft.com](https://learn.microsoft.com/azure/developer/azure-mcp-server/) to learn how to use the Azure MCP Server to interact with Azure resources through natural language commands from AI agents and other types of clients.
313
329
- For additional command documentation and examples, see [Azure MCP Commands](https://github.com/microsoft/mcp/blob/main/docs/azmcp-commands.md).
314
330
315
-
## <a id="feedback-and-support"></a> Feedback & Support
331
+
## Feedback and Support
316
332
317
333
- Check the [Troubleshooting guide](https://aka.ms/azmcp/troubleshooting) to diagnose and resolve common issues with the Azure MCP Server.
318
334
- We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server.
319
335
- 👉 [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we’d love to hear from you!
320
336
321
-
## <a id="security"></a> 🛡️ Security
337
+
## Security
322
338
323
339
Your credentials are always handled securely through the official [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) - **we never store or manage tokens directly**.
324
340
325
341
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.
326
342
327
-
## <a id="data-collection"></a> Data Collection
343
+
## Data Collection
328
344
329
345
The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's [privacy statement](https://www.microsoft.com/privacy/privacystatement). You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
330
346
@@ -336,7 +352,7 @@ To opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false
336
352
337
353
338
354
339
-
## <a id="contributing"></a> 👥 Contributing
355
+
## Contributing
340
356
341
357
We welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.
0 commit comments