suspec-mcp

Ein schlanker MCP-stdio-Adapter für den shell-losen Zugriff auf Suspecs deterministischen Prüfer. Schlank ist das Feature. Er erfordert den Prüfvertrag 0.26.0, validiert jede CLI-JSON-Nutzlast und bewahrt geordnete Berichte und den Exit-Status.

Werkzeuge

suspec_check

Führt einen CLI-Prozess über ein geordnetes, nicht leeres Array absoluter Artefaktpfade aus. Frontmatter type: wählt das Verhalten.

Spezifikations-, Aufgaben-, Änderungsplan- und Kampagneneingaben erhalten ihre CLI-Prüfungen. Inventar, Audit, Forschung und Panel geben checked: false zurück. Fehlende und unbekannte Typen werden abgelehnt.

Ein Aufruf bewahrt dateiübergreifende Prüfungen wie C002. Aufgabenpfade teilen sich eine specPath; jede Aufgabe muss diese Spezifikation benennen. Ungültige Begleitpaarungen erzeugen die strukturierte Ablehnung der CLI mit ok: false.

Jedes Artefaktergebnis wiederholt seinen Typ. Nur der optionale abschließende (Dateisatz)-Bericht hat keinen.

suspec_get_checks

Gibt die Vertragsversion sowie die ID und den Schweregrad jeder Kernprüfung im kompakten Modus zurück. Verwenden Sie responseFormat: "detailed" für Namen. Derselbe Vertrag ist unter suspec://checks verfügbar.

Start- und Ressourcenlesevorgänge erfordern den exakten Vertrag 0.26.0 bei Exit 0. Ein Ressourcenfehler wirft eine Ausnahme, anstatt ein Fehlerdokument als Ressourceninhalt zurückzugeben.

Related MCP server: governed-mcp

Umschlag

Jeder erfolgreiche Adapteraufruf gibt zurück:

• ok: ob die CLI ausgeführt wurde und eine gültige Nutzlast erzeugt hat, nicht ob die Diagnosen sauber sind;

• source: exakter Befehl und Exit-Code;

• data: validierte detaillierte Ausgabe oder kompakte Projektion;

• optional note;

• responseFormat.

ok bedeutet, dass der Adapter funktioniert hat, nicht dass das Artefakt gut ist. Eine Prüfung mit blockierenden Diagnosen bleibt ok: true; prüfen Sie data.level, Diagnosen und source.exitCode.

CLI-Exits 0, 1 und 2 gehören zum Vertrag. Jeder andere Exit ist ein Adapterstartfehler. JSON-förmige Standardausgabe verhandelt keinen neuen Vertrag. Strukturierte CLI-Fehler werden nur bei Exit 2 akzeptiert.

Installation

Erfordert Node.js 22.6 oder neuer und eine suspec CLI. Keines der Pakete ist veröffentlicht.

git clone https://github.com/jcosta33/suspec-mcp
cd suspec-mcp
corepack enable
pnpm install --frozen-lockfile

Konfigurieren Sie absolute Einstiegspunkte, damit GUI-Clients nicht von der Shell PATH abhängen:

{
  "mcpServers": {
    "suspec": {
      "command": "/absolute/path/to/suspec-mcp/bin/suspec-mcp.js",
      "args": ["--suspec-bin", "/absolute/path/to/suspec-cli/bin/suspec.js"]
    }
  }
}

CLI-Priorität:

Jeder Werkzeugaufruf liefert vollständige Artefaktpfade. Der Server bindet kein Repository, keinen Arbeitsbereich, keine Konfiguration und keinen Speicher. Er ist ein Adapter, kein zweites Produktgehirn. ~/.agents/artifacts/<workspace>/ hat keine besondere Laufzeitbedeutung. Die Installation von Richtlinien auf Benutzerebene ist Aufgabe der CLI: führen Sie suspec setup direkt aus. MCP bietet keine Oberfläche für Setup, Speicherung, Promotion, Lebenszyklus oder Orchestrierung.

Sicherheit

• Primär- und Begleitpfade müssen absolut sein und keine Steuer-, Format- oder Zeilentrennzeichen enthalten.

• Der Adapter übergibt ein festes Argumentarray ohne Shell.

• Nur check und unterstützte Begleit- oder Vertragsflags erreichen die CLI. setup wird abgelehnt, bevor ein Unterprozess startet.

• Die CLI-Prüfoberfläche ist schreibgeschützt.

Der Server kann jeden Pfad lesen, der seinem Prozess zur Verfügung steht. Dateisystemberechtigung ist die Sicherheitsgrenze, kein Vorschlag. Passen Sie die Prozessberechtigungen an die Vertrauensgrenze des Clients an oder wenden Sie OS-Sandboxing an.

Entwicklung

Fixture-Drift verwendet die echte CLI. Handgeschriebene Übereinstimmung beweist nichts. Setzen Sie SUSPEC_BIN auf einen absoluten CLI-Quellpfad; andernfalls kann ein Geschwisterpaket namens suspec-cli die Erkennung erfüllen. Die Generierung lehnt andere Pakete ab.

export SUSPEC_BIN=/absolute/path/to/suspec-cli/bin/suspec.js
pnpm install
pnpm test:run
pnpm gate
pnpm fixtures

test/fixtures/provenance.json zeichnet den CLI-git-HEAD, den vollständigen Dirty-Worktree-Hash und den Binär-Hash auf. scripts/generate-fixtures.mjs erfasst die Ausgabe; Tests parsen jedes Fixture durch src/suspec/contract.ts. Fixtures werden generiert, nie von Hand bearbeitet.

Lizenz

MIT