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.comEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Rigor MCP ?

  • Valider les fichiers de test — Demandez de vérifier la syntaxe et la structure d'un fichier .mcpr avec check avant de l'exécuter contre un serveur.

  • Exécuter les tests d'acceptation — Exécutez une suite de tests contre un serveur MCP local ou Streamable HTTP en utilisant test, avec des compteurs de réussite/échec dans la sortie.

  • Générer des rapports HTML — Créez un artefact report.html partageable à partir des exécutions de tests pour le joindre aux tickets ou aux journaux CI.

  • Rédiger des tests de manière interactive — Utilisez author pour découvrir les outils, ressources et invites d'un serveur MCP, puis générez un fichier de test guidé par vos objectifs de vérification.

  • Utiliser l'espace de travail du navigateur — Lancez workspace pour modifier, valider et exécuter plusieurs suites avec coloration syntaxique, autocomplétion 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. Voir 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