Serveur MCP Rigor
Commit 13 nov. 2026Permet aux équipes QA d'effectuer des tests déterministes en langage naturel sur les outils, ressources, prompts et contrats MCP sans avoir à écrire de code de test.
Aussi connu sous FusionOnePlatform/mcprigor
- Étoiles
- 3
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 13 nov. 2026
- Licence
- Apache-2.0
Qu'est-ce que Rigor MCP ?
Permet aux équipes QA d'effectuer des tests déterministes en langage naturel sur les outils, ressources, prompts et contrats MCP sans avoir à écrire de code de test.
Résumé généré à partir du README du projet
À propos du MCP server Rigor
Les équipes QA peuvent effectuer des tests déterministes en langage naturel sur les outils, ressources, prompts et contrats MCP sans écrire de code de test traditionnel. En utilisant une syntaxe spécialisée, les testeurs peuvent définir des attentes pour les appels d'outils, la lecture de ressources et les sorties de prompts. Cette approche garantit que les tests restent prévisibles car aucun modèle d'IA n'est utilisé pour interpréter l'énoncé du test.
Les utilisateurs peuvent exécuter des tests contre des serveurs locaux via stdio, des serveurs Python ou des serveurs HTTP distants en utilisant des variables d'environnement pour l'authentification. Le système prend en charge divers workflows, notamment un espace de travail QA local basé sur le navigateur, une interface en ligne de commande pour l'intégration CI, et un mode auteur interactif pour générer des tests à partir de serveurs en direct. Il propose également une commande parity pour comparer le comportement entre les environnements locaux et déployés.
Les développeurs peuvent gérer des besoins de test complexes grâce à des scénarios pilotés par les données utilisant des adaptateurs CSV, JSON ou SQL. L'outil inclut des fonctionnalités avancées telles que des audits de sécurité, un budget de performance avec des limites de centiles, et des vérifications de composition pour les flottes multi-serveurs. Il s'intègre aux workflows de développement via une extension VS Code et fournit des rapports HTML détaillés avec des chronologies de preuves interactives.
Ce que vous pouvez faire avec
- 1Vérifier la précision de la sortie des outilsUn développeur peut ordonner au système d'appeler un outil spécifique avec des arguments définis et de vérifier si le contenu structuré renvoyé correspond à une valeur attendue.
- 2Comparer les environnements locaux et distantsLes équipes peuvent exécuter les mêmes scénarios de test sur un serveur de développement local et sur un serveur QA déployé afin d'identifier les différences sémantiques.
- 3Automatiser les tests avec des données externesLes testeurs peuvent exécuter le même appel d'outil sur plusieurs lignes de données importées depuis des fichiers comme Excel ou des bases de données SQL.
- 4Générer des tests à partir de serveurs en directAu lieu d'écrire des fichiers manuellement, les utilisateurs peuvent utiliser un processus guidé pour découvrir les opérations et créer automatiquement des fichiers de test révisables.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
MCP_TOKEN
| Nom | Description | Type |
|---|---|---|
| MCP_TOKEN | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblefusiononeplatform/mcprigor is public and reachablegithub.com/fusiononeplatform/mcprigor ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/fusiononeplatform/mcprigor ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubMCP Rigor
Natural-language testing for Model Context Protocol servers.
Visual QA workspace · English ⇄ YAML parity · interactive evidence timeline · CLI, CI, and shareable reports — watch the MP4
MCP Rigor lets QA teams test MCP tools, resources, prompts, contracts, and transports without writing test code. Tests are deterministic: no AI model interprets the wording.
Status:
1.5.0stable. Node.js 20 or 22 is required.
Install
MCP Rigor is published on npm as mcprigor. The package ships compiled code, ready to run:
npm install mcprigor
Or try it instantly without installing:
npx mcprigor@latest init tests/acceptance.mcpr
Use npx mcprigor in commands below, or install globally (npm install -g mcprigor) to use mcprigor directly. In a project where tests run only during development or CI, npm install --save-dev mcprigor keeps it out of production dependencies.
Install from source
Only needed if you want to modify MCP Rigor itself:
git clone https://github.com/FusionOnePlatform/mcprigor.git
cd mcprigor
npm ci
npm run check # build + full test suite
npm link # optional: use your local build as the global `mcprigor`
Write your first test
Create calculator.mcpr:
MCP Test 1
Suite: "Calculator acceptance tests"
Server: node dist/server.js
Test: "Adding 20 and 22 gives 42"
Call tool "add" with:
a: 20
b: 22
Expect "structuredContent.sum" equals 42
Check the wording, then run it:
npx mcprigor check calculator.mcpr
npx mcprigor test calculator.mcpr
Create a browser report:
npx mcprigor test calculator.mcpr --html report.html
Expected summary:
✓ Adding 20 and 22 gives 42
1 passed, 0 failed, 0 skipped, 0 blocked
Use the QA workspace
Start the local browser interface:
npx mcprigor workspace .
Or expose MCP Rigor to AI coding agents as an MCP server (docs):
npx mcprigor serve .
Open the printed http://127.0.0.1:... URL. You can select a suite, edit it, validate the wording, run tests, run transport parity, and review results.
The workspace is loopback-only and does not accept arbitrary commands from the browser.
Connect to an MCP server
Local stdio server:
Server: node dist/server.js
Python server:
Server: python -m my_mcp_server
Streamable HTTP server:
MCP URL: https://qa.example.com/mcp
Server options:
headers:
Authorization: "Bearer ${env.MCP_TOKEN}"
Run with an environment variable:
MCP_TOKEN="your-token" npx mcprigor test customer.mcpr
Do not place reusable credentials directly in test files.
Common test actions
Call tool "search" with:
query: "red shoes"
Read resource "catalog://status"
Get prompt "write_summary" with:
topic: "Release quality"
Expect it succeeds
Expect an error
Expect "structuredContent.total" equals 2
Expect "content[0].text" contains "complete"
Expect "items" has 3 items
See the natural-language cookbook for copy-ready examples.
Compare local and deployed behavior
MCP Test 1
Suite: "Calculator parity"
Compare target "Local": node dist/server.js
Compare target "QA": https://qa.example.com/mcp
Test: "Addition is consistent"
Call tool "add" with:
a: 20
b: 22
Expect "structuredContent.sum" equals 42
npx mcprigor parity calculator-parity.mcpr
MCP Rigor runs every scenario against both targets and reports semantic differences.
Create a test from a live server
Provide a small .mcpr file containing the target, then run:
npx mcprigor author server.mcpr --out search-customer.mcpr
The guided author discovers operations, asks for inputs, previews a response, and writes a reviewable natural-language test.
Use data-driven tests
Test: "Calculator examples"
For each row:
| caseId | a | b | expected |
| basic | 2 | 3 | 5 |
| larger | 20 | 22 | 42 |
Call tool "add" with:
a: "${row.a}"
b: "${row.b}"
Expect "structuredContent.sum" equals "${row.expected}"
CSV, JSON, YAML, Excel, REST, Google Sheets, SQL adapters, typed columns, filters, joins, and deterministic sampling are also supported.
Use in CI
- uses: actions/setup-node@v4
with:
node-version: 20
- run: npm ci
- run: npx mcprigor check tests/acceptance.mcpr
- run: npx mcprigor test tests/acceptance.mcpr --junit reports/mcp.xml --evidence .mcprigor/ci-run
Exit codes:
| Code | Meaning |
|---|---|
0 |
Tests passed |
1 |
A test or comparison failed |
2 |
Usage, language, or configuration problem |
3 |
Server, transport, or internal failure |
Main commands
mcprigor workspace [DIRECTORY] Start the local QA interface
mcprigor init FILE Create an example test
mcprigor check FILE Validate without connecting
mcprigor test FILE Run natural-language or YAML tests
mcprigor author TARGET --out FILE Build a test interactively
mcprigor parity FILE Compare named targets
mcprigor audit FILE Run deterministic security probes
mcprigor composition-check FILE Check a mounted server fleet
mcprigor composition-discover FILE Save a combined fleet contract
mcprigor composition-drift FILE Gate fleet contract drift
mcprigor discover FILE Save the live MCP contract
mcprigor contract-check LOCK --target FILE
mcprigor evidence-show DIRECTORY
Performance and governance features new in 1.5.0:
Expect the call to finish within 800ms, percentile budgets, and--fail-on-regressionmcprigor auditdeterministic security probes with scored PDF/CSV/JSON reports- Multi-server test routing, collision checks, combined fleet locks, and composition drift
- GitHub Action with rich PR reports
- Live MCP surface and schema coverage with
--fail-under - Scheduled HTTP monitoring with failure/recovery webhooks
- Clickable HAR-style session timeline in HTML reports
- Contract drift markdown as a downloadable Action artifact
mcprigor publish— shareable static report URLs
See the complete CLI reference.
Editor support
The VS Code extension in editors/vscode adds syntax highlighting and inline mcprigor check diagnostics for .mcpr files. Package it with npx @vscode/vsce package from that directory, or install a release .vsix with code --install-extension.
Choose your next guide
- New QA user: Getting started
- Writing scenarios: Natural-language cookbook
- Using the browser UI: QA workspace
- Setting up targets and CI: Engineer setup
- Fixing failures: Troubleshooting
- All documentation: Documentation index
Scope and safety
MCP Rigor performs black-box behavior and contract testing. It complements MCP Inspector and official MCP Conformance; it does not provide certification.
Remote data and custom extensions are disabled unless explicitly enabled. Reports and evidence are sanitized, but business response data may still be sensitive. Review security and retention before storing CI artifacts.
Contributing
See CONTRIBUTING.md, then run:
npm ci
npm run check
Apache-2.0 licensed.
Questions sur Rigor MCP
Puis-je utiliser MCP Rigor pour comparer différents environnements de serveur ?
Oui, la commande parity vous permet de comparer une cible locale à une cible QA afin de signaler les différences sémantiques.
Pret-il en charge les tests pilotés par les données ?
Oui, il prend en charge les tests pilotés par les données via divers adaptateurs, notamment CSV, JSON, YAML, Excel, REST, Google Sheets et SQL.
