MCP 業務操作目錄
以下依 tool_list 的分類列出目前 MCP 業務操作。名稱傳入 tool_call 的 tool,業務參數放入 args。完整參數與限制請用 tool_info 查詢對應定義;「唯讀」與「可能修改」沿用定義的 readOnly 標記。
XXT Home(XXT_HOME_PATH)是 XXTouch 在裝置上的工作目錄。
裝置 (devices)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_discover_devices | 提交 UDP 裝置探索廣播。 | 可能修改 |
backend_import_device | 匯入單一位址對應的裝置。 | 可能修改 |
backend_import_devices | 提交裝置批次匯入任務。 | 可能修改 |
backend_list_devices | 列出已登錄的裝置記錄。 | 唯讀 |
backend_scan_ips | 檢查 IPv4 位址與連接埠的 TCP 回應。 | 可能修改 |
backend_scan_networks | 列出中控主機的 IPv4 網段。 | 唯讀 |
device_check_auth | 讀取 XXTouch 授權狀態。 | 唯讀 |
device_clear_app_data | 清空指定應用程式的資料。 | 可能修改 |
device_clear_logs | 清空裝置的持久化日誌歷史。 | 可能修改 |
device_collect_realtime_logs | 讀取裝置即時腳本日誌。 | 唯讀 |
device_delete_record | 刪除中控內的裝置記錄。 | 可能修改 |
device_export_logs | 匯出裝置的持久化日誌歷史。 | 可能修改 |
device_get_app_paths | 讀取應用程式容器、群組與外掛路徑。 | 唯讀 |
device_get_applist | 列出裝置應用程式中繼資料。 | 唯讀 |
device_get_status | 讀取單台裝置的即時狀態。 | 唯讀 |
device_get_xxtlc_logs | 讀取指定通道的中控日誌歷史。 | 唯讀 |
device_input_sequence | 執行有序的觸控、按鍵和等待動作。 | 可能修改 |
device_install_package | 更新裝置端 XXTouch。 | 可能修改 |
device_list_apps | 列出已安裝應用程式及其識別碼。 | 唯讀 |
device_lock | 請求裝置鎖定螢幕。 | 可能修改 |
device_package_update_status | 讀取 Android Root 的 XXTouch 更新進度。 | 唯讀 |
device_reboot | 請求裝置重新啟動。 | 可能修改 |
device_respring | 請求 SpringBoard 重新啟動。 | 可能修改 |
device_set_brightness | 設定裝置亮度。 | 可能修改 |
device_set_volume | 設定裝置音量。 | 可能修改 |
device_trollstore_install | 請求透過 TrollStore 安裝 IPA/TIPA。 | 可能修改 |
device_ui_element_action | 執行指定 UI 元素上的操作。 | 可能修改 |
device_ui_element_query | 讀取符合條件或指定位置的 UI 元素。 | 唯讀 |
device_ui_element_snapshot | 讀取 UI 元素、邊界與可點選狀態。 | 唯讀 |
device_unlock | 請求裝置解除鎖定。 | 可能修改 |
群組 (groups)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_group_add_devices | 加入群組成員。 | 可能修改 |
backend_group_create | 建立裝置群組。 | 可能修改 |
backend_group_delete | 刪除裝置群組。 | 可能修改 |
backend_group_delete_script_config | 刪除指定腳本的群組設定。 | 可能修改 |
backend_group_get_script_config | 讀取指定腳本的群組設定。 | 唯讀 |
backend_group_list | 列出裝置群組。 | 唯讀 |
backend_group_list_script_configs | 列出群組儲存的腳本設定。 | 唯讀 |
backend_group_remove_devices | 移除群組成員。 | 可能修改 |
backend_group_rename | 重新命名裝置群組。 | 可能修改 |
backend_group_reorder | 調整順序:裝置群組。 | 可能修改 |
backend_group_set_script | 設定群組綁定的腳本。 | 可能修改 |
backend_group_set_script_config | 整體取代指定腳本的群組設定。 | 可能修改 |
腳本 (scripts)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_list_scripts | 列出中控可執行腳本。 | 唯讀 |
backend_read_script | 讀取中控腳本的 UTF-8 內容。 | 唯讀 |
backend_write_script | 寫入或覆寫中控腳本的 UTF-8 內容。 | 可能修改 |
device_get_selected_script | 讀取裝置目前選取的腳本。 | 唯讀 |
device_launch_script | 執行裝置上的腳本。 | 可能修改 |
device_pause_script | 暫停裝置上的腳本。 | 可能修改 |
device_resume_script | 繼續裝置上的腳本。 | 可能修改 |
device_run_script_snippet | 執行裝置端短段 Lua 程式碼。 | 可能修改 |
device_select_script | 設定裝置目前選取的腳本。 | 可能修改 |
device_send_script_and_encrypt | 執行腳本或專案的裝置端加密與回存。 | 可能修改 |
device_send_script_and_run | 執行腳本或專案的傳輸與啟動。 | 可能修改 |
device_stop_script | 停止裝置上的腳本。 | 可能修改 |
device_upload_script | 執行中控腳本到裝置的上傳。 | 可能修改 |
檔案 (files)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_file_copy | 複製中控檔案或目錄。 | 可能修改 |
backend_file_delete | 刪除中控檔案或目錄。 | 可能修改 |
backend_file_exists | 檢查中控檔案或目錄。 | 唯讀 |
backend_file_hash | 讀取中控檔案校驗值。 | 唯讀 |
backend_file_list | 列出中控檔案或目錄。 | 唯讀 |
backend_file_mkdir | 建立中控目錄。 | 可能修改 |
backend_file_move | 移動中控檔案或目錄。 | 可能修改 |
backend_file_read | 讀取中控檔案內容。 | 唯讀 |
backend_file_rename | 重新命名中控檔案或目錄。 | 可能修改 |
backend_file_write | 寫入或覆寫中控檔案內容。 | 可能修改 |
device_root_file_copy | 複製裝置絕對路徑下的檔案或目錄。 | 可能修改 |
device_root_file_list | 列出裝置絕對路徑下的檔案或目錄。 | 唯讀 |
device_root_file_mkdir | 建立裝置絕對路徑目錄。 | 可能修改 |
device_root_file_move | 移動裝置絕對路徑下的檔案或目錄。 | 可能修改 |
device_root_file_remove | 刪除裝置絕對路徑下的檔案或目錄。 | 可能修改 |
device_root_file_save_to_backend | 執行裝置絕對路徑檔案到中控目錄的回存。 | 可能修改 |
device_root_file_stat | 讀取裝置絕對路徑的檔案中繼資料。 | 唯讀 |
device_xxt_home_file_copy | 複製 XXT Home 內的檔案或目錄。 | 可能修改 |
device_xxt_home_file_list | 列出 XXT Home 內的檔案或目錄。 | 唯讀 |
device_xxt_home_file_mkdir | 建立 XXT Home 內的目錄。 | 可能修改 |
device_xxt_home_file_move | 移動 XXT Home 內的檔案或目錄。 | 可能修改 |
device_xxt_home_file_read | 讀取 XXT Home 內的檔案內容。 | 唯讀 |
device_xxt_home_file_remove | 刪除 XXT Home 內的檔案。 | 可能修改 |
device_xxt_home_file_rmdir | 刪除 XXT Home 內的空目錄。 | 可能修改 |
device_xxt_home_file_write | 寫入或覆寫 XXT Home 內的檔案內容。 | 可能修改 |
device_xxt_home_save_file_to_backend | 將 XXT Home 中的檔案或目錄儲存到中控目錄。 | 可能修改 |
device_xxt_home_send_files | 將中控檔案或目錄傳送到 XXT Home。 | 可能修改 |
影像 (images)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_binarize_image | 執行影像二值化與儲存。 | 可能修改 |
backend_crop_image | 執行影像矩形裁切與儲存。 | 可能修改 |
backend_extract_matrix | 執行單一字形的點陣擷取與影像儲存。 | 可能修改 |
backend_fit_binary_selection | 執行二值內容選區的收緊擬合。 | 唯讀 |
backend_matrix_line_from_binary_image | 執行二值影像到點陣字庫列的轉換。 | 唯讀 |
backend_pick_image_colors | 讀取影像指定像素的顏色。 | 唯讀 |
backend_split_matrix | 執行字形條按空白欄拆分點陣。 | 唯讀 |
backend_view_image | 讀取中控儲存中的影像預覽。 | 唯讀 |
device_get_screen_size | 讀取裝置實體螢幕尺寸與座標換算。 | 唯讀 |
device_get_screenshot | 讀取裝置截圖及座標資訊。 | 唯讀 |
資料 (data)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_kvdb_dict_clear | 清空 KVDB 詞典鍵值。 | 可能修改 |
backend_kvdb_dict_create | 建立 KVDB 詞典。 | 可能修改 |
backend_kvdb_dict_delete_all | 刪除 KVDB 詞典。 | 可能修改 |
backend_kvdb_dict_delete_key | 刪除單一 KVDB 詞典鍵。 | 可能修改 |
backend_kvdb_dict_delete_keys | 刪除選定的 KVDB 詞典鍵。 | 可能修改 |
backend_kvdb_dict_get | 讀取單一 KVDB 詞典值。 | 唯讀 |
backend_kvdb_dict_get_all | 列出 KVDB 詞典鍵值。 | 唯讀 |
backend_kvdb_dict_incr | 原子遞增詞典內的整數字串。 | 可能修改 |
backend_kvdb_dict_put | 寫入或覆寫單一 KVDB 詞典值。 | 可能修改 |
backend_kvdb_dict_rename | 重新命名 KVDB 詞典。 | 可能修改 |
backend_kvdb_dict_replace | 整體取代 KVDB 詞典鍵值。 | 可能修改 |
backend_kvdb_dict_upsert | 合併寫入 KVDB 詞典鍵值。 | 可能修改 |
backend_kvdb_export | 匯出整個 KVDB 的 SQLite 備份。 | 可能修改 |
backend_kvdb_import | 匯入整個 KVDB 的 SQLite 備份。 | 可能修改 |
backend_kvdb_list_dicts | 列出 KVDB 詞典。 | 唯讀 |
backend_kvdb_list_queues | 列出 KVDB 佇列。 | 唯讀 |
backend_kvdb_queue_clear | 清空 KVDB 佇列元素。 | 可能修改 |
backend_kvdb_queue_count | 統計 KVDB 佇列元素。 | 唯讀 |
backend_kvdb_queue_create | 建立 KVDB 佇列。 | 可能修改 |
backend_kvdb_queue_delete_all | 刪除 KVDB 佇列。 | 可能修改 |
backend_kvdb_queue_delete_indices | 刪除指定位置的佇列元素。 | 可能修改 |
backend_kvdb_queue_list | 列出 KVDB 佇列元素。 | 唯讀 |
backend_kvdb_queue_move | 執行兩條 KVDB 佇列間的原子轉移。 | 可能修改 |
backend_kvdb_queue_pop | 取出並回傳 KVDB 佇列元素。 | 可能修改 |
backend_kvdb_queue_push | 加入佇列:KVDB 佇列元素。 | 可能修改 |
backend_kvdb_queue_rename | 重新命名 KVDB 佇列。 | 可能修改 |
backend_kvdb_queue_replace | 整體取代 KVDB 佇列元素。 | 可能修改 |
backend_tabledb_add_columns | 加入 TableDB 使用者欄位。 | 可能修改 |
backend_tabledb_add_rows | 加入 TableDB 資料列。 | 可能修改 |
backend_tabledb_count_rows | 統計符合條件的 TableDB 資料列。 | 唯讀 |
backend_tabledb_create | 建立 TableDB 資料表。 | 可能修改 |
backend_tabledb_delete_rows | 刪除 TableDB 資料列。 | 可能修改 |
backend_tabledb_delete_table | 刪除 TableDB 資料表。 | 可能修改 |
backend_tabledb_drop_columns | 刪除 TableDB 使用者欄位。 | 可能修改 |
backend_tabledb_edit_rows | 更新 TableDB 資料列。 | 可能修改 |
backend_tabledb_export | 匯出 TableDB 資料列。 | 可能修改 |
backend_tabledb_export_all | 匯出整個 TableDB 的 SQLite 備份。 | 可能修改 |
backend_tabledb_export_selection | 匯出選定的 TableDB 列與欄位。 | 可能修改 |
backend_tabledb_fetch_one | 執行單列的原子擷取與可選更新。 | 可能修改 |
backend_tabledb_get_row | 讀取指定 ID 的 TableDB 資料列。 | 唯讀 |
backend_tabledb_get_schema | 讀取 TableDB 資料表結構。 | 唯讀 |
backend_tabledb_import | 匯入 TableDB 資料列。 | 可能修改 |
backend_tabledb_import_all | 匯入整個 TableDB 的 SQLite 備份。 | 可能修改 |
backend_tabledb_list_rows | 列出 TableDB 資料列。 | 唯讀 |
backend_tabledb_list_tables | 列出 TableDB 資料表。 | 唯讀 |
backend_tabledb_rename_column | 重新命名 TableDB 使用者欄位。 | 可能修改 |
backend_tabledb_rename_table | 重新命名 TableDB 資料表。 | 可能修改 |
backend_tabledb_reorder_columns | 設定 TableDB 欄位順序。 | 可能修改 |
backend_tabledb_truncate | 清空 TableDB 資料列。 | 可能修改 |
排程 (schedules)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_schedule_cancel_run | 取消單次排程執行。 | 可能修改 |
backend_schedule_create | 建立排程定義。 | 可能修改 |
backend_schedule_delete | 刪除排程。 | 可能修改 |
backend_schedule_export | 匯出排程 JSON 備份。 | 唯讀 |
backend_schedule_get | 讀取排程定義。 | 唯讀 |
backend_schedule_import | 匯入排程 JSON 備份。 | 可能修改 |
backend_schedule_list | 列出排程。 | 唯讀 |
backend_schedule_list_runs | 列出排程執行歷史與狀態。 | 唯讀 |
backend_schedule_run | 提交單次排程執行。 | 可能修改 |
backend_schedule_set_enabled | 設定排程的自動觸發狀態。 | 可能修改 |
backend_schedule_update | 整體取代排程定義。 | 可能修改 |
backend_schedule_validate | 靜態驗證並正規化排程定義。 | 唯讀 |
背景任務 (tasks)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_batch_authorize_continue | 繼續批次授權任務。 | 可能修改 |
backend_batch_authorize_pause | 暫停批次授權任務。 | 可能修改 |
backend_batch_authorize_start | 提交批次授權任務。 | 可能修改 |
backend_batch_execute | 提交裝置批次操作任務。 | 可能修改 |
backend_task_cancel | 請求背景任務取消。 | 可能修改 |
backend_task_get | 讀取背景任務狀態與彙總。 | 唯讀 |
backend_task_list | 列出指定來源的背景任務。 | 唯讀 |
backend_task_results | 讀取背景任務逐項結果。 | 唯讀 |
backend_task_retry | 重試已結束 Agent 任務中的失敗項目。 | 可能修改 |
IDE 工作階段 (ide)
| 工具 | 說明 | 效果 |
|---|---|---|
ide_bind_session | 設定目前 MCP 連線的 IDE 工作階段綁定。 | 可能修改 |
ide_get_bound_session | 讀取目前 MCP 連線的 IDE 工作階段綁定。 | 唯讀 |
ide_get_context | 讀取 IDE 工作區、檔案與選取內容。 | 唯讀 |
ide_list_sessions | 列出作用中 IDE 工作階段。 | 唯讀 |
ide_resolve_selected_device | 讀取 IDE 目前選取的裝置。 | 唯讀 |
人工輔助 (assist)
| 工具 | 說明 | 效果 |
|---|---|---|
xxt_assist_cancel_task | 取消人工輔助任務。 | 可能修改 |
xxt_assist_create_task | 建立人工輔助任務。 | 可能修改 |
xxt_assist_get_task | 讀取人工輔助任務的狀態與結果。 | 唯讀 |
xxt_assist_list_tasks | 列出人工輔助任務。 | 唯讀 |
xxt_assist_wait_result | 請求人工輔助結果等待。 | 唯讀 |
系統 (system)
| 工具 | 說明 | 效果 |
|---|---|---|
backend_get_app_config | 讀取公開的型別化應用設定。 | 唯讀 |
backend_get_config | 讀取單一字串設定項。 | 唯讀 |
backend_health | 檢查中控服務可用性。 | 唯讀 |
backend_rename_devices | 更新裝置名稱並同步中控記錄。 | 可能修改 |
backend_set_app_config | 更新公開的型別化應用設定。 | 可能修改 |
backend_set_config | 設定單一字串設定項。 | 可能修改 |
backend_version | 讀取中控後端版本。 | 唯讀 |