Ir para o conteúdo principal

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.

FerramentaDescriçãoEfeito
tool_listRetorna nomes de ferramentas de negócio, com filtro opcional por categoria.Somente leitura
tool_infoRetorna descrições, esquemas de parâmetros e efeitos de ferramentas selecionadas sem executar operações.Somente leitura
tool_callChama uma ferramenta de negócio para consultar, modificar ou operar dispositivos.Depende da ferramenta
skill_listRetorna nomes e descrições de Skills incluídos com instruções de leitura e download.Somente leitura
skill_readLê o arquivo principal ou uma referência de um Skill, com paginação.Somente leitura

Exemplos de chamadas​

  • tool_list({}): Retorna version e a lista ordenada de nomes tools.
  • tool_list({category:"devices"}): Filtra os nomes das operações por category.
  • 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 array tools; cada item contém o ID interno tool, description, inputSchema (para tool_call.args) e readOnly. tools aceita 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 dicas readCall dos Skills.
  • skill_read({skill:"xxtlancontrol"}): Lê diretamente o Skill principal quando o nome é conhecido; path usa SKILL.md por padrão.
  • skill_read({skill:"xxtlancontrol",path:"references/tasks.md"}): Lê um fluxo pelo link relativo do Skill principal; cursor / maxBytes permitem 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"}}