Azure MCP-Server

🌟 Azure MCP-Server

Der Azure MCP-Server implementiert die MCP-Spezifikation , um eine nahtlose Verbindung zwischen KI-Agenten und wichtigen Azure-Diensten wie Azure Storage, Cosmos DB und mehr herzustellen.

Bitte beachten Sie, dass sich dieses Projekt in der öffentlichen Vorschau befindet und sich die Implementierung vor unserer allgemeinen Verfügbarkeit erheblich ändern kann.

📑 Inhaltsverzeichnis

🎯 Übersicht

✨ Was können Sie mit dem Azure MCP-Server tun?

Der Azure MCP-Server erweitert Ihre Agenten um Azure-Kontext. Hier sind einige nützliche Eingabeaufforderungen, die Sie ausprobieren können:

🔍 Entdecken Sie Ihre Azure-Ressourcen

„Meine Azure-Speicherkonten auflisten“
„Zeigen Sie mir alle meine Cosmos DB-Datenbanken“
„Welche Indizes habe ich in meinem Azure AI Search-Dienst ‚mysvc‘?“
„Meine Ressourcengruppen auflisten“
„Zeigen Sie mir die Tabellen in meinem Speicherkonto“
„Container in meiner Cosmos DB-Datenbank auflisten“
„Details zu meinem Lagercontainer erhalten“
„Kusto-Datenbanken im Cluster ‚mycluster‘ abrufen“
„Beispiel: 10 Zeilen aus der Tabelle ‚StormEvents‘ in der Kusto-Datenbank ‚db1‘“

📊 Abfragen und Analysieren

„Meinen Log Analytics-Arbeitsbereich abfragen“
„Durchsuchen wir diesen Index nach ‚meiner Suchanfrage‘.“

⚙️ Konfiguration verwalten

„Meine App Configuration Stores auflisten“
„Meine Schlüssel-Wert-Paare in der App-Konfiguration anzeigen“

🔧 Erweiterte Azure-Operationen

„Meine Azure CDN-Endpunkte auflisten“
„Helfen Sie mir, eine Azure-Anwendung mit Node.js zu erstellen.“

🔍 So funktioniert es

Der Azure MCP-Server ermöglicht eine nahtlose Integration zwischen KI-Agenten und Azure-Diensten durch:

🔄 Intelligente JSON-Kommunikation, die KI-Agenten verstehen
🏗️ Natürliche Sprachbefehle, die in Azure-Operationen übersetzt werden
💡 Intelligente Parametervorschläge und Autovervollständigung
⚡ Konsistente und sinnvolle Fehlerbehandlung

🛠️ Derzeit unterstützte Tools

Der Azure MCP-Server bietet Tools für die Interaktion mit den folgenden Azure-Diensten:

🔎 Azure AI Search (Suchmaschine/Vektordatenbank)

Auflisten der Azure AI Search-Dienste
Listen Sie Indizes auf und sehen Sie sich deren Schema und Konfiguration an
Suchindizes abfragen

📊 Azure Cosmos DB (NoSQL-Datenbanken)

Auflisten von Cosmos DB-Konten
Auflisten und Abfragen von Datenbanken
Verwalten von Containern und Artikeln
Ausführen von SQL-Abfragen für Container

🐘 Azure-Datenbank für PostgreSQL – Flexibler Server

Datenbanken auflisten und abfragen.
Listen Sie Tabellen auf und rufen Sie deren Schema ab.
Auflisten, Konfiguration abrufen und Parameter für Server abrufen.

🧮 Kusto (Azure Data Explorer)

Auflisten von Kusto-Clustern
Auflisten von Datenbanken in einem Kusto-Cluster
Auflisten von Tabellen in einer Kusto-Datenbank
Abrufen des Schemas für eine Kusto-Tabelle
Beispielzeilen aus einer Kusto-Tabelle
Abfragen von Kusto-Datenbanken mit KQL

💾 Azure-Speicher

Auflisten von Speicherkonten
Verwalten von Blobcontainern und Blobs
Auflisten und Abfragen von Speichertabellen
Abrufen von Containereigenschaften und Metadaten

📈 Azure Monitor (Log Analytics)

Auflisten von Log Analytics-Arbeitsbereichen
Abfrageprotokolle mit KQL
Verfügbare Tabellen auflisten

⚙️ Azure App-Konfiguration

Auflisten von App Configuration-Speichern
Schlüssel-Wert-Paare verwalten
Beschriftete Konfigurationen handhaben
Konfigurationseinstellungen sperren/entsperren

🔑 Azure-Schlüsseltresor

Schlüssel auflisten, erstellen und abrufen

📦 Azure-Ressourcengruppen

Auflisten von Ressourcengruppen

🚌 Azure Service Bus

Untersuchen Sie Eigenschaften und Laufzeitinformationen zu Warteschlangen, Themen und Abonnements

