Referência de ferramentas MCP
O MCP oferece cinco ferramentas: tool_list, tool_info, tool_call, skill_list e skill_read, para nomes de ferramentas de negócio, definições, chamadas de negócio, catálogo de Skills e leitura de seus documentos. O diretório é uma navegação opcional. Consultas de negócio, alterações e ações nos dispositivos usam tool_call, com tool obrigatório. Chame diretamente operações conhecidas; Skills e referências são lidos quando necessário. args é um objeto opcional de parâmetros de negócio.
| Ferramenta | Descrição | Efeito |
|---|---|---|
tool_list | Retorna nomes de ferramentas de negócio, com filtro opcional por categoria. | Somente leitura |
tool_info | Retorna descrições, esquemas de parâmetros e efeitos de ferramentas selecionadas sem executar operações. | Somente leitura |
tool_call | Chama uma ferramenta de negócio para consultar, modificar ou operar dispositivos. | Depende da ferramenta |
skill_list | Retorna nomes e descrições de Skills incluídos com instruções de leitura e download. | Somente leitura |
skill_read | Lê o arquivo principal ou uma referência de um Skill, com paginação. | Somente leitura |
Exemplos de chamadas
tool_list({}): Retornaversione a lista ordenada de nomestools.tool_list({category:"devices"}): Filtra os nomes das operações porcategory.tool_info({tools:"backend_list_devices"}): Descreve o uso de uma ferramenta sem executá-la.tool_info({tools:["backend_list_devices","device_get_status"]}): Descreve várias ferramentas necessárias sem executá-las. Retorna um arraytools; cada item contém o ID internotool,description,inputSchema(paratool_call.args) ereadOnly.toolsaceita uma string não vazia ou um array não vazio de strings, sem limite fixo de itens por lote.tool_call({tool:"backend_list_devices",args:{limit:10}}): Chama diretamente uma ferramenta conhecida para ler a lista de dispositivos necessária.skill_list({}): Lista nomes, descrições e dicasreadCalldos Skills.skill_read({skill:"xxtlancontrol"}): Lê diretamente o Skill principal quando o nome é conhecido;pathusaSKILL.mdpor padrão.skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Lê um fluxo pelo link relativo do Skill principal;cursor/maxBytespermitem paginação.
As dicas de chamada do aplicativo readCall, infoCall e listCall usam {name,args}; name indica uma ferramenta MCP pública. Os IDs dos Skills são retornados em skills[].skill no catálogo e em data.skill nos resultados de leitura.
Cada item de skill_list fornece downloadUrl, uma URL completa da central atual para baixar todo o Skill em ZIP. skill_read retorna o texto do arquivo selecionado e também o link do pacote completo. O ZIP inclui o documento principal, referências e os scripts, modelos e recursos fornecidos com o Skill. Para baixar, os metadados do catálogo bastam; use diretamente um link existente sem ler o texto nem listar novamente.
Quando os nomes forem desconhecidos, consulte tool_list por categoria. Quando os parâmetros não estiverem claros, obtenha as definições necessárias juntas com tool_info e use tool_call. Ferramentas conhecidas podem ser chamadas diretamente, sem consultar antes o diretório ou as definições.
Após uma operação em lote retornar um ID de tarefa, consulte o estado e os itens com falha. Reconecte o MCP após atualizar a central.
Executar um comando de shell no dispositivo
Nas configurações do MCP, ative Permitir a execução de comandos de shell em dispositivos e salve para executar comandos de shell em um dispositivo. A opção vem desativada. Ao desativá-la e salvar, a ferramenta fica oculta em todas as sessões MCP e novas chamadas são recusadas.
command é uma linha de comando completa de até 16384 caracteres, executada pelo shell do dispositivo com -c. O resultado inclui o código de saída, stdout, stderr e um aviso sobre caminhos ao usar um shell roothide.
O tempo limite padrão do comando é de 10 segundos. Para comandos longos, ajuste timeoutMs (por exemplo, 300000 para 5 minutos) e o tempo de espera do cliente MCP. O controlador renova o serviço aux no início e troca sinais de atividade com o dispositivo a cada 30 segundos. Após a última tarefa, o aux encerra depois de 180 segundos de inatividade.
{"tool":"device_run_shell_command","args":{"udid":"DEVICE_UDID","command":"df -h"}}