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.
| Werkzeug | Beschreibung | Wirkung |
|---|---|---|
tool_list | Liefert Namen von Geschäftswerkzeugen, optional nach Kategorie gefiltert. | Nur Lesen |
tool_info | Liefert Beschreibungen, Parameterschemata und Wirkungen ausgewählter Werkzeuge ohne Geschäftsausführung. | Nur Lesen |
tool_call | Ruft ein Geschäftswerkzeug zum Lesen, Ändern oder Bedienen von Geräten auf. | Abhängig vom Geschäftswerkzeug |
skill_list | Liefert Namen und Beschreibungen integrierter Skills mit Lese- und Downloadhinweisen. | Nur Lesen |
skill_read | Liest die Hauptdatei oder eine Referenzdatei eines Skills mit Seitennavigation. | Nur Lesen |
Aufrufbeispiele
tool_list({}): Liefertversionund die sortierte Namenslistetools.tool_list({category:"devices"}): Filtert Werkzeugnamen nachcategory.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 Arraytools; jeder Eintrag enthält die interne IDtool,description,inputSchema(fürtool_call.args) undreadOnly.toolsakzeptiert 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 undreadCall-Hinweise auf.skill_read({skill:"xxtlancontrol"}): Liest den Haupt-Skill bei bekanntem Namen direkt;pathist standardmäßigSKILL.md.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Liest einen Ablauf über einen relativen Link im Haupt-Skill;cursor/maxBytesermö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"}}