MCP Rigor

oficial

Servidor MCP que dá aos agentes de codificação de IA um loop de teste determinístico para os servidores MCP que eles constroem: escreva testes de aceitação em linguagem natural, valide a redação, execute-os e leia resultados estruturados de aprovação/reprovação — nenhuma IA interpreta os testes em tempo de execução. Execute com: npx mcprigor serve <projeto>. Também um framework completo de testes CLI/CI com detecção de desvio de contrato e paridade de transporte. Apache-2.0.

Ver em mcprigor.com

O que você pode fazer com Rigor MCP?

  • Validar arquivos de teste — Peça para executar npx mcprigor check em um arquivo .mcpr para verificar a sintaxe e a prontidão sem conectar a um servidor.
  • Executar testes de aceitação — Execute npx mcprigor test em um arquivo .mcpr para chamar ferramentas MCP e verificar resultados estruturados como structuredContent.sum.
  • Gerar relatórios HTML — Solicite a produção de um relatório de teste compartilhável para tickets ou artefatos de CI.
  • Descobrir ferramentas por meio de autoria guiada — Use npx mcprigor author para detectar automaticamente ferramentas, recursos e prompts, e então gerar um arquivo de teste interativamente.
  • Iniciar o workspace de QA — Inicie npx mcprigor workspace . para editar, validar e executar múltiplas suítes de teste com realce de sintaxe e histórico de execução.

Documentação

Este guia leva você da instalação até um teste MCP aprovado.

1. Instalar o MCP Rigor

Você precisa do Node.js 20 ou 22. O MCP Rigor é publicado no npm como mcprigor — o pacote já inclui código compilado pronto para execução, então não há nada para compilar a partir do código-fonte.

mkdir mcp-acceptance-tests
cd mcp-acceptance-tests
npm init -y
npm install mcprigor

Para verificar a instalação:

npx mcprigor --help

2. Criar um arquivo de teste

Crie o arquivo calculator.mcpr:

MCP Test 1

Suite: "Calculator acceptance tests"
Server: node ../calculator-server/dist/server.js

Test: "Adding 20 and 22 gives 42"
  Call tool "add" with:
    a: 20
    b: 22

  Expect "structuredContent.sum" equals 42

Altere o comando Server para o comando que inicia o seu servidor MCP.

Para um servidor Streamable HTTP implantado, use:

MCP URL: https://qa.example.com/mcp

3. Verificar a redação

npx mcprigor check calculator.mcpr

Um arquivo válido exibe:

✓ calculator.mcpr looks good and is ready to run

check não se conecta ao servidor.

4. Executar o teste

npx mcprigor test calculator.mcpr

Um resultado aprovado tem a seguinte aparência:

MCP Rigor — Calculator acceptance tests
✓ Adding 20 and 22 gives 42

1 passed, 0 failed, 0 skipped, 0 blocked

5. Criar um relatório compartilhável

npx mcprigor test calculator.mcpr --html report.html

Abra o report.html ou anexe-o a um ticket.

6. Experimentar o workspace do navegador

npx mcprigor workspace .

Abra a URL local exibida. Selecione calculator.mcpr — o editor oferece realce de sintaxe e autocompletar — e então escolha Validar e ▶ Executar testes. Você também pode criar novos arquivos de teste, executar várias suítes de uma vez com as caixas de seleção e revisar o histórico de execuções e tendências no painel de resultados. Consulte o guia do workspace de QA.

Se você não souber os nomes das ferramentas

Crie um pequeno arquivo de destino, como server.mcpr:

MCP Test 1
Suite: "Server target"
Server: node ../calculator-server/dist/server.js
Test: "Connection"
  Send "ping"

Inicie a criação guiada:

npx mcprigor author server.mcpr --out calculator.mcpr

O MCP Rigor descobre ferramentas, recursos e prompts e pergunta o que você deseja verificar.

Layout de projeto recomendado

mcp-acceptance-tests/
  package.json
  tests/
    smoke.mcpr
    regression.mcpr
    data/
      customers.csv
  .mcprigor/
    # generated evidence; normally ignored or stored as CI artifacts

Próximos passos