Passer au contenu principal

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.

OutilDescriptionEffet
tool_listRenvoie les noms des outils métier, avec filtrage facultatif par catégorie.Lecture seule
tool_infoRenvoie descriptions, schémas de paramètres et effets des outils sélectionnés sans exécuter d’opérations.Lecture seule
tool_callAppelle un outil métier pour consulter, modifier ou agir sur les appareils.Selon l’outil métier
skill_listRenvoie noms et descriptions des Skills intégrés et indications de lecture et téléchargement.Lecture seule
skill_readLit le fichier principal ou une référence d’un Skill, avec pagination.Lecture seule

Exemples d’appels​

  • tool_list({}): Renvoie version et la liste triée des noms tools.
  • tool_list({category:"devices"}): Filtre les noms des outils avec category.
  • 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 tableau tools dont chaque élément contient l’ID interne tool, description, inputSchema (pour tool_call.args) et readOnly. tools accepte 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 indications readCall.
  • skill_read({skill:"xxtlancontrol"}): Lit directement le Skill principal si son nom est connu ; path vaut SKILL.md par défaut.
  • skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Lit un processus via un lien relatif du Skill principal ; cursor / maxBytes assurent 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"}}