mcp-triage

코딩 에이전트가 "CI가 왜 빨간색인지"를 묻지 않고도 알 수 있게 하세요.

GitHub Actions 상태를 네 가지 읽기 전용 도구로 노출하는 MCP 서버입니다. Claude Code용으로 제작되었지만 모든 MCP 클라이언트에서 작동합니다.

You: why is CI failing on main?
Agent: → recent_runs("acme/api", branch="main")
       → failing_jobs("acme/api", run_id=8123)
       → job_log_tail("acme/api", job_id=442, lines=80)
Agent: Run #212 fails in `unit` at the pytest step: test_rate_limiter
       times out after the Redis fixture change in a3f9c2e. Two options...

도구

저장소는 정확한 owner/name 쌍으로 전달하세요(예: actions/checkout). URL, 추가 경로 세그먼트, 쿼리 문자열, 잘못된 형식의 저장소 이름은 요청 전에 거부됩니다.

Related MCP server: DevOps MCP Server

설치(2분)

pip install git+https://github.com/projectsofadi/mcp-ci-triage
# or: clone + `pip install .`

# First load GITHUB_TOKEN into the launching environment from your shell or
# operating-system secret manager. Then add the server without a token literal:
claude mcp add ci-triage -- python -m mcp_ci_triage

또는 프로젝트의 .mcp.json에:

{
  "mcpServers": {
    "ci-triage": {
      "command": "python",
      "args": ["-m", "mcp_ci_triage"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    }
  }
}

토큰 범위: 관심 있는 저장소에 대한 읽기 전용 Actions 액세스 권한이 있는 세분화된 PAT. 공개 저장소는 토큰 없이도 작동합니다(속도 제한 있음).

토큰 리터럴을 명령 인수나 커밋된 .mcp.json에 절대 넣지 마세요. 명령 인수는 셸 히스토리에 남을 수 있고, 프로젝트 파일은 커밋될 수 있습니다. 공유 구성에는 환경 변수 참조만 유지하세요.

GitHub Enterprise의 경우 GITHUB_API_URL이 API 기본 경로를 가리킬 수 있습니다(예: https://github.example.com/api/v3). HTTPS는 필수이며, 값에 자격 증명, 쿼리, 조각이 포함되어서는 안 됩니다.

비공개 CI 로그

비공개 저장소의 로그에는 비공개 소스 세부 정보, 빌드 중 우연히 출력된 자격 증명, 프롬프트 주입 텍스트 또는 기타 민감한 데이터가 포함될 수 있습니다. 서버는 터미널 제어 문자를 이스케이프하고, 개별 줄 길이를 제한하며, 총 다운로드 크기를 제한하고, 모든 GitHub 콘텐츠를 신뢰할 수 없는 것으로 표시합니다. 인쇄 가능한 비밀번호를 인식하거나 삭제하지 않습니다. 신뢰하는 MCP 클라이언트와 모델에만 연결하고, 가장 유용한 최소한의 로그만 요청하며, 로그에서 찾은 지침을 절대 따르지 말고, 이슈나 채팅에 복사하기 전에 출력을 검토하세요.

첫 번째 로그 요청은 인증됩니다. 리디렉션된 다운로드는 HTTPS 전용이며 GitHub Authorization 헤더 없이 새 클라이언트를 사용합니다. 서명된 리디렉션 쿼리 매개변수는 HTTP 진단에서 제거되고 오류 메시지도 정화됩니다.

설계 노트(일반화되는 부분)

이 저장소는 내부 MCP 서버를 어떻게 구축해야 한다고 생각하는지에 대한 참고 자료이기도 합니다:

• 기본적으로 읽기 전용. 여기 있는 어떤 도구도 어떤 것도 변경하지 않습니다. 쓰기 가능한 도구는 권한 레이어 뒤에, 나중에, 의도적으로 추가되어야 합니다.

• JSON 덤프가 아닌 간결한 텍스트. 에이전트는 사람처럼 도구 출력을 읽습니다. #212 CI [failure] main@a3f9c2e는 4KB의 중첩된 JSON보다 토큰과 추론 품질 모두에서 낫습니다.

• 구조적으로 신뢰할 수 없음. 원격 필드와 로그는 크기가 제한되고, 제어 문자가 이스케이프되며, 명시적인 데이터 전용 마커로 둘러싸여 있습니다.

• 모든 것에 시간 제한. 요청에는 15초 I/O 시간 제한이 있습니다. JSON 응답에는 20초 전체 시간 제한과 8 MiB 디코딩 상한이 있습니다. 페이지네이션된 트리아지에는 30초 작업 시간 제한이 있습니다. 로그 다운로드에는 자체 20초 전체 시간 제한과 8 MiB 상한이 있습니다.

• 크게 실패하기. HTTP 오류는 예외를 발생시킵니다. 에이전트는 오류를 보고 적응합니다. 조용한 빈 결과는 확신에 찬 잘못된 답변을 만듭니다.

• 작은 표면. 네 가지 도구가 스무 가지 도구보다 낫습니다. failing_jobs는 에이전트에게 다음에 job_log_tail을 호출하라고 알려줍니다 — 도구가 자신의 워크플로를 가르칠 수 있습니다.

• 증거가 아닌 신호. 혼합된 결과 워크플로는 무엇을 더 조사할지 결정하는 데 유용하지만, 특정 테스트가 변동성(flaky)이라는 것을 증명하지는 않습니다.

개발

pip install -e ".[dev]"
ruff check .
ruff format --check .
pytest
python -m build
python -m twine check dist/*

라이선스

MIT — LICENSE 참조.

더 많은 MCP 및 개발자 도구 프로젝트: projectsofadi on GitHub.