Ir para o conteúdo principal

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)​

FerramentaDescriçãoEfeito
backend_discover_devicesEnviar a transmissão de descoberta UDP.Pode modificar
backend_import_deviceImportar um dispositivo por endereço.Pode modificar
backend_import_devicesEnviar uma tarefa de importação de dispositivos.Pode modificar
backend_list_devicesListar os dispositivos registrados.Somente leitura
backend_scan_ipsVerificar as respostas TCP em endereços e portas IPv4.Pode modificar
backend_scan_networksListar os prefixos IPv4 do servidor.Somente leitura
device_check_authLer o estado da licença XXTouch.Somente leitura
device_clear_app_dataEsvaziar os dados do aplicativo indicado.Pode modificar
device_clear_logsEsvaziar o histórico persistente de logs do dispositivo.Pode modificar
device_collect_realtime_logsLer os logs de scripts em tempo real.Somente leitura
device_delete_recordExcluir um registro de dispositivo do servidor.Pode modificar
device_export_logsExportar o histórico persistente de logs do dispositivo.Pode modificar
device_get_app_pathsLer os caminhos de contêiner, grupos e plugins do aplicativo.Somente leitura
device_get_applistListar os metadados de aplicativos do dispositivo.Somente leitura
device_get_statusLer o estado atual de um dispositivo.Somente leitura
device_get_xxtlc_logsLer os logs salvos de um canal do controle central.Somente leitura
device_input_sequenceExecutar uma sequência de toques, teclas e esperas.Pode modificar
device_install_packageAtualizar o XXTouch no dispositivo.Pode modificar
device_list_appsListar os aplicativos instalados e seus identificadores.Somente leitura
device_lockSolicitar o bloqueio de tela do dispositivo.Pode modificar
device_package_update_statusLer o progresso de atualização do XXTouch no Android Root.Somente leitura
device_rebootSolicitar a reinicialização do dispositivo.Pode modificar
device_respringSolicitar o reinício do SpringBoard.Pode modificar
device_set_brightnessDefinir o brilho do dispositivo.Pode modificar
device_set_volumeDefinir o volume do dispositivo.Pode modificar
device_trollstore_installSolicitar a instalação de IPA/TIPA pelo TrollStore.Pode modificar
device_ui_element_actionExecutar uma ação em um elemento UI.Pode modificar
device_ui_element_queryLer os elementos UI por seletor ou posição.Somente leitura
device_ui_element_snapshotLer os elementos UI, limites e disponibilidade.Somente leitura
device_unlockSolicitar o desbloqueio de tela do dispositivo.Pode modificar

Grupos (groups)​

FerramentaDescriçãoEfeito
backend_group_add_devicesAdicionar os membros do grupo.Pode modificar
backend_group_createCriar os grupos de dispositivos.Pode modificar
backend_group_deleteExcluir os grupos de dispositivos.Pode modificar
backend_group_delete_script_configExcluir a configuração de grupo de um script.Pode modificar
backend_group_get_script_configLer a configuração de grupo de um script.Somente leitura
backend_group_listListar os grupos de dispositivos.Somente leitura
backend_group_list_script_configsListar as configurações de scripts salvas do grupo.Somente leitura
backend_group_remove_devicesRemover os membros do grupo.Pode modificar
backend_group_renameRenomear os grupos de dispositivos.Pode modificar
backend_group_reorderReordenar os grupos de dispositivos.Pode modificar
backend_group_set_scriptDefinir o script vinculado ao grupo.Pode modificar
backend_group_set_script_configSubstituir por completo a configuração de grupo de um script.Pode modificar

Scripts (scripts)​

