Azure MCP (Model Context Protocol) für Claude Desktop

Eine MCP-Implementierung (Model Context Protocol), die Claude Desktop die Interaktion mit Azure-Diensten ermöglicht. Diese Integration ermöglicht Claude die direkte Abfrage und Verwaltung von Azure-Ressourcen über natürliche Sprachkonversationen.

Merkmale

• Azure Resource Management : Schnittstelle zum Azure Resource Management-Client

• Abonnementverwaltung : Auflisten und Verwalten von Azure-Abonnements

• Mandantenverwaltung : Azure-Mandanten auflisten und auswählen

• Automatische Authentifizierung : Nutzt DefaultAzureCredential für flexible Authentifizierungsmethoden

• Fehlerbehandlung : Robuste Fehlerbehandlung mit Wiederholungsversuchen bei vorübergehenden Fehlern

• Saubere Antwortformatierung : Richtig formatierte Antworten, kompatibel mit Claude Desktop

Voraussetzungen

• Node.js (v18 oder höher)

• Claude Desktop-Anwendung

• Azure-Konto mit entsprechenden Berechtigungen

• Azure CLI (optional, für CLI-basierte Authentifizierung)

Installation

Manuelle Installation

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

3. Claude Desktop konfigurieren:

   • Öffnen Sie claude_desktop_config.json

   • Fügen Sie die folgende MCP-Konfiguration hinzu:

Authentifizierung

Der Server unterstützt mehrere Authentifizierungsmethoden über DefaultAzureCredential:

• Umgebungsvariablen

• Verwaltete Identität

• Azure-Befehlszeilenschnittstelle

• Visual Studio Code

• Interaktiver Browser

Der Server probiert diese Methoden automatisch der Reihe nach aus, bis eine erfolgreich ist.

Verwendung

1. Schließen Sie Claude Desktop, falls es ausgeführt wird (überprüfen Sie den Task-Manager).

2. Starten Sie Claude Desktop

3. Im Chat können Sie jetzt Azure-bezogene Fragen stellen wie:

   • „Können Sie alle verfügbaren Azure-Konten und -Abonnements abrufen?“

   • „Alle Ressourcengruppen in meinem Abonnement auflisten“

   • „Zeigen Sie mir alle virtuellen Maschinen in einer bestimmten Ressourcengruppe“

Beispielgespräch

Entwicklung

Projektstruktur

Schlüsselkomponenten

• AzureMCPServer : Hauptserverklasse, die das MCP-Protokoll implementiert

• HandleCallTool : Verarbeitet eingehende Tool-Anfragen

• ExecuteWithRetry : Implementiert Wiederholungslogik für belastbare Vorgänge

Fehlerbehebung

1. Authentifizierungsprobleme :

   • Stellen Sie sicher, dass Sie über Azure CLI ( az login ) angemeldet sind.

   • Überprüfen Sie die Umgebungsvariablen, wenn Sie den Dienstprinzipal verwenden

   • Überprüfen Sie, ob Ihr Azure-Konto über die erforderlichen Berechtigungen verfügt.

2. Verbindungsprobleme :

   • Überprüfen Sie die Claude Desktop-Konfiguration

   • Überprüfen Sie, ob die Pfade in der Konfigurationsdatei mit Ihrer Installation übereinstimmen

   • Stellen Sie sicher, dass keine anderen Instanzen ausgeführt werden

3. Häufige Fehler :

   • NO_TENANT : Wählen Sie einen Mieter mit dem Tool „Mandanten auswählen“ aus

   • NO_CLIENTS : Stellen Sie eine ordnungsgemäße Initialisierung und Authentifizierung sicher

   • CODE_EXECUTION_FAILED : Überprüfen Sie die Azure-Berechtigungen und -Verbindung

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Mitwirkende

• @calclavia – Integration mit smithery.ai

Danksagung

• Claude Desktop-Team für die MCP-Implementierung

• Azure SDK-Team für das umfassende SDK

• Model Context Protocol zur Ermöglichung der Integration von KI-Diensten

Sicherheitshinweis

Diese Implementierung folgt den bewährten Methoden der Azure-Sicherheit:

• Keine fest codierten Anmeldeinformationen

• Sichere Implementierung der Anmeldeinformationskette

• Richtige Fehlerbehandlung und -bereinigung

Bei Sicherheitsbedenken oder Schwachstellen erstellen Sie bitte ein Problem.