跳到主要内容

MCP 工具参考

MCP 公开 tool_list、tool_info、tool_call、skill_list、skill_read 五个工具,分别负责业务工具目录、用法定义、业务调用、Skill 目录和 Skill 文档读取。操作目录是可选导航;业务查询、修改和设备动作统一通过 tool_call 调用,tool 必填,args 是可选业务参数对象。已知操作与参数可直接调用,Skill 及引用文档均按需读取。

工具说明效果
tool_list返回业务工具名称,可按类别筛选。只读
tool_info返回指定工具的说明、参数定义与读写效果,不执行业务操作。只读
tool_call调用指定业务工具,执行查询、修改或设备动作。由业务工具决定
skill_list返回内置 Skill 名称、简介与读取、下载提示。只读
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"}):按主文档相对链接读取流程;cursor / maxBytes 保留分页。

应用调用提示 readCall、infoCall、listCall 统一为 {name,args},name 指定公开 MCP 工具。 Skill 标识在目录中为 skills[].skill,读取结果中为 data.skill。

skill_list 每项提供完整 Skill ZIP 的 downloadUrl,是当前中控的完整下载地址。skill_read 返回所选单个文件的文本,同时附带整个 Skill 包的下载链接;ZIP 包含主文档、参考文档及该 Skill 自带的脚本、模板和素材。只需下载时获取目录元数据即可;已有链接可直接使用,无需先读正文或重复列目录。

名称不明时按类别查看 tool_list,参数不明时用 tool_info 批量读取所需定义,再用 tool_call 执行;已知工具可直接调用,无需先列目录或读取定义。

批量操作返回任务 ID 后,查询任务状态和失败项。更新中控后,请重新连接 MCP。

运行设备 Shell 命令​

「系统配置 → MCP 安装 → 允许对设备执行 Shell 命令」默认关闭。打开并保存后可在设备上同步执行 Shell 命令。关闭并保存后,所有 MCP 会话立即隐藏此工具,并拒绝新的调用。

command 是完整的命令行,最长 16384 个字符,由设备端 Shell 以 -c 方式执行。结果包含退出码、标准输出、错误输出,以及适用于 roothide Shell 的路径提示。

命令默认超时为 10 秒。长命令可设置 timeoutMs,例如 300000 表示 5 分钟;MCP 客户端的调用超时也应覆盖预期时长。中控在开始时续期,运行中每 30 秒与设备交换心跳。最后一个任务结束后,aux 空闲 180 秒自动退出。

{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}