Catálogo de operações de negócio MCP
As operações de negócio MCP são agrupadas pela categoria de tool_list. Passe o nome em tool para tool_call e os parâmetros de negócio em args. Consulte tool_info para todos os parâmetros e restrições. Somente leitura e Pode modificar seguem a marca readOnly de cada definição.
XXT Home (XXT_HOME_PATH) é o diretório de trabalho do XXTouch no dispositivo.
Dispositivos (devices)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_discover_devices | Enviar a transmissão de descoberta UDP. | Pode modificar |
backend_import_device | Importar um dispositivo por endereço. | Pode modificar |
backend_import_devices | Enviar uma tarefa de importação de dispositivos. | Pode modificar |
backend_list_devices | Listar os dispositivos registrados. | Somente leitura |
backend_scan_ips | Verificar as respostas TCP em endereços e portas IPv4. | Pode modificar |
backend_scan_networks | Listar os prefixos IPv4 do servidor. | Somente leitura |
device_check_auth | Ler o estado da licença XXTouch. | Somente leitura |
device_clear_app_data | Esvaziar os dados do aplicativo indicado. | Pode modificar |
device_clear_logs | Esvaziar o histórico persistente de logs do dispositivo. | Pode modificar |
device_collect_realtime_logs | Ler os logs de scripts em tempo real. | Somente leitura |
device_delete_record | Excluir um registro de dispositivo do servidor. | Pode modificar |
device_export_logs | Exportar o histórico persistente de logs do dispositivo. | Pode modificar |
device_get_app_paths | Ler os caminhos de contêiner, grupos e plugins do aplicativo. | Somente leitura |
device_get_applist | Listar os metadados de aplicativos do dispositivo. | Somente leitura |
device_get_status | Ler o estado atual de um dispositivo. | Somente leitura |
device_get_xxtlc_logs | Ler os logs salvos de um canal do controle central. | Somente leitura |
device_input_sequence | Executar uma sequência de toques, teclas e esperas. | Pode modificar |
device_install_package | Atualizar o XXTouch no dispositivo. | Pode modificar |
device_list_apps | Listar os aplicativos instalados e seus identificadores. | Somente leitura |
device_lock | Solicitar o bloqueio de tela do dispositivo. | Pode modificar |
device_package_update_status | Ler o progresso de atualização do XXTouch no Android Root. | Somente leitura |
device_reboot | Solicitar a reinicialização do dispositivo. | Pode modificar |
device_respring | Solicitar o reinício do SpringBoard. | Pode modificar |
device_set_brightness | Definir o brilho do dispositivo. | Pode modificar |
device_set_volume | Definir o volume do dispositivo. | Pode modificar |
device_trollstore_install | Solicitar a instalação de IPA/TIPA pelo TrollStore. | Pode modificar |
device_ui_element_action | Executar uma ação em um elemento UI. | Pode modificar |
device_ui_element_query | Ler os elementos UI por seletor ou posição. | Somente leitura |
device_ui_element_snapshot | Ler os elementos UI, limites e disponibilidade. | Somente leitura |
device_unlock | Solicitar o desbloqueio de tela do dispositivo. | Pode modificar |
Grupos (groups)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_group_add_devices | Adicionar os membros do grupo. | Pode modificar |
backend_group_create | Criar os grupos de dispositivos. | Pode modificar |
backend_group_delete | Excluir os grupos de dispositivos. | Pode modificar |
backend_group_delete_script_config | Excluir a configuração de grupo de um script. | Pode modificar |
backend_group_get_script_config | Ler a configuração de grupo de um script. | Somente leitura |
backend_group_list | Listar os grupos de dispositivos. | Somente leitura |
backend_group_list_script_configs | Listar as configurações de scripts salvas do grupo. | Somente leitura |
backend_group_remove_devices | Remover os membros do grupo. | Pode modificar |
backend_group_rename | Renomear os grupos de dispositivos. | Pode modificar |
backend_group_reorder | Reordenar os grupos de dispositivos. | Pode modificar |
backend_group_set_script | Definir o script vinculado ao grupo. | Pode modificar |
backend_group_set_script_config | Substituir por completo a configuração de grupo de um script. | Pode modificar |
Scripts (scripts)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_list_scripts | Listar os scripts executáveis do servidor. | Somente leitura |
backend_read_script | Ler o conteúdo UTF-8 de um script do servidor. | Somente leitura |
backend_write_script | Gravar ou sobrescrever o conteúdo UTF-8 de um script do servidor. | Pode modificar |
device_get_selected_script | Ler o script selecionado no dispositivo. | Somente leitura |
device_launch_script | Executar o script do dispositivo. | Pode modificar |
device_pause_script | Pausar o script do dispositivo. | Pode modificar |
device_resume_script | Retomar o script do dispositivo. | Pode modificar |
device_run_script_snippet | Executar um trecho curto de Lua no dispositivo. | Pode modificar |
device_select_script | Definir o script selecionado no dispositivo. | Pode modificar |
device_send_script_and_encrypt | Executar a criptografia no dispositivo e gravação no servidor de um script ou projeto. | Pode modificar |
device_send_script_and_run | Executar a transferência e início de um script ou projeto. | Pode modificar |
device_stop_script | Parar o script do dispositivo. | Pode modificar |
device_upload_script | Executar o envio de um script do servidor ao dispositivo. | Pode modificar |
Arquivos (files)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_file_copy | Copiar os arquivos ou diretórios do servidor. | Pode modificar |
backend_file_delete | Excluir os arquivos ou diretórios do servidor. | Pode modificar |
backend_file_exists | Verificar os arquivos ou diretórios do servidor. | Somente leitura |
backend_file_hash | Ler as somas de verificação dos arquivos do servidor. | Somente leitura |
backend_file_list | Listar os arquivos ou diretórios do servidor. | Somente leitura |
backend_file_mkdir | Criar os diretórios do servidor. | Pode modificar |
backend_file_move | Mover os arquivos ou diretórios do servidor. | Pode modificar |
backend_file_read | Ler o conteúdo de arquivos do servidor. | Somente leitura |
backend_file_rename | Renomear os arquivos ou diretórios do servidor. | Pode modificar |
backend_file_write | Gravar ou sobrescrever o conteúdo de arquivos do servidor. | Pode modificar |
device_root_file_copy | Copiar os arquivos ou diretórios do dispositivo por caminho absoluto. | Pode modificar |
device_root_file_list | Listar os arquivos ou diretórios do dispositivo por caminho absoluto. | Somente leitura |
device_root_file_mkdir | Criar um diretório do dispositivo por caminho absoluto. | Pode modificar |
device_root_file_move | Mover os arquivos ou diretórios do dispositivo por caminho absoluto. | Pode modificar |
device_root_file_remove | Excluir os arquivos ou diretórios do dispositivo por caminho absoluto. | Pode modificar |
device_root_file_save_to_backend | Executar a gravação de arquivos de caminho absoluto do dispositivo no servidor. | Pode modificar |
device_root_file_stat | Ler os metadados de arquivos do dispositivo por caminho absoluto. | Somente leitura |
device_xxt_home_file_copy | Copiar os arquivos ou diretórios do XXT Home. | Pode modificar |
device_xxt_home_file_list | Listar os arquivos ou diretórios do XXT Home. | Somente leitura |
device_xxt_home_file_mkdir | Criar os diretórios do XXT Home. | Pode modificar |
device_xxt_home_file_move | Mover os arquivos ou diretórios do XXT Home. | Pode modificar |
device_xxt_home_file_read | Ler o conteúdo de arquivos do XXT Home. | Somente leitura |
device_xxt_home_file_remove | Excluir um arquivo do XXT Home. | Pode modificar |
device_xxt_home_file_rmdir | Excluir os diretórios vazios do XXT Home. | Pode modificar |
device_xxt_home_file_write | Gravar ou sobrescrever o conteúdo de arquivos do XXT Home. | Pode modificar |
device_xxt_home_save_file_to_backend | Salvar um arquivo ou diretório do XXT Home em um diretório do servidor. | Pode modificar |
device_xxt_home_send_files | Enviar arquivos ou diretórios do servidor para o XXT Home do dispositivo. | Pode modificar |
Imagens (images)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_binarize_image | Executar a binarização e gravação de uma imagem. | Pode modificar |
backend_crop_image | Executar o recorte retangular e gravação de uma imagem. | Pode modificar |
backend_extract_matrix | Executar a extração de matriz de um glifo e gravação de imagem. | Pode modificar |
backend_fit_binary_selection | Executar o ajuste da seleção ao conteúdo binário. | Somente leitura |
backend_matrix_line_from_binary_image | Executar a conversão de imagem binária em uma linha MatrixDict. | Somente leitura |
backend_pick_image_colors | Ler as cores dos pixels da imagem. | Somente leitura |
backend_split_matrix | Executar a divisão de uma faixa de glifos em matrizes por colunas vazias. | Somente leitura |
backend_view_image | Ler a prévia de uma imagem do servidor. | Somente leitura |
device_get_screen_size | Ler o tamanho físico da tela e a conversão de coordenadas. | Somente leitura |
device_get_screenshot | Ler uma captura do dispositivo e suas coordenadas. | Somente leitura |
Dados (data)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_kvdb_dict_clear | Esvaziar as entradas de um dicionário KVDB. | Pode modificar |
backend_kvdb_dict_create | Criar os dicionários KVDB. | Pode modificar |
backend_kvdb_dict_delete_all | Excluir os dicionários KVDB. | Pode modificar |
backend_kvdb_dict_delete_key | Excluir uma chave de dicionário KVDB. | Pode modificar |
backend_kvdb_dict_delete_keys | Excluir as chaves selecionadas do dicionário KVDB. | Pode modificar |
backend_kvdb_dict_get | Ler um valor de dicionário KVDB. | Somente leitura |
backend_kvdb_dict_get_all | Listar as entradas de um dicionário KVDB. | Somente leitura |
backend_kvdb_dict_incr | Incrementar atomicamente uma string de inteiro no dicionário. | Pode modificar |
backend_kvdb_dict_put | Gravar ou sobrescrever um valor de dicionário KVDB. | Pode modificar |
backend_kvdb_dict_rename | Renomear os dicionários KVDB. | Pode modificar |
backend_kvdb_dict_replace | Substituir por completo as entradas de um dicionário KVDB. | Pode modificar |
backend_kvdb_dict_upsert | Mesclar e gravar as entradas de um dicionário KVDB. | Pode modificar |
backend_kvdb_export | Exportar um backup SQLite completo do KVDB. | Pode modificar |
backend_kvdb_import | Importar um backup SQLite completo do KVDB. | Pode modificar |
backend_kvdb_list_dicts | Listar os dicionários KVDB. | Somente leitura |
backend_kvdb_list_queues | Listar as filas KVDB. | Somente leitura |
backend_kvdb_queue_clear | Esvaziar os valores de uma fila KVDB. | Pode modificar |
backend_kvdb_queue_count | Contar os valores de uma fila KVDB. | Somente leitura |
backend_kvdb_queue_create | Criar as filas KVDB. | Pode modificar |
backend_kvdb_queue_delete_all | Excluir as filas KVDB. | Pode modificar |
backend_kvdb_queue_delete_indices | Excluir os itens da fila nas posições indicadas. | Pode modificar |
backend_kvdb_queue_list | Listar os valores de uma fila KVDB. | Somente leitura |
backend_kvdb_queue_move | Executar uma transferência atômica entre filas KVDB. | Pode modificar |
backend_kvdb_queue_pop | Consumir e retornar os valores de uma fila KVDB. | Pode modificar |
backend_kvdb_queue_push | Enfileirar os valores de uma fila KVDB. | Pode modificar |
backend_kvdb_queue_rename | Renomear as filas KVDB. | Pode modificar |
backend_kvdb_queue_replace | Substituir por completo os valores de uma fila KVDB. | Pode modificar |
backend_tabledb_add_columns | Adicionar as colunas de usuário TableDB. | Pode modificar |
backend_tabledb_add_rows | Adicionar as linhas TableDB. | Pode modificar |
backend_tabledb_count_rows | Contar as linhas TableDB que atendem às condições. | Somente leitura |
backend_tabledb_create | Criar as tabelas TableDB. | Pode modificar |
backend_tabledb_delete_rows | Excluir as linhas TableDB. | Pode modificar |
backend_tabledb_delete_table | Excluir as tabelas TableDB. | Pode modificar |
backend_tabledb_drop_columns | Excluir as colunas de usuário TableDB. | Pode modificar |
backend_tabledb_edit_rows | Atualizar as linhas TableDB. | Pode modificar |
backend_tabledb_export | Exportar as linhas TableDB. | Pode modificar |
backend_tabledb_export_all | Exportar um backup SQLite completo do TableDB. | Pode modificar |
backend_tabledb_export_selection | Exportar as linhas e colunas TableDB selecionadas. | Pode modificar |
backend_tabledb_fetch_one | Executar a obtenção atômica de uma linha com atualização opcional. | Pode modificar |
backend_tabledb_get_row | Ler uma linha TableDB por ID. | Somente leitura |
backend_tabledb_get_schema | Ler o esquema de uma tabela TableDB. | Somente leitura |
backend_tabledb_import | Importar as linhas TableDB. | Pode modificar |
backend_tabledb_import_all | Importar um backup SQLite completo do TableDB. | Pode modificar |
backend_tabledb_list_rows | Listar as linhas TableDB. | Somente leitura |
backend_tabledb_list_tables | Listar as tabelas TableDB. | Somente leitura |
backend_tabledb_rename_column | Renomear as colunas de usuário TableDB. | Pode modificar |
backend_tabledb_rename_table | Renomear as tabelas TableDB. | Pode modificar |
backend_tabledb_reorder_columns | Definir a ordem das colunas TableDB. | Pode modificar |
backend_tabledb_truncate | Esvaziar as linhas TableDB. | Pode modificar |
Agendamentos (schedules)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_schedule_cancel_run | Cancelar uma execução agendada. | Pode modificar |
backend_schedule_create | Criar as definições de agendamentos. | Pode modificar |
backend_schedule_delete | Excluir os agendamentos. | Pode modificar |
backend_schedule_export | Exportar um backup JSON de agendamentos. | Somente leitura |
backend_schedule_get | Ler as definições de agendamentos. | Somente leitura |
backend_schedule_import | Importar um backup JSON de agendamentos. | Pode modificar |
backend_schedule_list | Listar os agendamentos. | Somente leitura |
backend_schedule_list_runs | Listar o histórico e estado de execuções agendadas. | Somente leitura |
backend_schedule_run | Enviar uma execução agendada. | Pode modificar |
backend_schedule_set_enabled | Definir o estado do gatilho automático de um agendamento. | Pode modificar |
backend_schedule_update | Substituir por completo as definições de agendamentos. | Pode modificar |
backend_schedule_validate | Validar estaticamente e normalizar as definições de agendamentos. | Somente leitura |
Tarefas em segundo plano (tasks)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_batch_authorize_continue | Retomar uma tarefa de autorização em lote. | Pode modificar |
backend_batch_authorize_pause | Pausar uma tarefa de autorização em lote. | Pode modificar |
backend_batch_authorize_start | Enviar uma tarefa de autorização em lote. | Pode modificar |
backend_batch_execute | Enviar uma tarefa de operações de dispositivos em lote. | Pode modificar |
backend_task_cancel | Solicitar o cancelamento de uma tarefa em segundo plano. | Pode modificar |
backend_task_get | Ler o estado e resumo de uma tarefa em segundo plano. | Somente leitura |
backend_task_list | Listar as tarefas em segundo plano de uma origem. | Somente leitura |
backend_task_results | Ler os resultados individuais de uma tarefa em segundo plano. | Somente leitura |
backend_task_retry | Tentar novamente os itens com falha de uma tarefa Agent encerrada. | Pode modificar |
Sessões IDE (ide)
| Ferramenta | Descrição | Efeito |
|---|---|---|
ide_bind_session | Definir a sessão IDE vinculada à conexão MCP atual. | Pode modificar |
ide_get_bound_session | Ler a sessão IDE vinculada à conexão MCP atual. | Somente leitura |
ide_get_context | Ler o contexto IDE de espaço de trabalho, arquivo e seleção. | Somente leitura |
ide_list_sessions | Listar as sessões IDE ativas. | Somente leitura |
ide_resolve_selected_device | Ler o dispositivo selecionado no IDE. | Somente leitura |
Assistência humana (assist)
| Ferramenta | Descrição | Efeito |
|---|---|---|
xxt_assist_cancel_task | Cancelar as tarefas de assistência humana. | Pode modificar |
xxt_assist_create_task | Criar as tarefas de assistência humana. | Pode modificar |
xxt_assist_get_task | Ler o estado e resultado de uma tarefa de assistência. | Somente leitura |
xxt_assist_list_tasks | Listar as tarefas de assistência humana. | Somente leitura |
xxt_assist_wait_result | Solicitar a espera por um resultado de assistência. | Somente leitura |
Sistema (system)
| Ferramenta | Descrição | Efeito |
|---|---|---|
backend_get_app_config | Ler as configurações públicas tipadas do aplicativo. | Somente leitura |
backend_get_config | Ler uma entrada de configuração de texto. | Somente leitura |
backend_health | Verificar a disponibilidade do servidor. | Somente leitura |
backend_rename_devices | Atualizar os nomes dos dispositivos e sincronizar os registros. | Pode modificar |
backend_set_app_config | Atualizar as configurações públicas tipadas do aplicativo. | Pode modificar |
backend_set_config | Definir uma entrada de configuração de texto. | Pode modificar |
backend_version | Ler a versão do servidor. | Somente leitura |