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
- Klonen Sie das Repository:
- Installieren Sie Abhängigkeiten:
- Claude Desktop konfigurieren:
- Öffnen Sie
claude_desktop_config.json
- Fügen Sie die folgende MCP-Konfiguration hinzu:
- Öffnen Sie
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
- Schließen Sie Claude Desktop, falls es ausgeführt wird (überprüfen Sie den Task-Manager).
- Starten Sie Claude Desktop
- 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
- 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.
- Stellen Sie sicher, dass Sie über Azure CLI (
- 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
- Häufige Fehler :
NO_TENANT
: Wählen Sie einen Mieter mit dem Tool „Mandanten auswählen“ ausNO_CLIENTS
: Stellen Sie eine ordnungsgemäße Initialisierung und Authentifizierung sicherCODE_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.
You must be authenticated.
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.
Ermöglicht die Interaktion mit Azure-Diensten in natürlicher Sprache über Claude Desktop und unterstützt die Ressourcenverwaltung, die Abonnementverwaltung und die Mandantenauswahl mit sicherer Authentifizierung.
- Merkmale
- Voraussetzungen
- Installation
- Authentifizierung
- Verwendung
- Entwicklung
- Fehlerbehebung
- Beitragen
- Mitwirkende
- Danksagung
- Sicherheitshinweis
Related Resources
Related MCP Servers
- -securityAlicense-qualityLets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things on your Cloudflare account.Last updated -8672,200TypeScriptApache 2.0
- -securityAlicense-qualityA server that enables LLMs like Claude to interact with Azure Cosmos DB databases through natural language queries, acting as a translator between AI assistants and database systems.Last updated -JavaScriptMIT License
- AsecurityAlicenseAqualityA server that enables LLMs (like Claude and VSCode Copilot) to interact with Azure Cosmos DB data through natural language queries, acting as a translator between AI assistants and your database.Last updated -3751JavaScriptMIT License
- -security-license-qualityEnables large language models to automatically report customer-facing issues with Azure resources by parsing natural language requests and submitting impact reports through the Azure Management API.Last updated -2Python