ci-watch-mcp
MCP-сервер із одним інструментом watch_ci — чекає, поки GitHub ActionsCI завершиться для коміту в локальному git-репозиторії, і одним викликомповертає підсумок разом із логом помилки, якщо щось впало.
Навіщо
Без цього перевірка "чи пройшов CI після мого пушу" — це вручну:push → sleep → gh run list → якщо в статусі "in_progress", ще sleep →знову gh run list → якщо conclusion: failure, окремий викликgh run view <id> --log-failed, щоб побачити, що саме зламалось.watch_ci робить усе це за один виклик і одразу повертає лог провалу,без ручного циклу очікування.
Інструмент
watch_ci
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
cwd |
string | — (обов'язковий) | Шлях до локального клону репозиторію з origin на GitHub |
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.
