Azure MCP-Servertools für Azure IoT Hub

Mit dem Azure Model Context Protocol (MCP)-Server können Sie Azure IoT Hub Ressourcen mit Aufforderungen in natürlicher Sprache verwalten. Sie können registrierte Geräte auflisten und Details zu einem IoT-Hub abrufen.

Azure IoT Hub ermöglicht eine sichere, bidirektionale Kommunikation zwischen IoT-Geräten und Cloud-Back-Ends. Weitere Informationen finden Sie in Azure IoT Hub Dokumentation.

Note

Toolparameter: Die Azure MCP Server-Tools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden hier dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Gerät: Liste

Listet Geräteidentitätsmetadaten in einer Azure IoT Hub Geräteregistrierung auf, ohne Authentifizierungsschlüssel zurückzugeben. Verwenden Sie den Parameter "Max count", um die Ergebnisse zu begrenzen. Der Standardwert und der Maximalwert sind 100; größere Werte geben einen Fehler zurück. Falls weitere Geräte vorhanden sind, setzt die Antwort truncated=true. Bei Hubnamen und IDs wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen exakt übereinstimmen.

Beispiel-CLI-Befehl

azmcp iothub device list \
  --hub-name <hub-name> \
  --resource-group <resource-group> \
  [--max-count <max-count>]
Parameter Typ Erforderlich Description
hub-name Zeichenfolge Yes Der Name des IoT Hub.
resource-group Zeichenfolge Yes Der Azure-Ressourcengruppenname.
max-count Zeichenfolge No Die maximale Anzahl von Elementen, die pro Seite zurückgegeben werden sollen. Falls nicht angegeben, wird standardmäßig 100 verwendet. Werte, die größer als 100 sind, werden mit einem Fehler abgelehnt.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Geheimnis Vor Ort erforderlich
❌ ❌ ❌ ✅ ❌ ❌

Hub: Abrufen

Ruft die Details eines Azure IoT Hubs anhand seines Namens in einer Ressourcengruppe und einem Abonnement ab. Gibt die id, name, location, resourceGroup, subscriptionId, sku, capacity, hostName und state des IoT-Hubs zurück.

Beispiel-CLI-Befehl

azmcp iothub hub get \
  --hub-name <hub-name> \
  --resource-group <resource-group>
Parameter Typ Erforderlich Description
hub-name Zeichenfolge Yes Der Name des IoT Hub.
resource-group Zeichenfolge Yes Der Azure-Ressourcengruppenname.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Geheimnis Vor Ort erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Verwandte Inhalte

  • Last updated on