跳到主要内容

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读取中控后端版本。只读