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