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数组,每项包含内部 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"}):按主文档相对链接读取流程;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"}}