跳至主要內容

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讀取中控後端版本。唯讀