Référence des outils MCP
MCP expose cinq outils : tool_list, tool_info, tool_call, skill_list, skill_read, pour les noms des outils métier, leurs définitions, les appels métier, le catalogue des Skills et la lecture de leurs documents. Le répertoire est une navigation facultative. Consultations métier, modifications et actions sur les appareils utilisent tool_call, avec tool obligatoire. Appelez directement les opérations connues ; Skills et références se lisent selon les besoins. args est un objet facultatif contenant les paramètres métier.
| Outil | Description | Effet |
|---|---|---|
tool_list | Renvoie les noms des outils métier, avec filtrage facultatif par catégorie. | Lecture seule |
tool_info | Renvoie descriptions, schémas de paramètres et effets des outils sélectionnés sans exécuter d’opérations. | Lecture seule |
tool_call | Appelle un outil métier pour consulter, modifier ou agir sur les appareils. | Selon l’outil métier |
skill_list | Renvoie noms et descriptions des Skills intégrés et indications de lecture et téléchargement. | Lecture seule |
skill_read | Lit le fichier principal ou une référence d’un Skill, avec pagination. | Lecture seule |
Exemples d’appels
tool_list({}): Renvoieversionet la liste triée des nomstools.tool_list({category:"devices"}): Filtre les noms des outils aveccategory.tool_info({tools:"backend_list_devices"}): Décrit l’usage d’un seul outil sans l’exécuter.tool_info({tools:["backend_list_devices","device_get_status"]}): Décrit plusieurs outils nécessaires sans les exécuter. Renvoie un tableautoolsdont chaque élément contient l’ID internetool,description,inputSchema(pourtool_call.args) etreadOnly.toolsaccepte une chaîne non vide ou un tableau non vide de chaînes, sans limite fixe du nombre d’éléments par lot.tool_call({tool:"backend_list_devices",args:{limit:10}}): Appelle directement un outil connu pour lire la liste d’appareils nécessaire.skill_list({}): Liste les noms des Skills, leurs descriptions et les indicationsreadCall.skill_read({skill:"xxtlancontrol"}): Lit directement le Skill principal si son nom est connu ;pathvautSKILL.mdpar défaut.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Lit un processus via un lien relatif du Skill principal ;cursor/maxBytesassurent la pagination.
Les indications d’appel de l’application readCall, infoCall et listCall utilisent {name,args} ; name désigne un outil MCP public. Les ID des Skills figurent dans skills[].skill dans le catalogue et dans data.skill dans les résultats de lecture.
Chaque entrée de skill_list fournit downloadUrl, une URL complète du centre actuel pour télécharger tout le Skill en ZIP. skill_read renvoie le texte du fichier sélectionné ainsi que le lien du paquet complet. Le ZIP contient le document principal, les références et les scripts, modèles et ressources fournis avec le Skill. Pour télécharger, les métadonnées du catalogue suffisent ; utilisez directement un lien existant sans lire le texte ni relister.
Si les noms sont inconnus, consultez tool_list par catégorie. Si les paramètres sont inconnus, obtenez les définitions nécessaires ensemble avec tool_info, puis utilisez tool_call. Les outils connus peuvent être appelés directement, sans lire d’abord le répertoire ou les définitions.
Après réception de l’ID d’une tâche par lots, consultez son état et les éléments en échec. Reconnectez MCP après la mise à jour du centre de contrôle.
Exécuter une commande shell sur l’appareil
Dans les paramètres MCP, activez Autoriser l’exécution de commandes shell sur les appareils et enregistrez pour exécuter des commandes shell sur un appareil. Cette option est désactivée par défaut. Si vous la désactivez et enregistrez, l’outil est masqué dans toutes les sessions MCP et les nouveaux appels sont refusés.
command est une ligne de commande complète d’au plus 16384 caractères, exécutée par le shell de l’appareil avec -c. Le résultat indique le code de sortie, stdout, stderr et les particularités des chemins pour un shell roothide.
Le délai d’exécution par défaut est de 10 secondes. Pour les commandes longues, réglez timeoutMs (par exemple 300000 pour 5 minutes) et prévoyez un délai suffisant dans le client MCP. Le contrôleur prolonge la durée de vie d’aux au démarrage et échange un signal avec l’appareil toutes les 30 secondes. Après la dernière tâche, aux s’arrête au bout de 180 secondes d’inactivité.
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}