MCP Rigor

oficial

Servidor MCP que brinda a los agentes de codificación de IA un bucle de pruebas determinista para los servidores MCP que construyen: escriba pruebas de aceptación en lenguaje natural, valide la redacción, ejecútelas y lea resultados estructurados de aprobado/fallido — sin que la IA interprete las pruebas en tiempo de ejecución. Ejecutar con: npx mcprigor serve <proyecto>. También un marco de pruebas completo de CLI/CI con detección de desviación de contratos y paridad de transporte. Apache-2.0.

Ver en mcprigor.com

¿Qué puedes hacer con Rigor MCP?

  • Validar archivos de prueba — Solicite ejecutar npx mcprigor check en un archivo .mcpr para verificar la sintaxis y la preparación sin conectarse a un servidor.
  • Ejecutar pruebas de aceptación — Ejecute npx mcprigor test contra un archivo .mcpr para llamar a las herramientas MCP y verificar resultados estructurados como structuredContent.sum.
  • Generar informes HTML — Solicite producir un informe de prueba compartible para tickets o artefactos de CI.
  • Descubrir herramientas mediante autoría guiada — Use npx mcprigor author para detectar automáticamente herramientas, recursos y avisos, y luego genere un archivo de prueba de forma interactiva.
  • Iniciar el espacio de trabajo de QA — Inicie npx mcprigor workspace . para editar, validar y ejecutar múltiples suites de prueba con resaltado de sintaxis e historial de ejecución.

Documentación

Esta guía te lleva desde la instalación hasta una prueba MCP que pasa correctamente.

1. Instalar MCP Rigor

Necesitas Node.js 20 o 22. MCP Rigor se publica en npm como mcprigor — el paquete incluye código compilado listo para ejecutar, por lo que no hay nada que compilar desde el código fuente.

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

Para verificar la instalación:

npx mcprigor --help

2. Crear un archivo de prueba

Crea 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

Cambia el comando Server al comando que inicia tu servidor MCP.

Para un servidor Streamable HTTP desplegado, usa:

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

3. Verificar el texto

npx mcprigor check calculator.mcpr

Un archivo válido imprime:

✓ calculator.mcpr looks good and is ready to run

check no se conecta al servidor.

4. Ejecutar la prueba

npx mcprigor test calculator.mcpr

Un resultado exitoso se ve así:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Crear un informe compartible

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

Abre report.html o adjúntalo a un ticket.

6. Probar el espacio de trabajo del navegador

npx mcprigor workspace .

Abre la URL local impresa. Selecciona calculator.mcpr — el editor te ofrece resaltado de sintaxis y autocompletado — luego elige Validar y ▶ Ejecutar pruebas. También puedes crear nuevos archivos de prueba, ejecutar varios conjuntos a la vez con las casillas de verificación y revisar el historial de ejecuciones y tendencias en el panel de resultados. Consulta la guía del espacio de trabajo de QA.

Si no conoces los nombres de las herramientas

Crea un archivo de destino pequeño como server.mcpr:

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

Inicia la creación guiada:

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

MCP Rigor descubre herramientas, recursos y prompts, y te pregunta qué deseas verificar.

Diseño de proyecto 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 pasos