Criei um cliente estilo Bruno para servidores MCP

Eu venho escrevendo servidores MCP há alguns meses, e a maior parte desse tempo foi gasta olhando para JSON. Escrevendo manualmente cargas de requisição, avaliando respostas, comparando mentalmente objetos aninhados para verificar se uma chamada de ferramenta realmente funcionou. Meu "teste" não era muito melhor: apontar um LLM para o servidor, pedir para tentar algumas chamadas de ferramenta, ler as vibrações.

Isso não é teste. Isso é esperança.

A questão é a seguinte — LLMs são não-determinísticos por design. Sua camada de protocolo não deveria ser. Se sua ferramenta retorna a forma errada, um campo ausente ou uma resposta de erro quebrada, você não precisa da opinião de um modelo sobre isso. Você precisa de uma asserção falhando.

Então eu construí MCPFlo — um aplicativo Electron de código aberto, com licença MIT, para testar e depurar servidores MCP. A ideia central é entediante de propósito: asserções determinísticas contra respostas reais de protocolo.

expect(result.isError).to.equal(false);
expect(result.content[0].type).to.equal("text");
expect(json.total).to.be.a("number");

Se passar, passa toda vez. Se falhar, você sabe exatamente onde. Sem vibrações envolvidas.

O que ele faz

• Asserções estilo Chai.js contra respostas reais de ferramentas. Escreva testes expect().to.equal() para suas ferramentas, recursos e prompts. Execute-os contra o servidor real, não um mock.

• Formulários gerados automaticamente a partir de seus esquemas. MCPFlo renderiza o esquema de entrada da sua ferramenta como um formulário adequado — incluindo objetos e arrays aninhados — via RJSF. Pare de escrever manualmente cargas JSON para cada chamada de ferramenta. Se seu esquema é profundo e feio, é exatamente quando isso mais importa.

• Visualizador de orçamento de tokens. Veja quanto suas ferramentas, recursos e prompts realmente custam em relação a diferentes janelas de contexto do modelo — antes de descobrir da maneira cara. Um servidor MCP com 40 descrições de ferramentas verbosas está consumindo silenciosamente o orçamento de contexto de alguém. Agora você pode ver isso.

• Suporte a OAuth 2.1, para que você possa testar servidores que realmente exigem autenticação em vez de removê-la para desenvolvimento local.

• Totalmente offline. Sem telemetria, sem dependência de nuvem, sem login, sem nada do lado do servidor. Suas requisições e dados de teste vivem em sua máquina como JSON amigável ao git.

O que ele deliberadamente não faz

MCPFlo não dirá se um LLM usa suas ferramentas bem — se suas descrições são claras o suficiente para um modelo escolher a ferramenta certa no momento certo. Isso é avaliação comportamental, e é uma camada diferente da pilha. MCPFlo cobre a camada abaixo disso: seu servidor realmente faz o que o protocolo diz que faz?

Ambas as camadas importam. Esta ferramenta é para a determinística.

A parte honesta

É cedo. Há arestas ásperas. Eu prefiro lançá-lo e obter feedback real do que continuar polindo em privado.

Se você está construindo ou mantendo servidores MCP, eu realmente gostaria de saber: isso é útil, ou estou resolvendo um problema que ninguém tem?

Repo: github.com/harshalslimaye/mcpflo
Site: mcpflo.com

Fico feliz em responder perguntas ou ser criticado nos comentários.