shipcheck-mcp

Finde heraus, was deine KI-gebaute App leakt – bevor du auslieferst.

Funktioniert mit Claude Code, OpenCode, Cursor oder jedem MCP-kompatiblen Agenten – es ist ein Standard-Model Context Protocol-Server, kein reines Claude-Tool.

KI-Codierungsagenten bringen bereitwillig Apps heraus, die API-Schlüssel leaken, GPL-lizenzierte Pakete einbinden, Admin-Routen offen im Internet lassen, E-Mails ohne Datenschutzerklärung sammeln oder Rohkartennummern verarbeiten – weil „Läuft es?" und „Kann man das veröffentlichen?" unterschiedliche Fragen sind und dein Agent nur die erste beantwortet.

ShipCheck beantwortet die zweite Frage. Es führt fünf schnelle, deterministische Prüfungen über dein Projekt durch und erklärt jeden Befund in einfachen Worten – was falsch ist, warum es für dich wichtig ist und wie du es genau beheben kannst. Kein Sicherheits-Hintergrund nötig.

Ehrlich von Natur aus: ShipCheck kennzeichnet riskante Muster. Es ist keine rechtliche Prüfung und keine Garantie. Ein sauberer Scan bedeutet, dass nichts diesen spezifischen Prüfungen entspricht – mehr nicht. Siehe PRD.md §2 für die vollständigen Nicht-Ziele.

Zwei Werkzeuge, zwei Zeitpunkte

Das gebündelte Skill bringt deinem Agenten die Gewohnheit bei: scan_diff vor Commits, scan_repo vor dem Launch.

Related MCP server: agentguard

Funktioniert mit deinem Stack

Jede Zusammenfassung verrät dir, welche Stacks erkannt wurden (project_types) und warnt dich ehrlich, wenn ein erkannter Stack nicht vollständig abgedeckt ist (coverage_caveat), anstatt anzudeuten, dass alles in Ordnung ist.

Wie ein Befund aussieht

[kritisch] lib/firebase_options.dart — Möglicher Google-API-Schlüssel in Code gefunden, der auf den Geräten von Menschen läuft.

Warum das wichtig ist: Dieser Schlüssel reist in deiner App zu jedem Telefon oder Browser des Nutzers. Jeder kann ihn kopieren und verwenden, als wäre er du – dein Geld ausgeben oder deine Daten lesen.

Die Lösung: Verschiebe den Schlüssel in eine separate Secret-Datei, die niemals Teil des Projekts wird, lade ihn beim Start und hole dann einen neuen Schlüssel vom Dashboard des Anbieters – behandle diesen als gestohlen.

30-Sekunden-Start

# In Claude Code:
/plugin marketplace add noureldeensalama/shipcheck
/plugin install shipcheck

# Then just talk to your agent:

„Führe ShipCheck aus, bevor ich committe" · „Ist das bereit für den Launch?" · „Scanne dieses Repo"

Headless / CI:

claude --plugin-dir /path/to/shipcheck -p "Run shipcheck scan_repo on . and summarize findings"

Eigenständiger MCP-Server (Cursor, OpenCode, alles andere)

git clone https://github.com/noureldeensalama/shipcheck.git
cd shipcheck && npm install && npm run build

{
  "mcpServers": {
    "shipcheck": { "command": "node", "args": ["/absolute/path/to/shipcheck/dist/index.js"] }
  }
}

Oder nach der Veröffentlichung: npx shipcheck-mcp

Gebaut, um vertrauenswürdig zu sein

• Deterministisch: nur Regex + Abhängigkeits-Metadaten. Ein LLM erklärt Befunde nachgelagert; es entscheidet nie, ob ein Befund existiert (PRD.md §4).

• Leise von Design: identische Schlüssel werden zu einem Befund mit allen Standorten dedupliziert; die Ausgabe ist nach Schweregrad sortiert, kompakt (~1k Tokens bei einem 100k-LOC-Repo), auf 100 Befunde begrenzt mit einem expliziten Abschneide-Flag; vendorierte Bäume (node_modules, .venv, build…) werden nie gescannt; Platzhalterwerte (mock…, CI-Dummies) und öffentlich-by-Design- Konfigurationen (google-services.json, firebase_options.dart) schlagen nicht unnötig Alarm.

• Erprobt auf echtem Code: In fünf Produktions-Repos eingesetzt – es hat einen lebenden Supabase-Service-Role-Schlüssel in 13 Dateien und drei unauthentifizierte Debug-Endpunkte gefunden, dann verifiziert, dass die Fixes umgesetzt wurden, und einen zweiten Schlüssel markiert, der nur in der Git-Historie überlebt hat. Vollständiges Positiv-/Fehlalarm-Protokoll: DOGFOOD_RESULTS.md.

Kompatibilität

Selbst testen

npm test             # 53 unit tests
npm run e2e          # 21 real-MCP-protocol checks
npm run verify-fixture   # acceptance gate over deliberately-vulnerable fixtures
npm run dogfood -- /path/to/any/repo   # scan any repo from the CLI

Mitwirken

Issues und PRs sind willkommen – siehe CONTRIBUTING.md. Neue Detektor-Kategorien benötigen sowohl eine „Fires-on-Risk"-Fixture als auch einen „Doesn't-over-Fire"-Regressionstest; Fehlalarm-Meldungen mit echten Codebeispielen sind besonders wertvoll. Ergebnisse aus echten Repos findest du in DOGFOOD_RESULTS.md.

Lizenz

MIT – siehe LICENSE.