Skip to main content
Glama

ci-watch-mcp

1つのツールwatch_ciを備えたMCPサーバー。ローカルgitリポジトリのコミットに対してGitHub Actions CIが完了するのを待ち、1回の呼び出しで、何かが失敗した場合にはエラーログとともに結果を返します。

目的

これがないと、「プッシュ後にCIが通ったか」の確認は手作業です: push → sleep → gh run list → ステータスが"in_progress"ならさらにsleep → もう一度gh run list → conclusion: failureなら、何が壊れたのかを確認するためにgh run view <id> --log-failedを別途呼び出す。 watch_ciはこれらすべてを1回の呼び出しで行い、手動の待機ループなしで失敗ログをすぐに返します。

Related MCP server: claude-beacon

ツール

watch_ci

パラメータ

型

デフォルト

説明

cwd

string

— (必須)

GitHubにoriginがあるリポジトリのローカルクローンのパス

ref

string

HEAD

SHA(完全または短縮)または任意のgit-ref

workflow

string

—

リポジトリに複数のworkflowがある場合の名前によるフィルター

timeout_ms

number

300000(5分)

上限1200000(20分)

poll_interval_ms

number

5000

gh run listのポーリング間隔

返り値:

  • { ok: true, conclusion: "success", url, sha, workflowName } — CIが成功しました;

  • { ok: false, conclusion: "failure", url, sha, workflowName, failedLogs } — CIが失敗しました。failedLogsはgh run view --log-failedの末尾(8000文字に切り詰め、末尾から—そこが最も情報量が多い)です;

  • { ok: false, timedOut: true, status, url, message } — 制限時間内に完了/開始しませんでした。

refが実際のコミットに解決できない場合(SHAのタイプミスなど)、ツールはタイムアウトまで黙って待つのではなく、すぐにエラーを投げます。

インストール

cd ci-watch-mcp
npm install

Claude Codeへの接続:

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

インストール済みで認証済みのgh CLI(gh auth status)が必要です。

テスト

npm test

secretscanリポジトリのすでに完了した実際の実行(成功、失敗、CI実行のないコミット)に対して実行されます—ライブのプッシュを待つ必要はありません。

ライセンス

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