FerramentaDescriçãoEfeito
backend_list_scriptsListar os scripts executáveis do servidor.Somente leitura
backend_read_scriptLer o conteúdo UTF-8 de um script do servidor.Somente leitura
backend_write_scriptGravar ou sobrescrever o conteúdo UTF-8 de um script do servidor.Pode modificar
device_get_selected_scriptLer o script selecionado no dispositivo.Somente leitura
device_launch_scriptExecutar o script do dispositivo.Pode modificar
device_pause_scriptPausar o script do dispositivo.Pode modificar
device_resume_scriptRetomar o script do dispositivo.Pode modificar
device_run_script_snippetExecutar um trecho curto de Lua no dispositivo.Pode modificar
device_select_scriptDefinir o script selecionado no dispositivo.Pode modificar
device_send_script_and_encryptExecutar a criptografia no dispositivo e gravação no servidor de um script ou projeto.Pode modificar
device_send_script_and_runExecutar a transferência e início de um script ou projeto.Pode modificar
device_stop_scriptParar o script do dispositivo.Pode modificar
device_upload_scriptExecutar o envio de um script do servidor ao dispositivo.Pode modificar

Arquivos (files)​

FerramentaDescriçãoEfeito
backend_file_copyCopiar os arquivos ou diretórios do servidor.Pode modificar
backend_file_deleteExcluir os arquivos ou diretórios do servidor.Pode modificar
backend_file_existsVerificar os arquivos ou diretórios do servidor.Somente leitura
backend_file_hashLer as somas de verificação dos arquivos do servidor.Somente leitura
backend_file_listListar os arquivos ou diretórios do servidor.Somente leitura
backend_file_mkdirCriar os diretórios do servidor.Pode modificar
backend_file_moveMover os arquivos ou diretórios do servidor.Pode modificar
backend_file_readLer o conteúdo de arquivos do servidor.Somente leitura
backend_file_renameRenomear os arquivos ou diretórios do servidor.Pode modificar
backend_file_writeGravar ou sobrescrever o conteúdo de arquivos do servidor.Pode modificar
device_root_file_copyCopiar os arquivos ou diretórios do dispositivo por caminho absoluto.Pode modificar
device_root_file_listListar os arquivos ou diretórios do dispositivo por caminho absoluto.Somente leitura
device_root_file_mkdirCriar um diretório do dispositivo por caminho absoluto.Pode modificar
device_root_file_moveMover os arquivos ou diretórios do dispositivo por caminho absoluto.Pode modificar
device_root_file_removeExcluir os arquivos ou diretórios do dispositivo por caminho absoluto.Pode modificar
device_root_file_save_to_backendExecutar a gravação de arquivos de caminho absoluto do dispositivo no servidor.Pode modificar
device_root_file_statLer os metadados de arquivos do dispositivo por caminho absoluto.Somente leitura
device_xxt_home_file_copyCopiar os arquivos ou diretórios do XXT Home.Pode modificar
device_xxt_home_file_listListar os arquivos ou diretórios do XXT Home.Somente leitura
device_xxt_home_file_mkdirCriar os diretórios do XXT Home.Pode modificar
device_xxt_home_file_moveMover os arquivos ou diretórios do XXT Home.Pode modificar
device_xxt_home_file_readLer o conteúdo de arquivos do XXT Home.Somente leitura
device_xxt_home_file_removeExcluir um arquivo do XXT Home.Pode modificar
device_xxt_home_file_rmdirExcluir os diretórios vazios do XXT Home.Pode modificar
device_xxt_home_file_writeGravar ou sobrescrever o conteúdo de arquivos do XXT Home.Pode modificar
device_xxt_home_save_file_to_backendSalvar um arquivo ou diretório do XXT Home em um diretório do servidor.Pode modificar
device_xxt_home_send_filesEnviar arquivos ou diretórios do servidor para o XXT Home do dispositivo.Pode modificar

Imagens (images)​

FerramentaDescriçãoEfeito
backend_binarize_imageExecutar a binarização e gravação de uma imagem.Pode modificar
backend_crop_imageExecutar o recorte retangular e gravação de uma imagem.Pode modificar
backend_extract_matrixExecutar a extração de matriz de um glifo e gravação de imagem.Pode modificar
backend_fit_binary_selectionExecutar o ajuste da seleção ao conteúdo binário.Somente leitura
backend_matrix_line_from_binary_imageExecutar a conversão de imagem binária em uma linha MatrixDict.Somente leitura
backend_pick_image_colorsLer as cores dos pixels da imagem.Somente leitura
backend_split_matrixExecutar a divisão de uma faixa de glifos em matrizes por colunas vazias.Somente leitura
backend_view_imageLer a prévia de uma imagem do servidor.Somente leitura
device_get_screen_sizeLer o tamanho físico da tela e a conversão de coordenadas.Somente leitura
device_get_screenshotLer uma captura do dispositivo e suas coordenadas.Somente leitura