🔧 Azure CLI-Erweiterung

Führen Sie Azure CLI-Befehle direkt aus
Unterstützung für alle Azure CLI-Funktionen
JSON-Ausgabeformatierung
Plattformübergreifende Kompatibilität

🚀 Azure Developer CLI (azd)-Erweiterung

Führen Sie Azure Developer CLI-Befehle direkt aus
Unterstützung für Vorlagenerkennung, Vorlageninitialisierung, Bereitstellung und Einsatz
Plattformübergreifende Kompatibilität

Agenten und Modelle können Best Practices und Nutzungsrichtlinien für das azd MCP-Tool entdecken und erlernen. Weitere Informationen finden Sie unter AZD Best Practices .

🛡️ Azure Best Practices

Holen Sie sich bewährte Methoden für sicheres, produktionsreifes Azure SDK zur effektiven Codegenerierung.

Eine ausführliche Befehlsdokumentation und Beispiele finden Sie unter Azure MCP-Befehle .

🔌 Erste Schritte

Für die Installation und Ausführung des Azure MCP-Servers ist Node.js erforderlich. Falls Sie Node.js nicht installiert haben, folgen Sie den Anweisungen hier .

VS Code + GitHub Copilot

Der Azure MCP-Server bietet Azure SDK- und Azure CLI-Entwicklertools. Er kann allein oder mit der GitHub Copilot für Azure-Erweiterung in VS Code verwendet werden. Wenn Sie an umfassender Entwicklerunterstützung für verschiedene Azure-Entwicklungsszenarien interessiert sind, die nicht im Azure MCP-Server enthalten sind, z. B. für die Suche nach Dokumentation in Microsoft Learn, empfehlen wir diese Erweiterung ebenfalls.

Voraussetzungen

Installieren Sie entweder die stabile oder die Insider-Version von VS Code:
- 💫 Stabile Version
- 🔮 Insider-Veröffentlichung
Installieren Sie die Erweiterungen GitHub Copilot und GitHub Copilot Chat
Installieren Sie Node.js 20 oder höher
- Stellen Sie sicher, dass sich node und npm in Ihrem Pfad befinden.
Öffnen Sie VS Code in einem leeren Ordner

Installation

✨ Ein-Klick-Installation

Klicken Sie auf eine dieser Schaltflächen, um den Azure MCP-Server für VS Code oder VS Code Insiders zu installieren.

Nachdem Sie den Azure MCP-Server installiert haben, wählen Sie den GitHub Copilot-Agentmodus aus und aktualisieren Sie die Toolliste. Weitere Informationen zum Agentmodus finden Sie in der VS Code-Dokumentation .

🔧 Manuelle Installation

Befolgen Sie für eine schrittweise Installation diese Anweisungen:

Fügen Sie .vscode/mcp.json hinzu:

{
  "servers": {
    "Azure MCP Server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure/mcp@latest",
        "server",
        "start"
      ]
    }
  }
}

Docker-Installation

Befolgen Sie für eine schrittweise Installation diese Anweisungen:

Repository klonen
Erstellen Sie das Docker-Image aus dem Stammverzeichnis des Repositorys: docker build -t azure/azuremcp .
Erstellen Sie eine .env Datei mit Umgebungsvariablen, die einem der EnvironmentCredential Sets entsprechen . Eine .env Datei mit einem Dienstprinzipal könnte beispielsweise wie folgt aussehen:

AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}
AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}
AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}

Fügen Sie .vscode/mcp.json hinzu oder aktualisieren Sie die vorhandene MCP-Konfiguration. Ersetzen Sie /full/path/to/.env durch einen Pfad zu Ihrer .env Datei.

{
  "servers": {
    "Azure MCP Server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "azure/azuremcp",
        "--env-file",
        "/full/path/to/.env"
      ]
    }
  }
}

Optional können Kunden --env oder --volume verwenden, um Authentifizierungswerte zu übergeben.

🧪 Testen des Azure MCP-Servers

Öffnen Sie GitHub Copilot in VS Code und wechseln Sie in den Agentenmodus
Sie sollten den Azure MCP-Server in der Liste der Tools sehen
Versuchen Sie es mit einer Eingabeaufforderung, die den Agenten anweist, den Azure MCP-Server zu verwenden, z. B. „Meine Azure Storage-Container auflisten“.
Der Agent sollte in der Lage sein, die Azure MCP Server-Tools zu verwenden, um Ihre Abfrage abzuschließen

🤖 Benutzerdefinierte MCP-Clients

Sie können Ihren MCP-Client ganz einfach für die Verwendung des Azure MCP-Servers konfigurieren. Lassen Sie Ihren Client den folgenden Befehl ausführen und über Standard-E/A oder SSE darauf zugreifen.

Verwenden von Standard-IO

