ci-watch-mcp

MCP-Server mit einem einzigen Tool watch_ci — wartet, bis GitHub Actions CI für einen Commit im lokalen git-Repository abgeschlossen ist, und gibt mit einem einzigen Aufruf eine Zusammenfassung zusammen mit dem Fehlerprotokoll zurück, falls etwas fehlgeschlagen ist.

Wozu

Ohne dies ist die Prüfung „Hat CI nach meinem Push bestanden?" manuell: push → sleep → gh run list → wenn der Status „in_progress" ist, nochmal sleep → wieder gh run list → wenn conclusion: failure, ein separater Aufruf von gh run view <id> --log-failed, um zu sehen, was genau kaputtgegangen ist. watch_ci erledigt das alles mit einem einzigen Aufruf und liefert sofort das Fehlerprotokoll zurück, ohne manuelle Warteschleife.

Werkzeug

watch_ci

Gibt zurück:

• { ok: true, conclusion: "success", url, sha, workflowName } — CI bestanden;

• { ok: false, conclusion: "failure", url, sha, workflowName, failedLogs } — CI fehlgeschlagen, failedLogs — das Ende von gh run view --log-failed (auf 8000 Zeichen gekürzt, vom Ende — dort ist es am informativsten);

• { ok: false, timedOut: true, status, url, message } — konnte innerhalb der vorgegebenen Zeit nicht abgeschlossen/gestartet werden.

Wenn ref nicht in einen echten Commit aufgelöst werden kann (Tippfehler im SHA), wirft das Tool sofort einen Fehler, anstatt still bis zum Timeout zu warten.

Installation

cd ci-watch-mcp
npm install

Einbindung in Claude Code:

claude mcp add ci-watch -s user -- node /шлях/до/ci-watch-mcp/src/server.js

Ein installiertes und authentifiziertes gh CLI ist erforderlich (gh auth status).

Tests

npm test

Sie laufen gegen bereits abgeschlossene reale Läufe im Repository secretscan (erfolgreich, fehlgeschlagen, und ein Commit ohne jeden CI-Lauf) — ohne auf einen Live-Push warten zu müssen.

Lizenz

MIT — Faneraiy14.