ofershap/mcp-server-github-actions 소개…CI 로그·재실행·workflow_dispatch를 AI 에이전트에서

공식 github/github-mcp-server가 저장소·이슈·PR을 잘 다루더라도, GitHub Actions 운영(로그·재실행·workflow_dispatch)까지는 구멍이 남습니다. ofershap/mcp-server-github-actions는 그 구멍을 메우는 MCP 서버로, CI 실패 원인을 에디터 안에서 묻고 실패한 job만 다시 돌리거나 배포 워크플로를 트리거할 수 있게 합니다.

왜 쓰나

• CI가 깨졌을 때 브라우저에서 Actions 탭을 헤매지 않고 에이전트에게 “마지막 실패 로그 요약해”라고 요청
• 실패한 job만 재실행(rerun_failed_jobs)해 전체 파이프라인 대기 시간을 줄임
• workflow_dispatch로 스테이징 배포·수동 워크플로를 채팅에서 실행

공식 GitHub MCP가 이미 블로그에 소개된 적이 있다면, 이 글은 Actions 깊이에 특화된 보완재로만 이해하면 됩니다. 이슈/PR 본체를 대체하지 않습니다.

제공 도구

• list_workflows — 저장소 워크플로 파일 목록
• list_runs — 실행 목록(워크플로·상태 필터)
• get_run — 특정 런 상세
• get_run_logs — 로그(zip) URL
• rerun_workflow / rerun_failed_jobs — 전체·실패 job 재실행
• cancel_run — 진행 중 런 취소
• list_artifacts — 아티팩트 목록
• trigger_workflow — workflow_dispatch 트리거

설치 (Cursor 예시)

{
  "mcpServers": {
    "github-actions": {
      "command": "npx",
      "args": ["-y", "mcp-server-github-actions"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

실행 엔트리도 README 기준으로 npx mcp-server-github-actions입니다. Claude Desktop·VS Code에도 동일하게 command/args/env만 맞추면 됩니다.

토큰 권한

• Fine-grained PAT: 대상 저장소에 Actions: Read and Write
• Classic: repo 스코프(Actions 포함)
• 토큰은 MCP env에만 두고 채팅·깃 커밋에 넣지 마세요

예시 프롬프트

• “owner/repo 최근 CI 런 5개 상태 요약”
• “런 67890의 실패 job만 재실행”
• “deploy.yml을 staging 브랜치에 workflow_dispatch”
• “최신 런 아티팩트 목록”

공식 GitHub MCP와의 역할 분담

공식 서버: 코드 검색, 이슈, PR, 리뷰 등 개발 협업 축.
이 서버: Actions 런·로그·rerun·dispatch 등 CI/CD 축.
둘을 같이 켜 두고 “PR 머지 전 실패 원인 → 재실행 → 통과 확인” 루프를 에이전트에게 맡기는 구성이 실용적입니다.

FAQ

Q. npm 패키지명이 뭔가요?
A. README 기준 mcp-server-github-actions이며 npx로 실행합니다.

Q. 조직 저장소에서 거절당해요.
A. 토큰에 Actions 쓰기와 해당 repo 접근이 있는지, SSO authorize가 필요한 org인지 확인하세요.

Q. 로그 전문이 너무 길어요.
A. get_run_logs는 URL/zip 중심입니다. 에이전트에게 job 이름·실패 스텝만 요약하라고 지시하세요.

핵심 정리

• Actions 공백을 메우는 커뮤니티 MCP
• npx + GITHUB_TOKEN(Actions R/W)
• 공식 github-mcp-server와 보완 관계

출처

GitHub: https://github.com/ofershap/mcp-server-github-actions