Dados (data)​

FerramentaDescriçãoEfeito
backend_kvdb_dict_clearEsvaziar as entradas de um dicionário KVDB.Pode modificar
backend_kvdb_dict_createCriar os dicionários KVDB.Pode modificar
backend_kvdb_dict_delete_allExcluir os dicionários KVDB.Pode modificar
backend_kvdb_dict_delete_keyExcluir uma chave de dicionário KVDB.Pode modificar
backend_kvdb_dict_delete_keysExcluir as chaves selecionadas do dicionário KVDB.Pode modificar
backend_kvdb_dict_getLer um valor de dicionário KVDB.Somente leitura
backend_kvdb_dict_get_allListar as entradas de um dicionário KVDB.Somente leitura
backend_kvdb_dict_incrIncrementar atomicamente uma string de inteiro no dicionário.Pode modificar
backend_kvdb_dict_putGravar ou sobrescrever um valor de dicionário KVDB.Pode modificar
backend_kvdb_dict_renameRenomear os dicionários KVDB.Pode modificar
backend_kvdb_dict_replaceSubstituir por completo as entradas de um dicionário KVDB.Pode modificar
backend_kvdb_dict_upsertMesclar e gravar as entradas de um dicionário KVDB.Pode modificar
backend_kvdb_exportExportar um backup SQLite completo do KVDB.Pode modificar
backend_kvdb_importImportar um backup SQLite completo do KVDB.Pode modificar
backend_kvdb_list_dictsListar os dicionários KVDB.Somente leitura
backend_kvdb_list_queuesListar as filas KVDB.Somente leitura
backend_kvdb_queue_clearEsvaziar os valores de uma fila KVDB.Pode modificar
backend_kvdb_queue_countContar os valores de uma fila KVDB.Somente leitura
backend_kvdb_queue_createCriar as filas KVDB.Pode modificar
backend_kvdb_queue_delete_allExcluir as filas KVDB.Pode modificar
backend_kvdb_queue_delete_indicesExcluir os itens da fila nas posições indicadas.Pode modificar
backend_kvdb_queue_listListar os valores de uma fila KVDB.Somente leitura
backend_kvdb_queue_moveExecutar uma transferência atômica entre filas KVDB.Pode modificar
backend_kvdb_queue_popConsumir e retornar os valores de uma fila KVDB.Pode modificar
backend_kvdb_queue_pushEnfileirar os valores de uma fila KVDB.Pode modificar
backend_kvdb_queue_renameRenomear as filas KVDB.Pode modificar
backend_kvdb_queue_replaceSubstituir por completo os valores de uma fila KVDB.Pode modificar
backend_tabledb_add_columnsAdicionar as colunas de usuário TableDB.Pode modificar
backend_tabledb_add_rowsAdicionar as linhas TableDB.Pode modificar
backend_tabledb_count_rowsContar as linhas TableDB que atendem às condições.Somente leitura
backend_tabledb_createCriar as tabelas TableDB.Pode modificar
backend_tabledb_delete_rowsExcluir as linhas TableDB.Pode modificar
backend_tabledb_delete_tableExcluir as tabelas TableDB.Pode modificar
backend_tabledb_drop_columnsExcluir as colunas de usuário TableDB.Pode modificar
backend_tabledb_edit_rowsAtualizar as linhas TableDB.Pode modificar
backend_tabledb_exportExportar as linhas TableDB.Pode modificar
backend_tabledb_export_allExportar um backup SQLite completo do TableDB.Pode modificar
backend_tabledb_export_selectionExportar as linhas e colunas TableDB selecionadas.Pode modificar
backend_tabledb_fetch_oneExecutar a obtenção atômica de uma linha com atualização opcional.Pode modificar
backend_tabledb_get_rowLer uma linha TableDB por ID.Somente leitura
backend_tabledb_get_schemaLer o esquema de uma tabela TableDB.Somente leitura
backend_tabledb_importImportar as linhas TableDB.Pode modificar
backend_tabledb_import_allImportar um backup SQLite completo do TableDB.Pode modificar
backend_tabledb_list_rowsListar as linhas TableDB.Somente leitura
backend_tabledb_list_tablesListar as tabelas TableDB.Somente leitura
backend_tabledb_rename_columnRenomear as colunas de usuário TableDB.Pode modificar
backend_tabledb_rename_tableRenomear as tabelas TableDB.Pode modificar
backend_tabledb_reorder_columnsDefinir a ordem das colunas TableDB.Pode modificar
backend_tabledb_truncateEsvaziar as linhas TableDB.Pode modificar

