MCP Rigor

offiziell

MCP-Server, der KI-Codierungsagenten eine deterministische Testschleife für die von ihnen gebauten MCP-Server bietet: Akzeptanztests in natürlicher Sprache schreiben, die Formulierung validieren, ausführen und strukturierte Bestehen/Nichtbestehen-Ergebnisse lesen – keine KI interpretiert die Tests zur Laufzeit. Ausführen mit: npx mcprigor serve <project>. Außerdem ein vollständiges CLI/CI-Testframework mit Vertragsabweichungserkennung und Transportparität. Apache-2.0.

Auf mcprigor.com ansehenDieses MCP ausprobierenGesponsert

Was kann man mit Rigor MCP machen?

Validierung von Testdateien — Fordern Sie an, die Syntax und Struktur einer .mcpr-Datei mit check zu überprüfen, bevor Sie sie gegen einen Server ausführen.
Ausführen von Akzeptanztests — Führen Sie eine Testsuite gegen einen lokalen oder Streamable-HTTP-MCP-Server mit test aus, wobei die Ausgabe Bestehens-/Fehleranzahlen enthält.
Generieren von HTML-Berichten — Erstellen Sie ein teilbares report.html-Artefakt aus Testläufen, um es an Tickets oder CI-Protokolle anzuhängen.
Interaktives Erstellen von Tests — Verwenden Sie author, um die Tools, Ressourcen und Prompts eines MCP-Servers zu entdecken und dann eine Testdatei zu generieren, die von Ihren Verifizierungszielen geleitet wird.
Den Browser-Arbeitsbereich nutzen — Starten Sie workspace, um mehrere Suiten mit Syntaxhervorhebung, Autovervollständigung und Ausführungsverlauf zu bearbeiten, zu validieren und auszuführen.

Dokumentation

Dieser Leitfaden führt Sie von der Installation bis zu einem erfolgreichen MCP-Test.

1. MCP Rigor installieren

Sie benötigen Node.js 20 oder 22. MCP Rigor ist auf npm als mcprigor veröffentlicht — das Paket enthält sofort ausführbaren kompilierten Code, sodass nichts aus dem Quellcode erstellt werden muss.

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

So überprüfen Sie die Installation:

npx mcprigor --help

2. Eine Testdatei erstellen

Erstellen Sie 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

Ändern Sie den Server-Befehl in den Befehl, der Ihren MCP-Server startet.

Für einen bereitgestellten Streamable-HTTP-Server verwenden Sie:

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

3. Die Formulierung überprüfen

npx mcprigor check calculator.mcpr

Eine gültige Datei gibt Folgendes aus:

✓ calculator.mcpr looks good and is ready to run

check stellt keine Verbindung zum Server her.

4. Den Test ausführen

npx mcprigor test calculator.mcpr

Ein erfolgreiches Ergebnis sieht wie folgt aus:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Einen teilbaren Bericht erstellen

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

Öffnen Sie report.html oder hängen Sie ihn an ein Ticket an.

6. Den Browser-Arbeitsbereich ausprobieren

npx mcprigor workspace .

Öffnen Sie die gedruckte lokale URL. Wählen Sie calculator.mcpr — der Editor bietet Syntaxhervorhebung und Autovervollständigung — und wählen Sie dann Validieren und ▶ Tests ausführen. Sie können auch neue Testdateien erstellen, mehrere Suiten gleichzeitig mit den Kontrollkästchen ausführen und den Verlauf und Trends der Ergebnisse im Ergebnisbereich überprüfen. Siehe den QA-Arbeitsbereich-Leitfaden.

Wenn Sie Toolnamen nicht kennen

Erstellen Sie eine kleine Zieldatei wie server.mcpr:

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

Starten Sie die geführte Erstellung:

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

MCP Rigor erkennt Tools, Ressourcen und Prompts und fragt, was Sie überprüfen möchten.

Empfohlenes Projektlayout

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