Справочник инструментов MCP
MCP предоставляет пять инструментов: tool_list, tool_info, tool_call, skill_list, skill_read — для имён бизнес-инструментов, описаний, бизнес-вызовов, каталога Skill и чтения документов Skill. Каталог — необязательная навигация. Бизнес-запросы, изменения и действия с устройствами используют tool_call, где tool обязателен. Известные операции вызывайте напрямую; Skill и справочные документы читаются по необходимости. args — необязательный объект параметров операции.
| Инструмент | Описание | Эффект |
|---|---|---|
tool_list | Возвращает имена бизнес-инструментов с необязательным фильтром по категории. | Только чтение |
tool_info | Возвращает описания, схемы параметров и эффекты выбранных инструментов без выполнения операций. | Только чтение |
tool_call | Вызывает бизнес-инструмент для чтения, изменения или управления устройствами. | Зависит от бизнес-инструмента |
skill_list | Возвращает имена и описания встроенных Skills с подсказками чтения и загрузки. | Только чтение |
skill_read | Читает основной или справочный файл Skill с разбивкой на страницы. | Только чтение |
Примеры вызовов
tool_list({}): Возвращаетversionи отсортированный список имёнtools.tool_list({category:"devices"}): Фильтрует имена операций поcategory.tool_info({tools:"backend_list_devices"}): Описывает использование одного инструмента без его выполнения.tool_info({tools:["backend_list_devices","device_get_status"]}): Описывает несколько нужных инструментов без выполнения. Возвращает массивtools, каждый элемент которого содержит внутренний IDtool,description,inputSchema(дляtool_call.args) иreadOnly.toolsпринимает непустую строку или непустой массив строк без фиксированного ограничения размера пакета.tool_call({tool:"backend_list_devices",args:{limit:10}}): Напрямую вызывает известный инструмент для чтения нужного списка устройств.skill_list({}): Выводит имена Skill, описания и подсказкиreadCall.skill_read({skill:"xxtlancontrol"}): Читает основной Skill напрямую по известному имени;pathпо умолчанию равенSKILL.md.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Читает порядок действий по относительной ссылке из основного Skill;cursor/maxBytesобеспечивают пагинацию.
Подсказки вызова приложения readCall, infoCall и listCall используют {name,args}; name задаёт публичный инструмент MCP. Идентификаторы Skill возвращаются в skills[].skill в каталоге и в data.skill в результате чтения.
Каждый элемент skill_list содержит downloadUrl — полный URL текущего центра для загрузки всего Skill в ZIP. skill_read возвращает текст выбранного файла и также ссылку на полный пакет Skill. ZIP включает основной документ, справочные файлы и поставляемые скрипты, шаблоны и ресурсы. Для скачивания достаточно метаданных каталога; существующую ссылку можно использовать напрямую, не читая текст и не запрашивая каталог повторно.
Если имена неизвестны, откройте tool_list по категории. Если параметры неясны, получите нужные определения вместе через tool_info, затем используйте tool_call. Известные инструменты можно вызывать напрямую, без предварительного чтения каталога или определений.
После получения ID пакетной задачи запросите её состояние и неудачные элементы. После обновления центра управления переподключите MCP.
Запуск команды оболочки на устройстве
Чтобы выполнять команды оболочки на устройстве, включите «Разрешить выполнение команд оболочки на устройствах» в настройках MCP и сохраните изменения. По умолчанию параметр выключен. После выключения и сохранения инструмент скрывается во всех сеансах MCP, а новые вызовы отклоняются.
command — полная командная строка длиной до 16384 символов, выполняемая оболочкой устройства с параметром -c. Результат содержит код выхода, stdout, stderr и пояснение о путях при использовании оболочки roothide.
По умолчанию на выполнение команды отводится 10 секунд. Для длительных команд задайте timeoutMs (например, 300000 для 5 минут) и достаточное время ожидания в клиенте MCP. Контроллер продлевает время работы aux при запуске и каждые 30 секунд обменивается сигналами активности с устройством. После завершения последней задачи aux выходит через 180 секунд бездействия.
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}