gocd-mcp

GoCD용 MCP 서버입니다. GoCD의 REST API를 MCP 도구로 노출하여 모든 MCP 클라이언트(Claude Code, Claude Desktop, Cursor)가 파이프라인 상태를 읽고 파이프라인을 구동할 수 있습니다. 두 가지 구현이 이 저장소에 있으며 유선상에서 동일하게 동작합니다. 설치 방식에 맞는 것을 선택하세요.

• go/ — Go 구현. 단일 정적 바이너리 또는 Docker 이미지로 제공됩니다. 빠른 콜드 스타트, 낮은 메모리.

• ts/ — TypeScript 구현. 의존성 없이 Node에서 실행되므로 npx는 빌드 단계가 필요 없습니다.

둘 다 동일한 컨텍스트 절약형 출력을 반환합니다. 대시보드는 기본적으로 요약되고, 행은 열 지향적이며, 응답은 간결한 JSON입니다. 전체 GoCD 대시보드는 여러 파이프라인에 걸쳐 수 MB에 달합니다. 이 도구들은 모델이 필요한 만큼만 줄여서 제공합니다.

도구

읽기 도구(안전):

쓰기 도구(작동):

GOCD_READONLY=1을 설정하면 세 가지 쓰기 도구가 숨겨집니다. 대량 목록(dashboard, pipeline_groups, materials, environments)은 요약되거나 필터링할 수 있어 원본의 수 MB 본문을 모델 컨텍스트에 그대로 덤프하지 않습니다.

Related MCP server: Jenkins MCP Server

구성

두 개의 환경 변수, 둘 다 필수:

GOCD_BASE_URL=https://gocd.example.com
GOCD_ACCESS_TOKEN=<personal access token>

GOCD_BASE_URL은 /go 접미사가 없는 기본 호스트입니다. 도구들이 /go/api/...를 직접 추가합니다. 토큰은 GoCD의 프로필, Personal Access Tokens에서 생성하세요.

설치

npx(Node >= 18), 권장

설치 없음, 빌드할 것 없음. 서버를 실행하는 가장 간단한 방법:

claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- npx -y gocd-mcp

npm에 gocd-mcp로, MCP Registry에는 io.github.Sahilll15/gocd로 게시되어 있어 레지스트리를 인식하는 클라이언트가 이름으로 찾을 수 있습니다.

Go 바이너리

Releases에서 사전 빌드된 바이너리를 다운로드하거나 직접 빌드하세요:

cd go && go build -o gocd-mcp .

등록하세요:

claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- /path/to/gocd-mcp

Docker

claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... \
  -- docker run -i --rm -e GOCD_BASE_URL -e GOCD_ACCESS_TOKEN ghcr.io/sahilll15/gocd-mcp

개발 중 TypeScript 소스를 직접 실행하려면(Node >= 22.6, type-stripping 사용):

cd ts && node --experimental-strip-types src/server.ts

어떤 것을 선택할까

두 구현은 기능적으로 동일합니다. 로컬 벤치마크에서 Go 빌드는 약 4배 더 빠르게 시작되었고(콜드 스타트 ~21ms vs ~80ms) 메모리는 약 6배 적게 사용했습니다. 요청당 지연 시간은 GoCD 네트워크 왕복이 지배적이어서 동일했습니다. 세션마다 생성되는 서버에는 Go 바이너리나 Docker 이미지를 선호하고, 설치 없이 실행하고 이미 Node가 있다면 npx를 선호하세요.

레이아웃

gocd-mcp/
├── go/            Go implementation (main.go, internal/gocd)
├── ts/            TypeScript implementation (src/server.ts source; publishes as compiled dist/server.js)
├── Dockerfile     builds the Go binary into a distroless image
├── .goreleaser.yaml + .github/workflows/release.yml   prebuilt binaries + ghcr image on tag
└── server.json    MCP Registry manifest