ci-watch-mcp

MCP 서버에는 watch_ci라는 단일 도구가 있습니다. 로컬 git 저장소의 커밋에 대해 GitHub Actions CI가 완료될 때까지 기다렸다가, 한 번의 호출로 요약과 함께 실패 시 오류 로그를 반환합니다.

왜

이것이 없으면 "내 푸시 후 CI가 통과했는지" 확인은 수동으로 해야 합니다: push → sleep → gh run list → 상태가 "in_progress"이면 다시 sleep → 다시 gh run list → conclusion: failure이면, 무엇이 실패했는지 보기 위해 별도로 gh run view <id> --log-failed를 호출해야 합니다. watch_ci는 이 모든 것을 한 번의 호출로 처리하고, 수동 대기 루프 없이 즉시 실패 로그를 반환합니다.

도구

watch_ci

반환값:

• { 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.