@azure/mcp-linux-arm64 2.0.0-beta.1 → 2.0.0-beta.11
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/NOTICE.txt +6129 -5295
- package/README.md +77 -10
- package/dist/appsettings.json +5 -0
- package/dist/azmcp +0 -0
- package/package.json +5 -4
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# <img height="36" width="36" src="https://cdn-dynmedia-1.microsoft.com/is/content/microsoftcorp/acom_social_icon_azure" alt="Microsoft Azure Logo" /> Azure MCP Server NPM Package
|
|
2
2
|
|
|
3
|
-
All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code.
|
|
4
3
|
|
|
4
|
+
All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code.
|
|
5
5
|
## Table of Contents
|
|
6
6
|
- [Overview](#overview)
|
|
7
7
|
- [Installation](#installation)
|
|
@@ -54,11 +54,25 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
|
|
|
54
54
|
| **Claude Code** | `~/.claude.json` or `.mcp.json` (project) | [Claude Code MCP Configuration](https://scottspence.com/posts/configuring-mcp-tools-in-claude-code) |
|
|
55
55
|
| **Claude Desktop** | `~/.claude/claude_desktop_config.json` (macOS)<br>`%APPDATA%\Claude\claude_desktop_config.json` (Windows) | [Claude Desktop MCP Setup](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) |
|
|
56
56
|
| **Cursor** | `~/.cursor/mcp.json` or `.cursor/mcp.json` | [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol) |
|
|
57
|
+
| **Eclipse IDE** | GitHub Copilot Chat -> Configure Tools -> MCP Servers | [Eclipse MCP Documentation](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp#configuring-mcp-servers-in-eclipse) |
|
|
57
58
|
| **IntelliJ IDEA** | Built-in MCP server (2025.2+)<br>Settings > Tools > MCP Server | [IntelliJ MCP Documentation](https://www.jetbrains.com/help/ai-assistant/mcp.html) |
|
|
58
59
|
| **Visual Studio** | `.mcp.json` (solution/workspace) | [Visual Studio MCP Setup](https://learn.microsoft.com/visualstudio/ide/mcp-servers?view=vs-2022) |
|
|
59
60
|
| **VS Code** | `.vscode/mcp.json` (workspace)<br>`settings.json` (user) | [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) |
|
|
60
61
|
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | [Windsurf Cascade MCP Integration](https://docs.windsurf.com/windsurf/cascade/mcp) |
|
|
61
62
|
|
|
63
|
+
## Remote MCP Server (preview)
|
|
64
|
+
|
|
65
|
+
Microsoft Foundry and Microsoft Copilot Studio require remote MCP server endpoints. To self-host the Azure MCP Server for use with these platforms, deploy it as a remote MCP server on [Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview).
|
|
66
|
+
|
|
67
|
+
### Microsoft Foundry
|
|
68
|
+
|
|
69
|
+
1. Follow the [deployment guide](https://github.com/Azure-Samples/azmcp-foundry-aca-mi) for Microsoft Foundry.
|
|
70
|
+
2. See [Microsoft Foundry's MCP documentation](https://learn.microsoft.com/azure/ai-foundry/agents/how-to/tools/model-context-protocol) for more details.
|
|
71
|
+
|
|
72
|
+
### Microsoft Copilot Studio
|
|
73
|
+
|
|
74
|
+
1. Follow the [deployment guide](https://github.com/Azure-Samples/azmcp-copilot-studio-aca-mi) for Microsoft Copilot Studio.
|
|
75
|
+
|
|
62
76
|
# Usage
|
|
63
77
|
|
|
64
78
|
## Getting Started
|
|
@@ -76,13 +90,21 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
|
|
|
76
90
|
|
|
77
91
|
✨ The Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:
|
|
78
92
|
|
|
79
|
-
### 🧮
|
|
93
|
+
### 🧮 Microsoft Foundry
|
|
80
94
|
|
|
81
|
-
* List
|
|
82
|
-
* Deploy
|
|
83
|
-
* List
|
|
95
|
+
* List Microsoft Foundry models
|
|
96
|
+
* Deploy Microsoft Foundry models
|
|
97
|
+
* List Microsoft Foundry model deployments
|
|
84
98
|
* List knowledge indexes
|
|
85
99
|
* Get knowledge index schema configuration
|
|
100
|
+
* Create Microsoft Foundry agents
|
|
101
|
+
* List Microsoft Foundry agents
|
|
102
|
+
* Connect and query Microsoft Foundry agents
|
|
103
|
+
* Evaluate Microsoft Foundry agents
|
|
104
|
+
* Get SDK samples for interacting with Microsoft Foundry agent
|
|
105
|
+
* Create Microsoft Foundry agent threads
|
|
106
|
+
* List Microsoft Foundry agent threads
|
|
107
|
+
* Get messages of a Microsoft Foundry thread
|
|
86
108
|
|
|
87
109
|
### 🔎 Azure AI Search
|
|
88
110
|
|
|
@@ -95,6 +117,9 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
|
|
|
95
117
|
* "Recognize speech from my audio file with language detection"
|
|
96
118
|
* "Transcribe speech from audio with profanity filtering"
|
|
97
119
|
* "Transcribe audio with phrase hints for better accuracy"
|
|
120
|
+
* "Convert text to speech and save to output.wav"
|
|
121
|
+
* "Synthesize speech from 'Hello, welcome to Azure' with Spanish voice"
|
|
122
|
+
* "Generate MP3 audio from text with high quality format"
|
|
98
123
|
|
|
99
124
|
### ⚙️ Azure App Configuration
|
|
100
125
|
|
|
@@ -170,6 +195,26 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
|
|
|
170
195
|
* "Publish an event with data '{\"name\": \"test\"}' to topic 'my-topic' using CloudEvents schema"
|
|
171
196
|
* "Send custom event data to Event Grid topic 'analytics-events' with EventGrid schema"
|
|
172
197
|
|
|
198
|
+
### 📂 Azure File Shares
|
|
199
|
+
|
|
200
|
+
* "Get details about a specific file share in my resource group"
|
|
201
|
+
* "Create a new Azure managed file share with NFS protocol"
|
|
202
|
+
* "Create a file share with 64 GiB storage, 3000 IOPS, and 125 MiB/s throughput"
|
|
203
|
+
* "Update the provisioned storage size of my file share"
|
|
204
|
+
* "Update network access settings for my file share"
|
|
205
|
+
* "Delete a file share from my resource group"
|
|
206
|
+
* "Check if a file share name is available"
|
|
207
|
+
* "Get details about a file share snapshot"
|
|
208
|
+
* "Create a snapshot of my file share"
|
|
209
|
+
* "Update tags on a file share snapshot"
|
|
210
|
+
* "Delete a file share snapshot"
|
|
211
|
+
* "Get a private endpoint connection for my file share"
|
|
212
|
+
* "Update private endpoint connection status to Approved"
|
|
213
|
+
* "Delete a private endpoint connection"
|
|
214
|
+
* "Get file share limits and quotas for a region"
|
|
215
|
+
* "Get provisioning recommendations for my file share workload"
|
|
216
|
+
* "Get usage data and metrics for my file share"
|
|
217
|
+
|
|
173
218
|
### 🔑 Azure Key Vault
|
|
174
219
|
|
|
175
220
|
* "List all secrets in my key vault 'my-vault'"
|
|
@@ -232,11 +277,11 @@ All Azure MCP tools in a single server. The Azure MCP Server implements the [MCP
|
|
|
232
277
|
|
|
233
278
|
## Complete List of Supported Azure Services
|
|
234
279
|
|
|
235
|
-
The Azure MCP Server provides tools for interacting with **
|
|
280
|
+
The Azure MCP Server provides tools for interacting with **41+ Azure service areas**:
|
|
236
281
|
|
|
237
|
-
- 🧮 **
|
|
282
|
+
- 🧮 **Microsoft Foundry** - AI model management, AI model deployment, and knowledge index management
|
|
238
283
|
- 🔎 **Azure AI Search** - Search engine/vector database operations
|
|
239
|
-
- 🎤 **Azure AI Services Speech** - Speech-to-text recognition
|
|
284
|
+
- 🎤 **Azure AI Services Speech** - Speech-to-text recognition and text-to-speech synthesis
|
|
240
285
|
- ⚙️ **Azure App Configuration** - Configuration management
|
|
241
286
|
- 🕸️ **Azure App Service** - Web app hosting
|
|
242
287
|
- 🛡️ **Azure Best Practices** - Secure, production-grade guidance
|
|
@@ -250,6 +295,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
|
|
|
250
295
|
- 🐬 **Azure Database for MySQL** - MySQL database management
|
|
251
296
|
- 🐘 **Azure Database for PostgreSQL** - PostgreSQL database management
|
|
252
297
|
- 📊 **Azure Event Grid** - Event routing and management
|
|
298
|
+
- � **Azure File Shares** - Azure managed file share operations
|
|
253
299
|
- ⚡ **Azure Functions** - Function App management
|
|
254
300
|
- 🔑 **Azure Key Vault** - Secrets, keys, and certificates
|
|
255
301
|
- ☸️ **Azure Kubernetes Service (AKS)** - Container orchestration
|
|
@@ -258,6 +304,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
|
|
|
258
304
|
- 🗃️ **Azure Managed Lustre** - High-performance Lustre filesystem operations
|
|
259
305
|
- 🏪 **Azure Marketplace** - Product discovery
|
|
260
306
|
- 📈 **Azure Monitor** - Logging, metrics, and health monitoring
|
|
307
|
+
- ⚖️ **Azure Policy** - Policies set to enforce organizational standards
|
|
261
308
|
- ⚙️ **Azure Native ISV Services** - Third-party integrations
|
|
262
309
|
- 🛡️ **Azure Quick Review CLI** - Compliance scanning
|
|
263
310
|
- 📊 **Azure Quota** - Resource quota and usage management
|
|
@@ -270,6 +317,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
|
|
|
270
317
|
- 🗄️ **Azure SQL Elastic Pool** - Database resource sharing
|
|
271
318
|
- 🗄️ **Azure SQL Server** - Server administration
|
|
272
319
|
- 💾 **Azure Storage** - Blob storage
|
|
320
|
+
- **Azure Storage Sync** - Azure File Sync management operations
|
|
273
321
|
- 📋 **Azure Subscription** - Subscription management
|
|
274
322
|
- 🏗️ **Azure Terraform Best Practices** - Infrastructure as code guidance
|
|
275
323
|
- 🖥️ **Azure Virtual Desktop** - Virtual desktop infrastructure
|
|
@@ -287,6 +335,7 @@ The Azure MCP Server provides tools for interacting with **40+ Azure service are
|
|
|
287
335
|
## Feedback and Support
|
|
288
336
|
|
|
289
337
|
- Check the [Troubleshooting guide](https://aka.ms/azmcp/troubleshooting) to diagnose and resolve common issues with the Azure MCP Server.
|
|
338
|
+
- For advanced troubleshooting, you can enable [support logging](https://github.com/microsoft/mcp/blob/main/servers/Azure.Mcp.Server/TROUBLESHOOTING.md#support-logging) using the `--dangerously-write-support-logs-to-dir` option.
|
|
290
339
|
- We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server.
|
|
291
340
|
- 👉 [Open an issue](https://github.com/microsoft/mcp/issues) in the public GitHub repository — we’d love to hear from you!
|
|
292
341
|
|
|
@@ -308,9 +357,27 @@ The software may collect information about you and your use of the software and
|
|
|
308
357
|
|
|
309
358
|
### Telemetry Configuration
|
|
310
359
|
|
|
311
|
-
Telemetry collection is on by default.
|
|
360
|
+
Telemetry collection is on by default. The server supports two telemetry streams:
|
|
361
|
+
|
|
362
|
+
1. **User-provided telemetry**: If you configure your own Application Insights connection string via the `APPLICATIONINSIGHTS_CONNECTION_STRING` environment variable, telemetry will be sent to your Application Insights resource.
|
|
363
|
+
|
|
364
|
+
2. **Microsoft telemetry**: By default, telemetry is also sent to Microsoft to help improve the product. This can be disabled separately from user-provided telemetry. See [Disabling All Telemetry](#disabling-all-telemetry) section below for more details.
|
|
365
|
+
|
|
366
|
+
#### Disabling All Telemetry
|
|
367
|
+
|
|
368
|
+
To disable all telemetry collection (both user-provided and Microsoft), set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false`:
|
|
369
|
+
|
|
370
|
+
```bash
|
|
371
|
+
export AZURE_MCP_COLLECT_TELEMETRY=false
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
#### Disabling Microsoft Telemetry Only
|
|
375
|
+
|
|
376
|
+
To disable only Microsoft telemetry collection while keeping your own Application Insights telemetry active, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY_MICROSOFT` to `false`:
|
|
312
377
|
|
|
313
|
-
|
|
378
|
+
```bash
|
|
379
|
+
export AZURE_MCP_COLLECT_TELEMETRY_MICROSOFT=false
|
|
380
|
+
```
|
|
314
381
|
|
|
315
382
|
## Compliance Responsibility
|
|
316
383
|
|
package/dist/azmcp
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@azure/mcp-linux-arm64",
|
|
3
|
-
"version": "2.0.0-beta.
|
|
3
|
+
"version": "2.0.0-beta.11",
|
|
4
4
|
"description": "Azure MCP Server - Model Context Protocol implementation for Azure, for linux on arm64",
|
|
5
5
|
"author": "Microsoft",
|
|
6
6
|
"homepage": "https://github.com/Microsoft/mcp/blob/main/servers/Azure.Mcp.Server#readme",
|
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
"url": "https://github.com/microsoft/mcp/issues"
|
|
15
15
|
},
|
|
16
16
|
"repository": {
|
|
17
|
-
"
|
|
18
|
-
"
|
|
17
|
+
"type": "git",
|
|
18
|
+
"url": "https://github.com/microsoft/mcp.git"
|
|
19
19
|
},
|
|
20
20
|
"engines": {
|
|
21
21
|
"node": ">=20.0.0"
|
|
@@ -29,5 +29,6 @@
|
|
|
29
29
|
],
|
|
30
30
|
"cpu": [
|
|
31
31
|
"arm64"
|
|
32
|
-
]
|
|
32
|
+
],
|
|
33
|
+
"mcpName": "com.microsoft/azure"
|
|
33
34
|
}
|