Konfigurieren Sie den MCP-Client für die Ausführung von: npx -y @azure/mcp@latest server start . Anweisungen zur Verwendung von VS Code finden Sie in der Ein-Klick-Installation oder der manuellen Installation .

Verwenden von SSE

Öffnen Sie ein Terminalfenster und führen Sie Folgendes aus: npx -y @azure/mcp@latest server start --transport sse
Der Server wird gestartet und unter folgender Adresse gehostet: http://localhost:5008 . Um einen anderen Port zu verwenden, hängen Sie --port {YOUR-PORT-NUMBER} an.
Öffnen Sie Ihren MCP-Client und fügen Sie den SSE-Konfigurationswert hinzu. Dieser kann je nach MCP-Client unterschiedlich sein. In VS Code sieht er folgendermaßen aus:
{ "servers": { "Azure MCP Server": { "type": "sse", "url": "http://localhost:5008/sse" } } }

Weitere End-to-End-Anleitungen für MCP-Clients/Agenten folgen in Kürze!

📝 Fehlerbehebung

Hilfe zu häufigen Problemen und zur Protokollierung finden Sie im Handbuch zur Fehlerbehebung .

🔑 Authentifizierung

Der Azure MCP-Server integriert sich nahtlos in die Authentifizierungsmechanismen Ihres Host-Betriebssystems und erleichtert so den Einstieg! Wir verwenden Azure Identity im Hintergrund über DefaultAzureCredential , das diese Anmeldeinformationen der Reihe nach ausprobiert:

Umgebungsvariablen ( EnvironmentCredential ) – Perfekt für CI/CD-Pipelines
Shared Token Cache ( SharedTokenCacheCredential ) - Verwendet zwischengespeicherte Token von anderen Tools
Visual Studio ( VisualStudioCredential ) – Verwendet Ihre Visual Studio-Anmeldeinformationen
Azure CLI ( AzureCliCredential ) – Verwendet Ihre vorhandenen Azure CLI-Anmeldeinformationen
Azure PowerShell ( AzurePowerShellCredential ) – Verwendet Ihre Az PowerShell-Anmeldung
Azure Developer CLI ( AzureDeveloperCliCredential ) – Verwendet Ihre Azd-Anmeldung
Interaktiver Browser ( InteractiveBrowserCredential ) – Fällt bei Bedarf auf die browserbasierte Anmeldung zurück

Wenn Sie bereits über eine dieser Methoden angemeldet sind, verwendet der Azure MCP-Server diese Anmeldeinformationen automatisch. Stellen Sie sicher, dass Sie über die korrekten Autorisierungsberechtigungen in Azure (z. B. Lesezugriff auf Ihr Speicherkonto) über RBAC (rollenbasierte Zugriffssteuerung) verfügen. Weitere Informationen zum RBAC-Autorisierungssystem von Azure finden Sie unter diesem Link .

Wenn bei der Authentifizierung Probleme auftreten, lesen Sie unseren Leitfaden zur Fehlerbehebung .

Produktionsnachweise

Standardmäßig schließt der Azure MCP-Server Produktionsanmeldeinformationen wie verwaltete Identität und Workloadidentität aus. Um diese Anmeldeinformationen zu aktivieren, legen Sie die Umgebungsvariable fest:

AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true

Dies ist nützlich, wenn Sie Azure-Dienste ausführen, bei denen Sie verwaltete Identitäten verwenden möchten.

🛡️ Sicherheitshinweis

Ihre Anmeldeinformationen werden immer sicher über das offizielle Azure Identity SDK behandelt – wir speichern oder verwalten Token niemals direkt .

MCP ist ein neuartiges und hochaktuelles Phänomen. Wie bei allen neuen Technologiestandards sollten Sie eine Sicherheitsüberprüfung durchführen, um sicherzustellen, dass alle Systeme, die mit MCP-Servern integriert werden, alle Vorschriften und Standards erfüllen, die Ihr System einhalten muss. Dies gilt nicht nur für den Azure MCP-Server, sondern auch für alle MCP-Clients/-Agents, die Sie implementieren, bis hin zum Modellanbieter.

👥 Beitragen

Wir freuen uns über Beiträge zum Azure MCP-Server! Egal, ob Sie Fehler beheben, neue Funktionen hinzufügen oder die Dokumentation verbessern – Ihre Beiträge sind willkommen.

Bitte lesen Sie unseren Leitfaden für Beiträge mit Richtlinien zu:

🛠️ Einrichten Ihrer Entwicklungsumgebung
✨ Neue Befehle hinzufügen
📝 Codestil und Testanforderungen
🔄 Pull Requests erstellen

🤝 Verhaltenskodex

Dieses Projekt folgt dem Microsoft Open Source-Verhaltenskodex . Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex . Bei Fragen oder Anmerkungen wenden Sie sich bitte an opencode@microsoft.com .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.