Doku · MCP
vetkit-MCP-Server
Geben Sie Ihrem Coding-Agenten einen Code-Auditor. Mit dem vetkit-MCP-Server können alle Clients für das Model Context Protocol mit stdio-Unterstützung Repositorys verbinden, Audits ausführen sowie Befunde und Berichte lesen.
MCP ist ein offener Standard, keine reine Claude-Integration. Konfigurieren Sie mit der Definition unten einen lokalen stdio-Server namens vetkit und folgen Sie der Anleitung Ihres Clients. Das äußere Konfigurationsformat variiert. Clients, die nur entfernte HTTP/SSE-Server akzeptieren, können sich nicht direkt verbinden; vetkit bietet keinen entfernten MCP-Endpunkt.
{ "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" }}Bitten Sie Ihren Agenten dann zum Beispiel: „Prüfe acme/payments-api und sag mir, was ich zuerst beheben sollte.“ Laden Sie Ihren Client neu und prüfen Sie, ob vetkit_list_repos in der Werkzeugliste erscheint.
Voraussetzungen
- Node.js 20.3 oder neuer, mit
npxin IhremPATH. - Ein vetkit-Konto und Zugriff auf die GitHub-, Bitbucket-Cloud- oder GitLab.com-Repositorys, die Sie prüfen möchten.
- Ein vetkit-API-Schlüssel (nächster Schritt).
API-Schlüssel erstellen
- Öffnen Sie in der vetkit-App Arbeitsbereich-Einstellungen → API-Schlüssel. Nur Inhaber und Admins einer Organisation können Schlüssel verwalten.
- Benennen Sie den Schlüssel nach dem Ort, an dem er eingesetzt wird, zum Beispiel „MCP — Laptop“.
- Um Repository-Audits auszuführen, wählen Sie
repos:read,audits:readundaudits:run(oderaudits:write). Ergänzen Sierepos:writezum Verbinden von Repositories,findings:readzum Lesen von Befunden undreports:readzum Lesen von Berichten. Zum Starten oder Abbrechen von KI-Evaluierungen istaudits:writeerforderlich. Für einen Agenten mit reinem Lesezugriff wählen Sie nur Lese-Scopes. - Legen Sie optional ein Ablaufdatum und ein Rate-Limit pro Minute fest (Standard 60, bis zu 600).
- Kopieren Sie das Secret. Es hat die Form
vk_live_…und wird nur einmal angezeigt; vetkit speichert ausschließlich einen Hash.
Rotation und Widerruf
401 API_KEY_REVOKED.Installation
Cursor
Fügen Sie den folgenden vetkit-Eintrag in ~/.cursor/mcp.json (global) oder in .cursor/mcp.json in einem Projekt ein. Committen Sie keine Projektkonfiguration, die Ihren Schlüssel enthält.
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}VS Code / GitHub Copilot
Ergänzen Sie diesen Eintrag in .vscode/mcp.json und behalten Sie vorhandene Server bei. VS Code / GitHub Copilot verwendet servers statt mcpServers. Starten und genehmigen Sie vetkit in der MCP-Serverliste. Ersetzen Sie den Schlüssel-Platzhalter und committen Sie niemals eine Konfiguration mit Ihrem Secret.
{ "servers": { "vetkit": { "type": "stdio", "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Codex
Ergänzen Sie diese TOML-Abschnitte in ~/.codex/config.toml, ohne vorhandene Einstellungen zu ersetzen. Codex CLI und die IDE-Erweiterung teilen diese Konfiguration. Ersetzen Sie den Schlüssel-Platzhalter, starten Sie den Client neu und prüfen Sie mit codex mcp list. Halten Sie die Datei geheim.
[mcp_servers.vetkit]command = "npx"args = ["-y", "@vetkit/mcp"] [mcp_servers.vetkit.env]VETKIT_API_KEY = "<your-api-key>"Claude Code
claude mcp add --transport stdio vetkit -e 'VETKIT_API_KEY=<your-api-key>' -- npx -y @vetkit/mcpFügen Sie --scope user hinzu, damit vetkit in jedem Projekt verfügbar ist statt nur im aktuellen.
Claude Desktop
Öffnen Sie Settings → Developer → Edit Config, fügen Sie vetkit zu claude_desktop_config.json hinzu und starten Sie Claude Desktop anschließend neu:
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Andere MCP-Clients
Jeder Client, der einen stdio-Server starten kann, funktioniert: Führen Sie npx -y @vetkit/mcp mit VETKIT_API_KEY in der Umgebung aus. Sie können das Paket auch global installieren und das Binary vetkit-mcp direkt ausführen.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpKonfiguration
Der Server wird vollständig über Umgebungsvariablen konfiguriert.
| Variable | Erforderlich | Beschreibung |
|---|---|---|
VETKIT_API_KEY | Ja | Ihr API-Schlüssel, vk_live_… oder vk_test_…. |
VETKIT_API_URL | Nein | Basis-URL der API. Standard: https://api.vetkit.dev. Muss HTTPS verwenden; unverschlüsseltes HTTP wird nur für localhost akzeptiert. |
VETKIT_ORG_ID | Nein | Organisations-ID. Jeder API-Schlüssel gehört zu genau einer Organisation, die standardmäßig verwendet wird; Sie benötigen diese Variable daher selten. |
VETKIT_APP_URL | Nein | URL der Web-App, die für Links zu Audits verwendet wird. Standard: https://app.vetkit.dev. |
Tools
Jedes Tool liefert lesbaren Text, und alle Tools außer vetkit_get_report liefern zusätzlich typisierten strukturierten Inhalt. Die Tools tragen MCP-Annotationen, sodass Clients die nur lesenden automatisch freigeben können. Keines der Tools löscht etwas.
vetkit_list_repos
Listet die mit Ihrer Organisation verbundenen Repositorys auf, mit Note und Score des letzten Audits.nur lesendScopes: repos:read
limitnumber- Seitengröße, 1–100. Standard: 25.
cursorstring- Der nextCursor-Wert der vorherigen Seite.
| Argument | Typ | Beschreibung |
|---|---|---|
limit | number | Seitengröße, 1–100. Standard: 25. |
cursor | string | Der nextCursor-Wert der vorherigen Seite. |
{ "limit": 10 }vetkit_connect_repo
Verbindet ein Repository auf GitHub, Bitbucket Cloud oder GitLab.com. Ist die vetkit GitHub App beim Eigentümer noch nicht installiert, wird für GitHub das Ergebnis "installation_required" mit einer Installations-URL zurückgegeben. Private Bitbucket- und GitLab-Repositorys benötigen ein Zugriffstoken, das vetkit für spätere Audits speichert.schreibendScopes: repos:write
urlstringerforderlich- Repository-URL von GitHub, Bitbucket Cloud oder GitLab.com oder "owner/name" für GitHub.
accessTokenstring- Optionales Repository-Zugriffstoken; für private Bitbucket- oder GitLab-Repositorys erforderlich. Wird an vetkit gesendet und für spätere Audits gespeichert.
| Argument | Typ | Beschreibung |
|---|---|---|
urlerforderlich | string | Repository-URL von GitHub, Bitbucket Cloud oder GitLab.com oder "owner/name" für GitHub. |
accessToken | string | Optionales Repository-Zugriffstoken; für private Bitbucket- oder GitLab-Repositorys erforderlich. Wird an vetkit gesendet und für spätere Audits gespeichert. |
{ "url": "https://github.com/acme/payments-api" }vetkit_run_audit
Startet ein Audit und wartet standardmäßig auf dessen Abschluss, während Fortschrittsbenachrichtigungen gesendet werden. Verbindet das Repository bei Bedarf zuerst. Liefert die Gesamtnote, die Note jeder ausgeführten Suite, den Score und die Anzahl der Befunde. Dieses Tool akzeptiert keine Zugriffstoken. Verbinden Sie private Bitbucket- oder GitLab-Repositorys zuerst mit vetkit_connect_repo und accessToken.schreibendScopes: repos:read, audits:read, audits:run oder audits:write (+ repos:write für automatisches Verbinden)
repostringerforderlich- Repository-ID, "owner/name" für GitHub oder eine URL von GitHub, Bitbucket Cloud oder GitLab.com. GitHub-URLs können /tree/<branch> enthalten.
mode"QUICK" | "FULL"- „QUICK“ startet einen kostenlosen Quick Scan (10 pro Monat je Workspace-Inhaber: posture, gitleaks und osv auf dem neuesten Commit des Standard-Branches). „FULL“ startet einen vollständigen Scan für 1 Credit, der dem Workspace-Inhaber berechnet wird. Standard ist „QUICK“, oder „FULL“, wenn ref, suites oder analyzers angegeben sind.
refstring- Branch, Tag oder Commit-SHA. Standardmäßig die Ref aus der URL, sonst der Standard-Branch.
suitesstring[]- Wählen Sie aus "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Führt die verfügbaren, standardmäßig aktivierten Prüfungen der gewählten Suites aus; bei expliziter Auswahl von privacy oder git-history auch deren verfügbare optionale Prüfungen. Für eine genaue Auswahl verwenden Sie analyzers. Standard ist die Repository-Einstellung.
analyzersstring[]- Genau diese Prüfungen ausführen, per ID (siehe Prüfungen unten); hat Vorrang vor suites. Mindestens eine Prüfung außer ai-signal.
excludeAssetsboolean- Bilder, Videos, Audiodateien, 3D-Modelle, Schriftarten, Designdateien und PDFs nicht herunterladen. Standard: die Einstellung des Repositorys.
waitboolean- Auf einen Endstatus warten. Standard: true.
timeoutSecondsnumber- Maximale Wartezeit, 10–1800. Standard: 600. Das Audit läuft nach einem Timeout weiter.
| Argument | Typ | Beschreibung |
|---|---|---|
repoerforderlich | string | Repository-ID, "owner/name" für GitHub oder eine URL von GitHub, Bitbucket Cloud oder GitLab.com. GitHub-URLs können /tree/<branch> enthalten. |
mode | "QUICK" | "FULL" | „QUICK“ startet einen kostenlosen Quick Scan (10 pro Monat je Workspace-Inhaber: posture, gitleaks und osv auf dem neuesten Commit des Standard-Branches). „FULL“ startet einen vollständigen Scan für 1 Credit, der dem Workspace-Inhaber berechnet wird. Standard ist „QUICK“, oder „FULL“, wenn ref, suites oder analyzers angegeben sind. |
ref | string | Branch, Tag oder Commit-SHA. Standardmäßig die Ref aus der URL, sonst der Standard-Branch. |
suites | string[] | Wählen Sie aus "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Führt die verfügbaren, standardmäßig aktivierten Prüfungen der gewählten Suites aus; bei expliziter Auswahl von privacy oder git-history auch deren verfügbare optionale Prüfungen. Für eine genaue Auswahl verwenden Sie analyzers. Standard ist die Repository-Einstellung. |
analyzers | string[] | Genau diese Prüfungen ausführen, per ID (siehe Prüfungen unten); hat Vorrang vor suites. Mindestens eine Prüfung außer ai-signal. |
excludeAssets | boolean | Bilder, Videos, Audiodateien, 3D-Modelle, Schriftarten, Designdateien und PDFs nicht herunterladen. Standard: die Einstellung des Repositorys. |
wait | boolean | Auf einen Endstatus warten. Standard: true. |
timeoutSeconds | number | Maximale Wartezeit, 10–1800. Standard: 600. Das Audit läuft nach einem Timeout weiter. |
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }vetkit_list_checks
Listet alle Prüfungen nach Suite gruppiert auf, mit dem verwendeten Tool und dessen Version, der Verfügbarkeit auf dem Server und den standardmäßig ausgeführten Prüfungen.nur lesendScopes: audits:read
Keine Argumente.
| Argument | Typ | Beschreibung |
|---|---|---|
| Keine Argumente. | ||
{}vetkit_get_audit
Liefert für ein Audit Status, Gesamtnote und Noten je Suite, Score, Anzahl der Befunde und den Fortschritt je Prüfung — einschließlich Metriken wie Anteil duplizierten Codes, durchschnittliche Komplexität, Verhältnis von Testcode zu Quellcode und Bus-Faktor.nur lesendScopes: audits:read
auditIduuiderforderlich- Die von vetkit_run_audit zurückgegebene Audit-ID.
| Argument | Typ | Beschreibung |
|---|---|---|
auditIderforderlich | uuid | Die von vetkit_run_audit zurückgegebene Audit-ID. |
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }vetkit_list_findings
Listet die Befunde eines Audits auf, die schwerwiegendsten zuerst. Liefert eine kompakte Tabelle als Text und alle Details — Meldung, maskiertes Snippet, Behebung, Referenzen — als strukturierten Inhalt.nur lesendScopes: findings:read
auditIduuiderforderlich- Das zu lesende Audit.
severitystring[]- CRITICAL, HIGH, MEDIUM, LOW oder INFO.
suitestring- SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY oder GIT_HISTORY: nur Befunde dieser Suite.
categorystring[]- SECURITY, SECRETS, DEPENDENCIES, INFRASTRUCTURE, QUALITY, MAINTAINABILITY, DUPLICATION, TESTING, DOCUMENTATION, HYGIENE, LICENSES, DEPENDENCY_HEALTH, ACTIVITY, HALLUCINATION, UNFINISHED_CODE, VIBE_STACK, LLM_SECURITY, RESILIENCE, DATABASE, OPERABILITY, WEB_ASSETS, AI_SIGNAL, PRIVACY_EXPOSURE, PRIVACY_FLOWS oder PRIVACY_LIFECYCLE.
statusstring- NEW (seit dem vorherigen Audit hinzugekommen) oder EXISTING.
limitnumber- Seitengröße, 1–100. Standard: 25.
cursorstring- Der nextCursor-Wert der vorherigen Seite.
| Argument | Typ | Beschreibung |
|---|---|---|
auditIderforderlich | uuid | Das zu lesende Audit. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW oder INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY oder GIT_HISTORY: nur Befunde dieser Suite. |
category | string[] | SECURITY, SECRETS, DEPENDENCIES, INFRASTRUCTURE, QUALITY, MAINTAINABILITY, DUPLICATION, TESTING, DOCUMENTATION, HYGIENE, LICENSES, DEPENDENCY_HEALTH, ACTIVITY, HALLUCINATION, UNFINISHED_CODE, VIBE_STACK, LLM_SECURITY, RESILIENCE, DATABASE, OPERABILITY, WEB_ASSETS, AI_SIGNAL, PRIVACY_EXPOSURE, PRIVACY_FLOWS oder PRIVACY_LIFECYCLE. |
status | string | NEW (seit dem vorherigen Audit hinzugekommen) oder EXISTING. |
limit | number | Seitengröße, 1–100. Standard: 25. |
cursor | string | Der nextCursor-Wert der vorherigen Seite. |
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }vetkit_suggest_fix
Schlägt einen minimalen Patch für einen Code-Befund (SAST, Secrets, LLM-App, IaC) vor – mit dem KI-Anbieter, den Ihre Organisation in vetkit gespeichert hat, oder mit einem regelbasierten Fix, wenn der Analyzer einen liefert. Liefert einen Unified Diff, eine Erklärung, eine Konfidenzstufe und einen Prüfstatus. An den Anbieter geht nur ein geschwärzter Ausschnitt von etwa 60 Zeilen. Es wird nichts geschrieben: kein Branch, kein Commit, kein Pull Request. Erfordert einen Schlüssel, den ein Organisationsadministrator erstellt hat.nur lesendScopes: findings:write
findingIduuiderforderlich- ID eines Code-Befunds aus vetkit_list_findings.
providerstring- Zu verwendender gespeicherter KI-Anbieter. Standard ist die erste verifizierte Verbindung.
| Argument | Typ | Beschreibung |
|---|---|---|
findingIderforderlich | uuid | ID eines Code-Befunds aus vetkit_list_findings. |
provider | string | Zu verwendender gespeicherter KI-Anbieter. Standard ist die erste verifizierte Verbindung. |
{ "findingId": "0193b2c4-…" }vetkit_triage_findings
Fragt den gespeicherten KI-Anbieter Ihrer Organisation, ob bis zu 20 Befunde eines Audits wahrscheinlich echte oder falsch positive Treffer sind. Jeder Befund erhält ein Urteil, eine Konfidenz und eine kurze Begründung, die eine Quellzeile zitiert. Die Urteile sind Empfehlungen: Sie passen die Priorität an, unterdrücken aber nie einen Befund und ändern nicht die Bewertung. Erfordert einen kostenpflichtigen Plan.schreibendScopes: findings:write
auditIduuiderforderlich- Das Audit, zu dem die Befunde gehören.
findingIdsuuid[]erforderlich- Bis zu 20 Befund-IDs aus vetkit_list_findings.
| Argument | Typ | Beschreibung |
|---|---|---|
auditIderforderlich | uuid | Das Audit, zu dem die Befunde gehören. |
findingIdserforderlich | uuid[] | Bis zu 20 Befund-IDs aus vetkit_list_findings. |
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }vetkit_get_report
Liefert den Bericht eines abgeschlossenen Audits: lesbares Markdown, eine JSON-Zusammenfassung mit Scores je Suite und Kategorie sowie dem Vergleich mit dem vorherigen Audit oder SARIF 2.1.0.nur lesendScopes: reports:read
auditIduuiderforderlich- Das zu lesende Audit.
formatstring- markdown (Standard), json oder sarif.
maxCharsnumber- Ausgabe ab dieser Zeichenzahl kürzen, 2.000–500.000. Standard: 40.000.
| Argument | Typ | Beschreibung |
|---|---|---|
auditIderforderlich | uuid | Das zu lesende Audit. |
format | string | markdown (Standard), json oder sarif. |
maxChars | number | Ausgabe ab dieser Zeichenzahl kürzen, 2.000–500.000. Standard: 40.000. |
{ "auditId": "0192f3a4-…", "format": "markdown" }vetkit_get_standards_report
Ordnet die offenen Befunde eines Audits OWASP Top 10 (2021 oder 2025), CWE Top 25 (2024) oder OWASP Top 10 for LLM Applications (2025) zu. Jede Kategorie ist fail, pass (keine zugeordneten Befunde von Checks, die sie erkennen können) oder not covered. Eine Zuordnungshilfe, keine Compliance-Zertifizierung.nur lesendScopes: reports:read, findings:read
auditIduuiderforderlich- Das zuzuordnende Audit.
standardstringerforderlich- owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 oder owasp-llm-top10-2025.
| Argument | Typ | Beschreibung |
|---|---|---|
auditIderforderlich | uuid | Das zuzuordnende Audit. |
standarderforderlich | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 oder owasp-llm-top10-2025. |
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }vetkit_check_packages
Vor dem Installieren einer Abhängigkeit aufrufen. Prüft bis zu 50 Pakete eines Ökosystems gegen die öffentliche Registry, OSV-Advisories (einschließlich bekannter Schadpakete), CISA KEV und die Richtlinie Ihrer Organisation und liefert allow, warn oder block mit Gründen.nur lesendScopes: agent:check
ecosystemstringerforderlich- npm, pypi, cargo, go, rubygems, nuget oder maven. Für pip und uv pypi verwenden.
packagesobject[]erforderlich- Bis zu 50 Pakete: ein Name (Maven group:artifact, Go-Modulpfad) und optional eine exakte Version.
| Argument | Typ | Beschreibung |
|---|---|---|
ecosystemerforderlich | string | npm, pypi, cargo, go, rubygems, nuget oder maven. Für pip und uv pypi verwenden. |
packageserforderlich | object[] | Bis zu 50 Pakete: ein Name (Maven group:artifact, Go-Modulpfad) und optional eine exakte Version. |
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }vetkit_scan_changes
Vor dem Committen aufrufen. Durchsucht bis zu 30 geänderte Dateien (insgesamt 512 KB) im Speicher nach exakt geformten Secrets, riskanter Agent-Konfiguration und versteckten Anweisungen, unfertigem Code und Importen nicht existierender Pakete. Nichts wird gespeichert oder ausgeführt.nur lesendScopes: agent:check
filesobject[]erforderlich- Geänderte Dateien: ein repository-relativer Pfad wie src/app.ts und der vollständige UTF-8-Inhalt.
| Argument | Typ | Beschreibung |
|---|---|---|
fileserforderlich | object[] | Geänderte Dateien: ein repository-relativer Pfad wie src/app.ts und der vollständige UTF-8-Inhalt. |
{ "files": [{ "path": "src/config.ts", "content": "…" }] }Agent-Guardrails
Mit zwei Tools prüft ein Coding-Agent seine Arbeit, bevor er handelt: vetkit_check_packages vor dem Installieren einer Abhängigkeit und vetkit_scan_changes vor dem Committen. Beide benötigen einen API-Schlüssel mit dem Scope agent:check.
Beide liefern ein Urteil allow, warn oder block mit Gründen. Block: Das Paket existiert nicht (ein halluzinierter oder per Slopsquatting registrierter Name), hat in OSV einen Eintrag als bekanntes Schadpaket, hat ein CISA-KEV-Advisory, wenn Ihre Richtlinie bekannt ausgenutzte Schwachstellen blockiert, nutzt eine Lizenz von der Sperrliste Ihrer Organisation, oder die Änderung enthält ein committetes Secret. Warn: eine unveröffentlichte Version, ein sehr neues Release, geringe Verbreitung, ein Advisory ab der Mindestschwere Ihrer Richtlinie oder andere Code-Befunde. Nicht erreichbare Quellen werden als Warnungen aufgeführt; diese Prüfungen werden übersprungen, nie geraten.
Claude Code-Hook
vetkit-mcp hook pre-tool-use liest die PreToolUse-Eingabe von Claude Code, findet Paketinstallationen in Bash-Befehlen und beendet sich mit Code 2, wenn vetkit ein Paket blockiert – Claude Code stoppt dann den Befehl und zeigt den Grund. Andernfalls endet er mit 0 und gibt eventuelle Warnungen aus. Bei Fehlern blockiert er nicht: Ohne VETKIT_API_KEY oder wenn die API nicht erreichbar ist, warnt er und lässt den Befehl laufen. Fügen Sie ihn in .claude/settings.json ein:
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "npx -y @vetkit/mcp hook pre-tool-use", "timeout": 30 } ] } ] }}Setzen Sie VETKIT_API_KEY in Ihrer Shell auf einen Schlüssel mit dem Scope agent:check, nicht in einer committeten Datei.
Cursor und andere Clients
vetkit_check_packages und vor dem Committen vetkit_scan_changes aufzurufen. Die MCP-Seite in der vetkit-App enthält eine fertige Cursor-Regel.Prüfungen
Es gibt fünf bewertete Suites sowie die optionalen Suites Datenschutz (Beta) und Git-Verlauf, die die Note nicht beeinflussen. Jede bewertete Suite erhält eine eigene Note, und der Gesamtscore gewichtet Sicherheit mit 43 %, Codequalität mit 18 %, Nachhaltigkeit mit 11 %, KI-Code-Risiken mit 13 % und Produktionsreife mit 15 %. Es zählen nur ausgeführte Suites, auf die sich die Gewichte verteilen (ohne Produktionsreife: Sicherheit 50 %, Codequalität 22 %, Nachhaltigkeit 13 % und KI-Code-Risiken 15 %; wenn nur Sicherheit und Codequalität ausgeführt wurden: 70 % und 30 %). Übergeben Sie Prüfungs-IDs in analyzers oder eine Suite in suites.
Sicherheit
- Prüfungs-ID:
postureCommittete .env-Dateien, private Schlüssel und Keystores, Manifeste ohne Lockfile, fehlende Sicherheitsrichtlinie.Kategorie: SECRETS, DEPENDENCIES, SECURITY - Prüfungs-ID:
gitleaksAPI-Schlüssel, Tokens, Passwörter und private Schlüssel im Quellcode.Kategorie: SECRETS - Prüfungs-ID:
secrets-historyCommittete und später entfernte Zugangsdaten, die sich noch aus der Git-Historie wiederherstellen lassen. Nur bei expliziter Auswahl.Kategorie: SECRETS - Prüfungs-ID:
osvBekannte CVEs, schädliche Pakete und aktiv ausgenutzte Schwachstellen (CISA KEV) in festgeschriebenen Abhängigkeiten.Kategorie: DEPENDENCIES - Prüfungs-ID:
vendoredBekannt verwundbare JavaScript-Bibliotheken, die ins Repository kopiert wurden.Kategorie: DEPENDENCIES - Prüfungs-ID:
eolNicht mehr unterstützte Laufzeitumgebungen, Frameworks und Container-Basis-Images.Kategorie: DEPENDENCIES - Prüfungs-ID:
supply-chainLockfile-Injection, unsichere Registrys, riskante Installationsskripte, Trojan Source und committete ausführbare Dateien.Kategorie: DEPENDENCIES, SECURITY - Prüfungs-ID:
sastAusgewählte Codesicherheitsregeln für unterstützte Sprachen sowie unsichere Server-, Mobil- und Shell-Konfigurationen.Kategorie: SECURITY - Prüfungs-ID:
sast-communityZusätzliche, permissiv lizenzierte Community-Regelpakete. Nur bei expliziter Auswahl, Beta.Kategorie: SECURITY - Prüfungs-ID:
iacFehlkonfigurationen in Terraform, CloudFormation, Kubernetes, Helm und Dockerfiles (Trivy).Kategorie: INFRASTRUCTURE - Prüfungs-ID:
workflowsScript Injection in GitHub Actions, zu weit gefasste Berechtigungen, nicht gepinnte Actions und Pwn Requests (zizmor).Kategorie: INFRASTRUCTURE
Codequalität
- Prüfungs-ID:
code-smellsVerschluckte Fehler, vergessene Debug-Anweisungen, verdächtige Vergleiche und anderer fehleranfälliger Code.Kategorie: QUALITY - Prüfungs-ID:
complexityFunktionen mit hoher zyklomatischer Komplexität, tiefer Verschachtelung, langem Funktionsrumpf oder langen Parameterlisten.Kategorie: MAINTAINABILITY - Prüfungs-ID:
duplicationPer Copy-and-paste über Dateien hinweg duplizierte Codeblöcke.Kategorie: DUPLICATION - Prüfungs-ID:
testsFehlende oder dürftige Testsuites, große ungetestete Dateien, fokussierte oder übersprungene Tests, Tests ohne Assertions, eine CI, die nie Tests ausführt.Kategorie: TESTING - Prüfungs-ID:
docsREADMEs ohne Einrichtungs- oder Nutzungshinweise, undokumentierte öffentliche APIs, veröffentlichte Pakete ohne Changelog.Kategorie: DOCUMENTATION - Prüfungs-ID:
hygieneREADME, LICENSE, CI und .gitignore; committete Build-Ausgaben, eingebettete Abhängigkeiten und große Dateien.Kategorie: HYGIENE
Nachhaltigkeit
- Prüfungs-ID:
licensesAbhängigkeiten unter Copyleft-Lizenzen (GPL, AGPL), nutzungsbeschränkten oder unbekannten Lizenzen, die mit der Projektlizenz kollidieren.Kategorie: LICENSES - Prüfungs-ID:
dep-healthDirekte Abhängigkeiten, die abgekündigt sind, zwei oder mehr Major-Versionen zurückliegen oder nicht mehr veröffentlicht werden.Kategorie: DEPENDENCY_HEALTH - Prüfungs-ID:
activityInaktive Repositorys, Abhängigkeit von einer einzelnen Person (Bus-Faktor) und große Dateien, die sich häufig ändern.Kategorie: ACTIVITY
KI-Code-Risiken
- Prüfungs-ID:
hallucinated-depsAbhängigkeiten und Importe, die in der öffentlichen Registry nicht existieren (Ziele für Slopsquatting), nie veröffentlichte Versionen, Pakete, die erstmals in den letzten 30 Tagen veröffentlicht wurden, sowie Importe, die in package.json fehlen.Kategorie: HALLUCINATION - Prüfungs-ID:
ai-slopStubs, Platzhalter wie „Rest des Codes“, Mock-Daten und Platzhalter-Zugangsdaten in Produktionspfaden, Dateiduplikate mit Kopie-Suffix sowie pauschale Typ- oder Lint-Unterdrückungen.Kategorie: UNFINISHED_CODE - Prüfungs-ID:
vibe-stackSupabase-Tabellen ohne Row Level Security, Secrets in öffentlichen Umgebungsvariablen, API-Routen ohne Authentifizierung und Zugriffsprüfungen, die nur clientseitig erfolgen.Kategorie: VIBE_STACK - Prüfungs-ID:
llm-appPfade für Prompt Injection, LLM-Ausgaben, die in Codeausführung, SQL oder HTML gelangen, LLM-API-Schlüssel im Client-Code, unbegrenzte Modellaufrufe und riskante Konfiguration von KI-Agenten.Kategorie: LLM_SECURITY - Prüfungs-ID:
ai-signalHeuristisches KI-Autorschaftssignal. Beta, rein informativ, fließt nie in den Score ein; nur verfügbar, wenn auf dem Server aktiviert.Kategorie: AI_SIGNAL
Produktionsreife
- Prüfungs-ID:
resilienceAusgehende HTTP-Aufrufe ohne Timeout, blockierende Aufrufe im Request-Pfad und in async-Funktionen, Datenbank-Clients, die pro Request erzeugt werden.Kategorie: RESILIENCE - Prüfungs-ID:
data-accessAbfragen in Schleifen (N+1), Listen-Endpunkte ohne Paginierung, Fremdschlüssel ohne Index, Schema-Synchronisierung beim Start, die Daten löschen kann.Kategorie: DATABASE - Prüfungs-ID:
operabilityBereitgestellte Dienste, die einen Entwicklungsserver ausführen, Passwörter ohne Rate-Limit für Logins prüfen oder kein Graceful Shutdown, keinen Health Check oder kein Fehler-Tracking haben.Kategorie: OPERABILITY
Lang laufende Audits
Die meisten Audits sind in wenigen Minuten abgeschlossen. vetkit_run_audit fragt alle paar Sekunden den Status ab und sendet während des Wartens Fortschrittsbenachrichtigungen. Manche Clients brechen Tool-Aufrufe nach einer festen Zeit ab — Claude Code beachtet zum Beispiel MCP_TOOL_TIMEOUT. Falls Ihr Client das tut, übergeben Sie "wait": false und fragen Sie mit vetkit_get_audit ab. Wenn timeoutSeconds abgelaufen ist, läuft das Audit weiter und das Tool liefert "outcome": "still_running".
Fehler
API-Fehler kommen als Tool-Ergebnisse mit isError: true zurück und enthalten HTTP-Status, vetkit-Fehlercode, Meldung, Anfrage-ID und einen Hinweis.
401 API_KEY_INVALID,API_KEY_REVOKED,API_KEY_EXPIRED— erstellen oder rotieren Sie einen Schlüssel, aktualisieren SieVETKIT_API_KEYund starten Sie den Server neu.403 INSUFFICIENT_SCOPE— dem Schlüssel fehlt ein Scope, den das Tool benötigt.409 AUDIT_CONCURRENCY_LIMITund429 RATE_LIMITED— warten und erneut versuchen; der Hinweis enthält die Wartezeit, wenn die APIRetry-Aftersendet.402 INSUFFICIENT_CREDITS— ein vollständiger Scan benötigt 1 Credit des Workspace-Inhabers. Fordern Sie in der vetkit-App weitere Credits an oder führen Sie einen kostenlosen Quick Scan des Standard-Branches aus, solange das monatliche Kontingent reicht.422 ANALYZER_UNAVAILABLE— eine Prüfung inanalyzerskann auf diesem Server nicht ausgeführt werden. Rufen Sievetkit_list_checksauf oder übergeben Siesuites; dabei werden nur verfügbare Prüfungen ausgewählt.INSTALLATION_REQUIREDwird als normales Ergebnis mit der Installations-URL der GitHub App zurückgegeben, nicht als Fehler.
Sicherheitshinweise
- Behandeln Sie den API-Schlüssel wie ein Passwort. Er gewährt Zugriff auf die Audits und Befunde Ihrer Organisation, einschließlich privater Repositorys. Bewahren Sie ihn in der
env-Konfiguration Ihres MCP-Clients auf, niemals in Dateien, die Sie committen. Vergeben Sie nur die Scopes, die Sie benötigen, legen Sie ein Ablaufdatum fest und widerrufen Sie ihn in der App, falls er offengelegt wird. - Der Schlüssel wird ausschließlich an
VETKIT_API_URLgesendet, alsAuthorization: Bearer-Header über HTTPS. Der Server protokolliert ihn nie und nimmt ihn nie in Fehlermeldungen auf. - Der Server kommuniziert per MCP ausschließlich über stdio. Er öffnet keine Netzwerkports und protokolliert nur nach stderr.
- Snippets von Befunden werden maskiert, bevor vetkit sie speichert; Secret-Werte werden nie zurückgegeben.
- Bericht- und Befundtexte stammen aus dem geprüften Repository (Dateipfade, Meldungen). Behandeln Sie sie wie jede andere Tool-Ausgabe als nicht vertrauenswürdige Eingabe — ein bösartiges Repository könnte versuchen, Anweisungen an Ihren Agenten einzuschleusen.
Lieber direkt per HTTP? Alles, was der MCP-Server kann, ist auch über die REST-API verfügbar.