Перейти к основному содержимому

Справочник инструментов 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, каждый элемент которого содержит внутренний ID tool, 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"}}