MCP Rigor

officiel

Serveur MCP qui offre aux agents de codage IA une boucle de test déterministe pour les serveurs MCP qu'ils construisent : rédigez des tests d'acceptation en langage naturel, validez le libellé, exécutez-les et lisez des résultats structurés réussite/échec — aucune IA n'interprète les tests à l'exécution. Lancez avec : npx mcprigor serve <project>. Également un framework de test complet en CLI/CI avec détection de dérive de contrat et parité de transport. Apache-2.0.

Voir sur mcprigor.com

Que pouvez-vous faire avec Rigor MCP ?

  • Valider les fichiers de test — Demandez à exécuter npx mcprigor check sur un fichier .mcpr pour vérifier la syntaxe et la préparation sans se connecter à un serveur.
  • Exécuter les tests d’acceptation — Lancez npx mcprigor test sur un fichier .mcpr pour appeler les outils MCP et vérifier les résultats structurés comme structuredContent.sum.
  • Générer des rapports HTML — Demandez à produire un rapport de test partageable pour les tickets ou les artefacts CI.
  • Découvrir les outils via l’écriture guidée — Utilisez npx mcprigor author pour détecter automatiquement les outils, ressources et invites, puis générez un fichier de test de manière interactive.
  • Lancer l’espace de travail QA — Démarrez npx mcprigor workspace . pour modifier, valider et exécuter plusieurs suites de tests avec coloration syntaxique et historique d’exécution.

Documentation

Ce guide vous mène de l’installation à un test MCP réussi.

1. Installer MCP Rigor

Vous avez besoin de Node.js 20 ou 22. MCP Rigor est publié sur npm sous mcprigor — le paquet inclut du code compilé prêt à l’emploi, donc rien à construire depuis la source.

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

Pour vérifier l’installation :

npx mcprigor --help

2. Créer un fichier de test

Créez 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

Remplacez la commande Server par la commande qui démarre votre serveur MCP.

Pour un serveur Streamable HTTP déployé, utilisez :

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

3. Vérifier le libellé

npx mcprigor check calculator.mcpr

Un fichier valide affiche :

✓ calculator.mcpr looks good and is ready to run

check ne se connecte pas au serveur.

4. Exécuter le test

npx mcprigor test calculator.mcpr

Un résultat réussi ressemble à :

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Créer un rapport partageable

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

Ouvrez report.html ou joignez-le à un ticket.

6. Essayer l’espace de travail navigateur

npx mcprigor workspace .

Ouvrez l’URL locale affichée. Sélectionnez calculator.mcpr — l’éditeur offre la coloration syntaxique et l’autocomplétion — puis choisissez Valider et ▶ Exécuter les tests. Vous pouvez aussi créer de nouveaux fichiers de test, exécuter plusieurs suites à la fois avec les cases à cocher, et consulter l’historique des exécutions et les tendances dans le panneau des résultats. Consultez le guide de l’espace de travail QA.

Si vous ne connaissez pas les noms des outils

Créez un petit fichier cible tel que server.mcpr :

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

Démarrez la création guidée :

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

MCP Rigor découvre les outils, ressources et invites, puis vous demande ce que vous souhaitez vérifier.

Structure de projet recommandée

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

Prochaines étapes