La calidad de un catálogo MCP: lo que cuesta en contexto, sus annotations y el registro oficial.
tools/list o abre uno de los ejemplos: el informe sale aquí.Cola a resposta tools/list de um servidor MCP —o teu, ou qualquer um— e verifica a qualidade do catálogo: descrições e annotations em falta, tools cujo nome sugere que escrevem ou apagam mas as suas annotations dizem o contrário, custo em contexto por tool, se o campo instructions do catálogo está definido e cabe abaixo de ~2 KB, e se alguma description esconde uma instrução para o modelo (tool poisoning). Nada sai do teu navegador.
Se o servidor MCP é remoto (liga-se através de um URL), escreve-o e clica em «Ler do servidor»: pede-se a sua apresentação (initialize) e a sua lista de tools (tools/list), e audita-se o que devolver, com as suas instructions. Não se chama nenhuma tool nem se envia nenhum token. Funciona se o servidor aceitar pedidos de outra web (CORS) e não pedir autenticação; se não, cola o seu tools/list. Os servidores locais (stdio) não podem ser alcançados a partir de uma web: para esses, cola o tools/list.
Cola também o server.json e verifica os próprios limites do registo oficial do MCP (comprimento dos campos, o padrão do namespace) ANTES de ele rejeitar a tua publicação com um 422 ou um 403 —os dois erros que já sofremos ao publicar os nossos próprios pacotes. Adiciona o package.json para apanhar também um desajuste de versão entre os dois, que o registo rejeita com um 400 depois de já teres autenticado.
Uma tool pode levar uma instrução escondida: invisível para ti —que só vês o nome— mas visível POR COMPLETO para o modelo (caso real: Invariant Labs, "MCP Tool Poisoning Attacks", abril de 2025 — uma tool add com uma etiqueta <IMPORTANT> que pedia para ler ~/.ssh/id_rsa e metê-lo num parâmetro). Procura-se na description e em todo o esquema —nomes de parâmetro, campos não padrão, default, enum, required—, que é onde a CyberArk demonstrou que também se esconde (Full-Schema Poisoning), e também no que venha codificado em base64, hex ou %xx. Marca-se «crítico» só quando a mesma tool pede para ler algo sensível E enviá-lo. E, aparte, «Dá ordens sobre outra tool»: uma descrição que impõe condições a uma tool de OUTRO servidor (o send_email do exemplo da Invariant). Motor do @seguridad, não desta tool.
Um servidor pode mostrar um catálogo inocente no dia em que o aprovas e alterá-lo depois: o protocolo permite anunciar um catálogo novo a quente, e muitos clientes nunca mais te perguntam. Cola nos campos opcionais o tools/list que aprovaste e é comparado com o de hoje: tools novas ou removidas, descrições que agora trazem instruções escondidas, parâmetros novos (por onde sairiam os dados) e annotations que deixaram de dizer «só leitura».
Isto audita o DESIGN do catálogo, não a segurança de acesso. Para «que servidores MCP este repositório confia e o que podem fazer?» usa o Auditor de ficheiros de agente. Para depurar o protocolo em direto, usa o @modelcontextprotocol/inspector oficial da Anthropic. Nomes de tools confundíveis entre si e padrões de código inseguro na FONTE do servidor ainda não são verificados.
La calidad de un catálogo MCP: lo que cuesta en contexto, sus annotations y el registro oficial.
tools/list o abre uno de los ejemplos: el informe sale aquí.