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 | 回傳內建 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"}}