Catálogo de operaciones de negocio MCP
Las operaciones de negocio MCP se agrupan por categoría de tool_list. Pasa el nombre como tool a tool_call y los parámetros de negocio en args. Consulta tool_info para los parámetros y restricciones completos. Solo lectura y Puede modificar siguen el indicador readOnly de cada definición.
XXT Home (XXT_HOME_PATH) es el directorio de trabajo de XXTouch en el dispositivo.
Dispositivos (devices)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_discover_devices | Enviar la difusión de descubrimiento UDP. | Puede modificar |
backend_import_device | Importar un dispositivo por dirección. | Puede modificar |
backend_import_devices | Enviar una tarea de importación de dispositivos. | Puede modificar |
backend_list_devices | Listar los dispositivos registrados. | Solo lectura |
backend_scan_ips | Comprobar las respuestas TCP de direcciones y puertos IPv4. | Puede modificar |
backend_scan_networks | Listar los prefijos IPv4 del servidor. | Solo lectura |
device_check_auth | Leer el estado de licencia de XXTouch. | Solo lectura |
device_clear_app_data | Vaciar los datos de la aplicación indicada. | Puede modificar |
device_clear_logs | Vaciar el historial persistente de registros del dispositivo. | Puede modificar |
device_collect_realtime_logs | Leer los registros de scripts en tiempo real. | Solo lectura |
device_delete_record | Eliminar un registro de dispositivo del servidor. | Puede modificar |
device_export_logs | Exportar el historial persistente de registros del dispositivo. | Puede modificar |
device_get_app_paths | Leer las rutas del contenedor, grupos y complementos de la aplicación. | Solo lectura |
device_get_applist | Listar los metadatos de aplicaciones del dispositivo. | Solo lectura |
device_get_status | Leer el estado actual de un dispositivo. | Solo lectura |
device_get_xxtlc_logs | Leer los registros guardados de un canal del control central. | Solo lectura |
device_input_sequence | Ejecutar una secuencia de toques, teclas y esperas. | Puede modificar |
device_install_package | Actualizar XXTouch en el dispositivo. | Puede modificar |
device_list_apps | Listar las aplicaciones instaladas y sus identificadores. | Solo lectura |
device_lock | Solicitar el bloqueo de pantalla del dispositivo. | Puede modificar |
device_package_update_status | Leer el progreso de actualización de XXTouch en Android Root. | Solo lectura |
device_reboot | Solicitar el reinicio del dispositivo. | Puede modificar |
device_respring | Solicitar el reinicio de SpringBoard. | Puede modificar |
device_set_brightness | Establecer el brillo del dispositivo. | Puede modificar |
device_set_volume | Establecer el volumen del dispositivo. | Puede modificar |
device_trollstore_install | Solicitar la instalación de IPA/TIPA mediante TrollStore. | Puede modificar |
device_ui_element_action | Ejecutar una acción sobre un elemento UI. | Puede modificar |
device_ui_element_query | Leer los elementos UI por selector o posición. | Solo lectura |
device_ui_element_snapshot | Leer los elementos UI, sus límites y disponibilidad. | Solo lectura |
device_unlock | Solicitar el desbloqueo de pantalla del dispositivo. | Puede modificar |
Grupos (groups)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_group_add_devices | Añadir los miembros del grupo. | Puede modificar |
backend_group_create | Crear los grupos de dispositivos. | Puede modificar |
backend_group_delete | Eliminar los grupos de dispositivos. | Puede modificar |
backend_group_delete_script_config | Eliminar la configuración de grupo de un script. | Puede modificar |
backend_group_get_script_config | Leer la configuración de grupo de un script. | Solo lectura |
backend_group_list | Listar los grupos de dispositivos. | Solo lectura |
backend_group_list_script_configs | Listar las configuraciones de scripts guardadas del grupo. | Solo lectura |
backend_group_remove_devices | Quitar los miembros del grupo. | Puede modificar |
backend_group_rename | Renombrar los grupos de dispositivos. | Puede modificar |
backend_group_reorder | Reordenar los grupos de dispositivos. | Puede modificar |
backend_group_set_script | Establecer el script vinculado al grupo. | Puede modificar |
backend_group_set_script_config | Reemplazar por completo la configuración de grupo de un script. | Puede modificar |
Scripts (scripts)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_list_scripts | Listar los scripts ejecutables del servidor. | Solo lectura |
backend_read_script | Leer el contenido UTF-8 de un script del servidor. | Solo lectura |
backend_write_script | Escribir o sobrescribir el contenido UTF-8 de un script del servidor. | Puede modificar |
device_get_selected_script | Leer el script seleccionado en el dispositivo. | Solo lectura |
device_launch_script | Ejecutar el script del dispositivo. | Puede modificar |
device_pause_script | Pausar el script del dispositivo. | Puede modificar |
device_resume_script | Reanudar el script del dispositivo. | Puede modificar |
device_run_script_snippet | Ejecutar un fragmento breve de Lua en el dispositivo. | Puede modificar |
device_select_script | Establecer el script seleccionado en el dispositivo. | Puede modificar |
device_send_script_and_encrypt | Ejecutar el cifrado en el dispositivo y guardado en el servidor de un script o proyecto. | Puede modificar |
device_send_script_and_run | Ejecutar la transferencia e inicio de un script o proyecto. | Puede modificar |
device_stop_script | Detener el script del dispositivo. | Puede modificar |
device_upload_script | Ejecutar la subida de un script del servidor al dispositivo. | Puede modificar |
Archivos (files)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_file_copy | Copiar los archivos o directorios del servidor. | Puede modificar |
backend_file_delete | Eliminar los archivos o directorios del servidor. | Puede modificar |
backend_file_exists | Comprobar los archivos o directorios del servidor. | Solo lectura |
backend_file_hash | Leer las sumas de comprobación de archivos del servidor. | Solo lectura |
backend_file_list | Listar los archivos o directorios del servidor. | Solo lectura |
backend_file_mkdir | Crear los directorios del servidor. | Puede modificar |
backend_file_move | Mover los archivos o directorios del servidor. | Puede modificar |
backend_file_read | Leer el contenido de archivos del servidor. | Solo lectura |
backend_file_rename | Renombrar los archivos o directorios del servidor. | Puede modificar |
backend_file_write | Escribir o sobrescribir el contenido de archivos del servidor. | Puede modificar |
device_root_file_copy | Copiar los archivos o directorios del dispositivo por ruta absoluta. | Puede modificar |
device_root_file_list | Listar los archivos o directorios del dispositivo por ruta absoluta. | Solo lectura |
device_root_file_mkdir | Crear un directorio del dispositivo por ruta absoluta. | Puede modificar |
device_root_file_move | Mover los archivos o directorios del dispositivo por ruta absoluta. | Puede modificar |
device_root_file_remove | Eliminar los archivos o directorios del dispositivo por ruta absoluta. | Puede modificar |
device_root_file_save_to_backend | Ejecutar el guardado de archivos de ruta absoluta del dispositivo en el servidor. | Puede modificar |
device_root_file_stat | Leer los metadatos de archivos del dispositivo por ruta absoluta. | Solo lectura |
device_xxt_home_file_copy | Copiar los archivos o directorios del XXT Home. | Puede modificar |
device_xxt_home_file_list | Listar los archivos o directorios del XXT Home. | Solo lectura |
device_xxt_home_file_mkdir | Crear los directorios del XXT Home. | Puede modificar |
device_xxt_home_file_move | Mover los archivos o directorios del XXT Home. | Puede modificar |
device_xxt_home_file_read | Leer el contenido de archivos del XXT Home. | Solo lectura |
device_xxt_home_file_remove | Eliminar un archivo del XXT Home. | Puede modificar |
device_xxt_home_file_rmdir | Eliminar los directorios vacíos del XXT Home. | Puede modificar |
device_xxt_home_file_write | Escribir o sobrescribir el contenido de archivos del XXT Home. | Puede modificar |
device_xxt_home_save_file_to_backend | Guardar un archivo o directorio de XXT Home en un directorio del servidor. | Puede modificar |
device_xxt_home_send_files | Enviar archivos o directorios del servidor al XXT Home del dispositivo. | Puede modificar |
Imágenes (images)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_binarize_image | Ejecutar la binarización y guardado de una imagen. | Puede modificar |
backend_crop_image | Ejecutar el recorte rectangular y guardado de una imagen. | Puede modificar |
backend_extract_matrix | Ejecutar la extracción de matriz de un glifo y guardado de imagen. | Puede modificar |
backend_fit_binary_selection | Ejecutar el ajuste de selección al contenido binario. | Solo lectura |
backend_matrix_line_from_binary_image | Ejecutar la conversión de imagen binaria a una línea MatrixDict. | Solo lectura |
backend_pick_image_colors | Leer los colores de píxeles de la imagen. | Solo lectura |
backend_split_matrix | Ejecutar la división de una tira de glifos en matrices por columnas vacías. | Solo lectura |
backend_view_image | Leer la vista previa de una imagen del servidor. | Solo lectura |
device_get_screen_size | Leer el tamaño físico de pantalla y la conversión de coordenadas. | Solo lectura |
device_get_screenshot | Leer una captura del dispositivo y sus coordenadas. | Solo lectura |
Datos (data)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_kvdb_dict_clear | Vaciar las entradas de un diccionario KVDB. | Puede modificar |
backend_kvdb_dict_create | Crear los diccionarios KVDB. | Puede modificar |
backend_kvdb_dict_delete_all | Eliminar los diccionarios KVDB. | Puede modificar |
backend_kvdb_dict_delete_key | Eliminar una clave de diccionario KVDB. | Puede modificar |
backend_kvdb_dict_delete_keys | Eliminar las claves seleccionadas del diccionario KVDB. | Puede modificar |
backend_kvdb_dict_get | Leer un valor de diccionario KVDB. | Solo lectura |
backend_kvdb_dict_get_all | Listar las entradas de un diccionario KVDB. | Solo lectura |
backend_kvdb_dict_incr | Incrementar atómicamente una cadena de entero del diccionario. | Puede modificar |
backend_kvdb_dict_put | Escribir o sobrescribir un valor de diccionario KVDB. | Puede modificar |
backend_kvdb_dict_rename | Renombrar los diccionarios KVDB. | Puede modificar |
backend_kvdb_dict_replace | Reemplazar por completo las entradas de un diccionario KVDB. | Puede modificar |
backend_kvdb_dict_upsert | Combinar y escribir las entradas de un diccionario KVDB. | Puede modificar |
backend_kvdb_export | Exportar una copia SQLite completa de KVDB. | Puede modificar |
backend_kvdb_import | Importar una copia SQLite completa de KVDB. | Puede modificar |
backend_kvdb_list_dicts | Listar los diccionarios KVDB. | Solo lectura |
backend_kvdb_list_queues | Listar las colas KVDB. | Solo lectura |
backend_kvdb_queue_clear | Vaciar los valores de una cola KVDB. | Puede modificar |
backend_kvdb_queue_count | Contar los valores de una cola KVDB. | Solo lectura |
backend_kvdb_queue_create | Crear las colas KVDB. | Puede modificar |
backend_kvdb_queue_delete_all | Eliminar las colas KVDB. | Puede modificar |
backend_kvdb_queue_delete_indices | Eliminar los elementos de cola en posiciones indicadas. | Puede modificar |
backend_kvdb_queue_list | Listar los valores de una cola KVDB. | Solo lectura |
backend_kvdb_queue_move | Ejecutar una transferencia atómica entre colas KVDB. | Puede modificar |
backend_kvdb_queue_pop | Consumir y devolver los valores de una cola KVDB. | Puede modificar |
backend_kvdb_queue_push | Encolar los valores de una cola KVDB. | Puede modificar |
backend_kvdb_queue_rename | Renombrar las colas KVDB. | Puede modificar |
backend_kvdb_queue_replace | Reemplazar por completo los valores de una cola KVDB. | Puede modificar |
backend_tabledb_add_columns | Añadir las columnas de usuario TableDB. | Puede modificar |
backend_tabledb_add_rows | Añadir las filas TableDB. | Puede modificar |
backend_tabledb_count_rows | Contar las filas TableDB que cumplen condiciones. | Solo lectura |
backend_tabledb_create | Crear las tablas TableDB. | Puede modificar |
backend_tabledb_delete_rows | Eliminar las filas TableDB. | Puede modificar |
backend_tabledb_delete_table | Eliminar las tablas TableDB. | Puede modificar |
backend_tabledb_drop_columns | Eliminar las columnas de usuario TableDB. | Puede modificar |
backend_tabledb_edit_rows | Actualizar las filas TableDB. | Puede modificar |
backend_tabledb_export | Exportar las filas TableDB. | Puede modificar |
backend_tabledb_export_all | Exportar una copia SQLite completa de TableDB. | Puede modificar |
backend_tabledb_export_selection | Exportar las filas y columnas TableDB seleccionadas. | Puede modificar |
backend_tabledb_fetch_one | Ejecutar la obtención atómica de una fila con actualización opcional. | Puede modificar |
backend_tabledb_get_row | Leer una fila TableDB por ID. | Solo lectura |
backend_tabledb_get_schema | Leer el esquema de una tabla TableDB. | Solo lectura |
backend_tabledb_import | Importar las filas TableDB. | Puede modificar |
backend_tabledb_import_all | Importar una copia SQLite completa de TableDB. | Puede modificar |
backend_tabledb_list_rows | Listar las filas TableDB. | Solo lectura |
backend_tabledb_list_tables | Listar las tablas TableDB. | Solo lectura |
backend_tabledb_rename_column | Renombrar las columnas de usuario TableDB. | Puede modificar |
backend_tabledb_rename_table | Renombrar las tablas TableDB. | Puede modificar |
backend_tabledb_reorder_columns | Establecer el orden de columnas TableDB. | Puede modificar |
backend_tabledb_truncate | Vaciar las filas TableDB. | Puede modificar |
Tareas programadas (schedules)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_schedule_cancel_run | Cancelar una ejecución programada. | Puede modificar |
backend_schedule_create | Crear las definiciones de tareas programadas. | Puede modificar |
backend_schedule_delete | Eliminar las tareas programadas. | Puede modificar |
backend_schedule_export | Exportar una copia JSON de tareas programadas. | Solo lectura |
backend_schedule_get | Leer las definiciones de tareas programadas. | Solo lectura |
backend_schedule_import | Importar una copia JSON de tareas programadas. | Puede modificar |
backend_schedule_list | Listar las tareas programadas. | Solo lectura |
backend_schedule_list_runs | Listar el historial y estado de ejecuciones programadas. | Solo lectura |
backend_schedule_run | Enviar una ejecución programada. | Puede modificar |
backend_schedule_set_enabled | Establecer el estado del disparador automático de una tarea. | Puede modificar |
backend_schedule_update | Reemplazar por completo las definiciones de tareas programadas. | Puede modificar |
backend_schedule_validate | Validar estáticamente y normalizar las definiciones de tareas programadas. | Solo lectura |
Tareas en segundo plano (tasks)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_batch_authorize_continue | Reanudar una tarea de autorización por lotes. | Puede modificar |
backend_batch_authorize_pause | Pausar una tarea de autorización por lotes. | Puede modificar |
backend_batch_authorize_start | Enviar una tarea de autorización por lotes. | Puede modificar |
backend_batch_execute | Enviar una tarea de operaciones de dispositivos por lotes. | Puede modificar |
backend_task_cancel | Solicitar la cancelación de una tarea en segundo plano. | Puede modificar |
backend_task_get | Leer el estado y resumen de una tarea en segundo plano. | Solo lectura |
backend_task_list | Listar las tareas en segundo plano de una fuente. | Solo lectura |
backend_task_results | Leer los resultados individuales de una tarea en segundo plano. | Solo lectura |
backend_task_retry | Reintentar los elementos fallidos de una tarea Agent finalizada. | Puede modificar |
Sesiones IDE (ide)
| Herramienta | Descripción | Efecto |
|---|---|---|
ide_bind_session | Establecer la sesión IDE vinculada a la conexión MCP actual. | Puede modificar |
ide_get_bound_session | Leer la sesión IDE vinculada a la conexión MCP actual. | Solo lectura |
ide_get_context | Leer el contexto IDE de espacio de trabajo, archivo y selección. | Solo lectura |
ide_list_sessions | Listar las sesiones IDE activas. | Solo lectura |
ide_resolve_selected_device | Leer el dispositivo seleccionado en el IDE. | Solo lectura |
Asistencia humana (assist)
| Herramienta | Descripción | Efecto |
|---|---|---|
xxt_assist_cancel_task | Cancelar las tareas de asistencia humana. | Puede modificar |
xxt_assist_create_task | Crear las tareas de asistencia humana. | Puede modificar |
xxt_assist_get_task | Leer el estado y resultado de una tarea de asistencia. | Solo lectura |
xxt_assist_list_tasks | Listar las tareas de asistencia humana. | Solo lectura |
xxt_assist_wait_result | Solicitar la espera de un resultado de asistencia. | Solo lectura |
Sistema (system)
| Herramienta | Descripción | Efecto |
|---|---|---|
backend_get_app_config | Leer los ajustes públicos tipados de la aplicación. | Solo lectura |
backend_get_config | Leer una entrada de configuración de texto. | Solo lectura |
backend_health | Comprobar la disponibilidad del servidor. | Solo lectura |
backend_rename_devices | Actualizar los nombres de dispositivos y sincronizar sus registros. | Puede modificar |
backend_set_app_config | Actualizar los ajustes públicos tipados de la aplicación. | Puede modificar |
backend_set_config | Establecer una entrada de configuración de texto. | Puede modificar |
backend_version | Leer la versión del servidor. | Solo lectura |