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

Related MCP server: Cloud PC Management MCP Server

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:

git clone https://github.com/Streen9/azure-mcp.git
cd azure-mcp

2. Installieren Sie Abhängigkeiten:

npm install

3. Claude Desktop konfigurieren:

   • Öffnen Sie claude_desktop_config.json

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

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "azure": {
      "command": "tsx",
      "args": [
        "C:/Users/[YourUsername]/path/to/azure-mcp/src/launcher.ts"
      ]
    }
  }
}

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

You: Can you get all the available Azure accounts and subscriptions?
Claude: I'll help you list all available Azure tenants and subscriptions.
[Claude will then use the Azure MCP to fetch and display the information]

Entwicklung

Projektstruktur

azure-mcp/
├── src/
│   ├── launcher.ts       # Server entry point
│   ├── AzureServer.ts    # Main MCP server implementation
│   └── LoggerService.ts  # Logging utility
├── package.json
└── README.md

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.