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 ansehen

Was kann man mit Rigor MCP machen?

  • Testdateien validieren — npx mcprigor check auf einer .mcpr-Datei ausführen, um Syntax und Bereitschaft zu prüfen, ohne eine Verbindung zu einem Server herzustellen.
  • Akzeptanztests ausführen — npx mcprigor test gegen eine .mcpr-Datei ausführen, um MCP-Tools aufzurufen und strukturierte Ergebnisse wie structuredContent.sum zu überprüfen.
  • HTML-Berichte generieren — Einen teilbaren Testbericht für Tickets oder CI-Artefakte anfordern.
  • Tools durch geführtes Authoring entdecken — npx mcprigor author verwenden, um Tools, Ressourcen und Prompts automatisch zu erkennen und dann interaktiv eine Testdatei zu generieren.
  • QA-Arbeitsbereich starten — npx mcprigor workspace . starten, um mehrere Testsuiten mit Syntaxhervorhebung 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 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 entdeckt 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

Nächste Schritte