Zum Hauptinhalt springen

MCP-Werkzeugreferenz

MCP stellt fünf Werkzeuge bereit: tool_list, tool_info, tool_call, skill_list, skill_read für Namen von Geschäftswerkzeugen, Definitionen, Geschäftsaufrufe, den Skill-Katalog und Skill-Dokumente. Das Verzeichnis dient bei Bedarf zur Navigation. Geschäftsabfragen, Änderungen und Geräteaktionen nutzen tool_call mit erforderlichem tool. Rufen Sie bekannte Operationen direkt auf; Skills und Referenzdokumente werden nach Bedarf gelesen. args ist ein optionales Objekt mit Geschäftsparametern.

WerkzeugBeschreibungWirkung
tool_listLiefert Namen von Geschäftswerkzeugen, optional nach Kategorie gefiltert.Nur Lesen
tool_infoLiefert Beschreibungen, Parameterschemata und Wirkungen ausgewählter Werkzeuge ohne Geschäftsausführung.Nur Lesen
tool_callRuft ein Geschäftswerkzeug zum Lesen, Ändern oder Bedienen von Geräten auf.Abhängig vom Geschäftswerkzeug
skill_listLiefert Namen und Beschreibungen integrierter Skills mit Lese- und Downloadhinweisen.Nur Lesen
skill_readLiest die Hauptdatei oder eine Referenzdatei eines Skills mit Seitennavigation.Nur Lesen

Aufrufbeispiele​

  • tool_list({}): Liefert version und die sortierte Namensliste tools.
  • tool_list({category:"devices"}): Filtert Werkzeugnamen nach category.
  • tool_info({tools:"backend_list_devices"}): Beschreibt die Nutzung eines einzelnen Werkzeugs, ohne es auszuführen.
  • tool_info({tools:["backend_list_devices","device_get_status"]}): Beschreibt mehrere benötigte Werkzeuge, ohne sie auszuführen. Das Ergebnis ist ein Array tools; jeder Eintrag enthält die interne ID tool, description, inputSchema (für tool_call.args) und readOnly. tools akzeptiert eine nicht leere Zeichenfolge oder ein nicht leeres Array von Zeichenfolgen, ohne feste Größenbegrenzung pro Stapel.
  • tool_call({tool:"backend_list_devices",args:{limit:10}}): Ruft ein bekanntes Werkzeug direkt auf, um die benötigte Geräteliste zu lesen.
  • skill_list({}): Listet Skill-Namen, Beschreibungen und readCall-Hinweise auf.
  • skill_read({skill:"xxtlancontrol"}): Liest den Haupt-Skill bei bekanntem Namen direkt; path ist standardmäßig SKILL.md.
  • skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Liest einen Ablauf über einen relativen Link im Haupt-Skill; cursor / maxBytes ermöglichen Seitennavigation.

Anwendungs-Aufrufhinweise readCall, infoCall und listCall verwenden {name,args}; name bezeichnet ein öffentliches MCP-Werkzeug. Skill-IDs stehen im Katalog unter skills[].skill und im Leseergebnis unter data.skill.

Jeder Eintrag von skill_list enthält downloadUrl, eine vollständige URL der aktuellen Zentrale für das gesamte Skill-ZIP. skill_read liefert den Text der gewählten Datei und zusätzlich den Downloadlink für das vollständige Skill-Paket. Das ZIP enthält Hauptdokument, Referenzen und mitgelieferte Skripte, Vorlagen und Materialien. Zum Herunterladen reichen die Katalogmetadaten; vorhandene Links können ohne Lesen des Textes oder erneutes Auflisten direkt verwendet werden.

Bei unbekannten Namen sehen Sie tool_list nach Kategorie durch. Bei unklaren Parametern laden Sie die benötigten Definitionen gemeinsam mit tool_info und verwenden anschließend tool_call. Bekannte Werkzeuge können ohne vorheriges Lesen des Verzeichnisses oder der Definitionen direkt aufgerufen werden.

Fragen Sie nach Erhalt einer Batch-Aufgaben-ID den Status und die fehlgeschlagenen Einträge ab. Verbinden Sie MCP nach einem Update der Zentrale erneut.

Shell-Befehl auf einem Gerät ausführen​

Aktivieren und speichern Sie in den MCP-Einstellungen Ausführung von Shell-Befehlen auf Geräten erlauben, um Shell-Befehle auf einem Gerät auszuführen. Standardmäßig ist die Option ausgeschaltet. Nach dem Ausschalten und Speichern wird das Werkzeug in allen MCP-Sitzungen ausgeblendet und neue Aufrufe werden abgewiesen.

command ist eine vollständige Befehlszeile mit bis zu 16384 Zeichen, die die Geräte-Shell mit -c ausführt. Das Ergebnis enthält den Exitcode, stdout, stderr und bei einer roothide-Shell einen Hinweis zu den Pfaden.

Die Standardlaufzeit für einen Befehl beträgt höchstens 10 Sekunden. Für längere Befehle setzen Sie timeoutMs (z. B. 300000 für 5 Minuten) und wählen im MCP-Client ein ausreichend langes Zeitlimit. Der Controller verlängert die Laufzeit von aux beim Start und tauscht alle 30 Sekunden ein Lebenszeichen mit dem Gerät aus. Nach Abschluss der letzten Aufgabe beendet sich aux nach 180 Sekunden Inaktivität.

{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}