ci-watch-mcp
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
パラメータ | 型 | デフォルト | 説明 |
| string | — (必須) | GitHubに |
| string |
| SHA(完全または短縮)または任意のgit-ref |
| string | — | リポジトリに複数のworkflowがある場合の名前によるフィルター |
| number |
| 上限 |
| number |
|
|
返り値:
{ 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 installClaude Codeへの接続:
claude mcp add ci-watch -s user -- node /шлях/до/ci-watch-mcp/src/server.jsインストール済みで認証済みのgh CLI(gh auth status)が必要です。
テスト
npm testsecretscanリポジトリのすでに完了した実際の実行(成功、失敗、CI実行のないコミット)に対して実行されます—ライブのプッシュを待つ必要はありません。
ライセンス
MIT — Faneraiy14.
Available Tools
1 toolwatch_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
Scored across 1 tool
Only one tool exists, so there is zero ambiguity in tool selection. The tool's purpose is clearly defined and distinct.
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.
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.
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
MCP server for CertScore.ai public website risk-signal workflows.
Create, deploy, and operate MCP servers directly from your GitHub repositories.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for Appcircle mobile CI/CD platform.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for GitHub Actions — view workflow runs, read logs, re-run failed jobs, and manage CI/CD.955 npm5MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that pushes GitHub Actions CI/CD results and PR events into Claude Code sessions, enabling automatic investigation and remediation.42 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for GitHub Actions CI failure triage. It wraps the gh CLI to fetch PR checks, failed jobs, and tail/grep failed job logs with ANSI/timestamp stripping and root-cause extraction.5MIT
- AlicenseAqualityDmaintenanceMCP server that lets Claude diagnose failed GitHub Actions runs by fetching and parsing CI logs into structured failure signals, enabling natural-language questions like 'Why did the last run fail?'.6MIT