Buildkite

공식

Buildkite 파이프라인과 빌드를 관리합니다.

GitHub
52

Buildkite MCP(으)로 무엇을 할 수 있나요?

  • 파이프라인 목록 보기 — list_pipelines를 사용하여 Buildkite 조직의 파이프라인을 탐색하도록 어시스턴트에 요청합니다.
  • 빌드 검사하기 — list_builds로 파이프라인의 최근 빌드를 검색하고 get_build를 통해 특정 빌드의 세부 정보를 자세히 확인합니다.
  • 작업 및 로그 확인하기 — list_jobs를 사용하여 빌드 내 작업을 나열하고 get_job_log로 작업의 원시 로그 출력을 가져옵니다.
  • 테스트 결과 검토하기 — list_tests와 get_test를 통해 빌드의 테스트 요약 및 개별 테스트 세부 정보에 접근합니다.

문서

buildkite-mcp-server

Build status

Model Context Protocol (MCP) 서버로, Buildkite 데이터(파이프라인, 빌드, 작업, 테스트)를 AI 도구 및 편집기에 노출합니다.

전체 문서는 buildkite.com/docs/apis/mcp-server에서 확인할 수 있습니다.

라이브러리 사용법

이 모듈의 내보내진 Go API는 불안정한 것으로 간주해야 하며, 프로젝트가 발전함에 따라 주요 변경 사항이 발생할 수 있습니다.

보안

MCP 서버가 안전한 환경에서 실행되도록 하려면 컨테이너에서 실행하는 것이 좋습니다.

이 이미지는 cgr.dev/chainguard/static에서 빌드되며 권한이 없는 사용자로 실행됩니다.

HTTP 모드를 통한 ID 헤더 전달

자체 호스팅 HTTP 배포는 각 인바운드 MCP 요청에서 선택한 헤더를 Buildkite API로 전달할 수 있습니다:

BUILDKITE_API_TOKEN=bkua_xxx \
  buildkite-mcp-server http \
  --passthrough-http-header X-User-Identity

둘 이상의 헤더를 허용하려면 --passthrough-http-header을 반복하거나 쉼표로 구분된 BUILDKITE_PASSTHROUGH_HTTP_HEADERS 값을 설정하세요. 명시적으로 허용된 헤더만 전달되며, BUILDKITE_BASE_URL에 의해 구성된 오리진으로만 전달됩니다. 다른 곳으로 리디렉션되는 요청에서는 제거됩니다.

각 MCP 요청을 자체 Buildkite API 토큰으로 인증하려면 Authorization을 허용하고 프로세스 전체 토큰을 생략하세요:

BUILDKITE_PASSTHROUGH_HTTP_HEADERS=Authorization \
  buildkite-mcp-server http

이 모드에서는 모든 /mcp 요청에 비어 있지 않은 Authorization 헤더가 정확히 하나 포함되어야 합니다. 자격 증명이 누락되면 HTTP 401이 반환되며, 서버는 공유 API 토큰으로 절대 폴백하지 않습니다. MCP 서버 앞의 리버스 프록시는 호출자를 인증하고 전달된 모든 ID 헤더를 설정하거나 검증할 책임이 있습니다.

헤더 통과는 stdio 모드에서 사용할 수 없습니다. 작업 로그를 제공하기 전에 서버는 현재 호출자가 작업 로그에 액세스할 수 있는지 확인합니다. 이 확인은 로그 데이터가 이미 캐시된 경우를 포함하여 모든 로그 도구 요청에 대해 수행됩니다.

기여

개발 가이드라인은 DEVELOPMENT.md에 있습니다.

라이선스

MIT © Buildkite

SPDX-License-Identifier: MIT