跳至主要內容

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 陣列,每項包含內部 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"}}