Agendamentos (schedules)​

FerramentaDescriçãoEfeito
backend_schedule_cancel_runCancelar uma execução agendada.Pode modificar
backend_schedule_createCriar as definições de agendamentos.Pode modificar
backend_schedule_deleteExcluir os agendamentos.Pode modificar
backend_schedule_exportExportar um backup JSON de agendamentos.Somente leitura
backend_schedule_getLer as definições de agendamentos.Somente leitura
backend_schedule_importImportar um backup JSON de agendamentos.Pode modificar
backend_schedule_listListar os agendamentos.Somente leitura
backend_schedule_list_runsListar o histórico e estado de execuções agendadas.Somente leitura
backend_schedule_runEnviar uma execução agendada.Pode modificar
backend_schedule_set_enabledDefinir o estado do gatilho automático de um agendamento.Pode modificar
backend_schedule_updateSubstituir por completo as definições de agendamentos.Pode modificar
backend_schedule_validateValidar estaticamente e normalizar as definições de agendamentos.Somente leitura

Tarefas em segundo plano (tasks)​

FerramentaDescriçãoEfeito
backend_batch_authorize_continueRetomar uma tarefa de autorização em lote.Pode modificar
backend_batch_authorize_pausePausar uma tarefa de autorização em lote.Pode modificar
backend_batch_authorize_startEnviar uma tarefa de autorização em lote.Pode modificar
backend_batch_executeEnviar uma tarefa de operações de dispositivos em lote.Pode modificar
backend_task_cancelSolicitar o cancelamento de uma tarefa em segundo plano.Pode modificar
backend_task_getLer o estado e resumo de uma tarefa em segundo plano.Somente leitura
backend_task_listListar as tarefas em segundo plano de uma origem.Somente leitura
backend_task_resultsLer os resultados individuais de uma tarefa em segundo plano.Somente leitura
backend_task_retryTentar novamente os itens com falha de uma tarefa Agent encerrada.Pode modificar

Sessões IDE (ide)​

FerramentaDescriçãoEfeito
ide_bind_sessionDefinir a sessão IDE vinculada à conexão MCP atual.Pode modificar
ide_get_bound_sessionLer a sessão IDE vinculada à conexão MCP atual.Somente leitura
ide_get_contextLer o contexto IDE de espaço de trabalho, arquivo e seleção.Somente leitura
ide_list_sessionsListar as sessões IDE ativas.Somente leitura
ide_resolve_selected_deviceLer o dispositivo selecionado no IDE.Somente leitura

Assistência humana (assist)​

FerramentaDescriçãoEfeito
xxt_assist_cancel_taskCancelar as tarefas de assistência humana.Pode modificar
xxt_assist_create_taskCriar as tarefas de assistência humana.Pode modificar
xxt_assist_get_taskLer o estado e resultado de uma tarefa de assistência.Somente leitura
xxt_assist_list_tasksListar as tarefas de assistência humana.Somente leitura
xxt_assist_wait_resultSolicitar a espera por um resultado de assistência.Somente leitura

Sistema (system)​

FerramentaDescriçãoEfeito
backend_get_app_configLer as configurações públicas tipadas do aplicativo.Somente leitura
backend_get_configLer uma entrada de configuração de texto.Somente leitura
backend_healthVerificar a disponibilidade do servidor.Somente leitura
backend_rename_devicesAtualizar os nomes dos dispositivos e sincronizar os registros.Pode modificar
backend_set_app_configAtualizar as configurações públicas tipadas do aplicativo.Pode modificar
backend_set_configDefinir uma entrada de configuração de texto.Pode modificar
backend_versionLer a versão do servidor.Somente leitura