Skip to main content
Glama

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.

Related MCP server: claude-beacon

Werkzeug

watch_ci

Parameter

Typ

Standard

Beschreibung

cwd

string

— (erforderlich)

Pfad zum lokalen Klon des Repos mit origin auf GitHub

ref

string

HEAD

SHA (vollständig oder kurz) oder ein beliebiger git-ref

workflow

string

—

Filter nach Workflow-Name, falls es mehrere im Repo gibt

timeout_ms

number

300000 (5 Min.)

Obergrenze 1200000 (20 Min.)

poll_interval_ms

number

5000

Abfrageintervall für gh run list

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.

Available Tools

1 tool
watch_ciДочекатись завершення GitHub Actions CIA

Чекає, поки GitHub Actions CI завершиться для поточного (або заданого) коміту в локальному git-репозиторії, і повертає підсумок ОДНИМ викликом: ok/conclusion/url, а за провалу - одразу хвіст логу невдалих кроків (--log-failed), без окремого запиту. Заміняє ручний цикл "push -> sleep -> gh run list -> (якщо впало) gh run view --log-failed".

Inputs: cwd (required), ref, workflow, timeout_ms, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is zero ambiguity in tool selection. The tool's purpose is clearly defined and distinct.

    Naming Consistency4/5

    With a single tool, naming consistency is trivially maintained. The name 'watch_ci' is descriptive and follows a verb_noun pattern, though no comparison set exists to evaluate full consistency.

    Tool Count5/5

    A single-purpose server with one tool is well-scoped. The tool encapsulates a complete workflow (waiting for CI and returning results), avoiding unnecessary fragmentation.

    Completeness4/5

    The tool covers the core CI-watching workflow effectively, including failure log retrieval. Minor gaps exist (e.g., no explicit cancel or list operations), but they are outside the tool's stated purpose and do not hinder its primary function.

    Related MCP Connectors

    Related MCP Servers