Vexyo: Testes de Conformidade e Regressão para Servidores MCP

Começou como uma necessidade pessoal

Há algum tempo, eu estava trabalhando em um projeto com alguns servidores MCP conectados a ele. De vez em quando, algo dava errado de forma sutil. O servidor não havia travado, os logs estavam limpos, mas o cliente de IA do outro lado simplesmente se comportava de maneira estranha. Ele pulava uma ferramenta, interpretava um resultado incorretamente ou se desviava. E toda vez, eu perdia uma ou duas horas bisectando commits e relendo a especificação, tentando descobrir qual pequena coisa meu servidor havia parado de fazer corretamente.

Depois da terceira ou quarta vez, eu fiquei cansado de depurar a mesma classe de problema manualmente. O que eu realmente queria era algo que se conectasse ao servidor, verificasse contra a especificação e simplesmente me dissesse claramente o que quebrou e onde, antes de chegar a um cliente. Eu não consegui encontrar uma ferramenta que fizesse isso da maneira que eu queria, então eu construí uma.

O que o vexyo faz

vexyo é um ambiente de teste nativo de CI para servidores MCP. Ele faz duas coisas.

Conformidade. Ele se conecta ao seu servidor exatamente como um cliente de IA faria e executa 16 regras em inicialização, descoberta, semântica de erro e transporte, verificando contra a especificação MCP (2025-11-25). Cada descoberta cita a seção exata da especificação que está sendo aplicada, então você nunca está adivinhando:

✗ discovery/tools-list-available
  tools/list falhou apesar da capacidade de ferramentas estar anunciada
  especificação: Recursos do Servidor §Ferramentas / Listando Ferramentas

15 pass · 1 fail · exit 1

Regressão. Ele registra como suas ferramentas realmente se comportam (conjuntos de referência), e então sinaliza três tipos de desvio em cada commit (esquema, comportamental e cobertura), para que uma mudança que silenciosamente quebra uma ferramenta funcional falhe sua construção em vez de ser enviada.

Ele sai com um código diferente de zero em caso de falha, então ele bloqueia o CI por padrão. A Ação do GitHub imprime um resumo do trabalho que você pode agir, com a regra, severidade, citação da especificação e correção, diretamente no PR. Esse resumo de trabalho é exatamente a coisa que eu gostaria de ter tido durante aquelas sessões de depuração.

Funciona com qualquer linguagem

vexyo se comunica com seu servidor através de seu transporte (stdio ou HTTP Streamable), não através do seu tempo de execução. Portanto, ele testa servidores MCP escritos em Python, TypeScript, Go, PHP, qualquer coisa. Aponte para um comando ou uma URL HTTP:

import { defineConfig } from '@vexyo/cli/config';

export default defineConfig({
  specVersion: '2025-11-25',
  target: { transport: 'stdio', command: 'python', args: ['-m', 'my_server'] },
});

Experimente

npm i -D @vexyo/cli
npx vexyo init
npx vexyo run

Isso cria uma configuração, aponta para seu servidor e fornece um primeiro resultado em alguns minutos.

• Docs: https://vexyo.dev
• Repo: https://github.com/vexyohq/vexyo
• É gratuito e de código aberto (Apache-2.0).

Ele resolveu meu próprio problema primeiro, e estou genuinamente curioso sobre o que quebra primeiro para outras pessoas. Se você executá-lo contra seu servidor, eu adoraria saber o que ele pegou (ou errou).

PS. Se você tentar, me diga o que ele pegou ou o que ele perdeu. É assim que ele melhora. Perguntas e problemas são muito bem-vindos.