gocd-mcp

GoCD 用の MCP サーバーです。GoCD の REST API を MCP ツールとして公開し、任意の MCP クライアント（Claude Code、Claude Desktop、Cursor）からパイプラインの状態を読み取ったり、パイプラインを操作したりできます。ここには 2 つの実装があり、ネットワーク上では同じように動作します。インストール方法に合わせてどちらかを選んでください。

• go/ — Go 実装。単一の静的バイナリまたは Docker イメージとして配布されます。コールドスタートが速く、メモリ消費も少ないです。

• ts/ — TypeScript 実装。依存関係なしで Node 上で動作するため、npx にビルドステップは不要です。

どちらも同じコンテキスト節約型の出力を返します。ダッシュボードはデフォルトで要約され、行は列指向で、レスポンスはコンパクトな JSON です。完全な GoCD ダッシュボードは多数のパイプラインにまたがって数 MB に達しますが、これらのツールはモデルが必要とする分だけに切り詰めます。

ツール

読み取りツール（安全）:

書き込みツール（操作）:

GOCD_READONLY=1 を設定すると、3 つの書き込みツールを非表示にできます。大きな一覧（dashboard、pipeline_groups、materials、environments）は要約またはフィルタ可能なので、生の数 MB のボディがモデルのコンテキストにそのまま流れ込むことはありません。

Related MCP server: Jenkins MCP Proxy

設定

必須の環境変数は次の 2 つです:

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。型ストリッピングを使用）:

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

どちらを選ぶか

機能的には同一です。ローカルベンチマークでは、Go ビルドは約 4 倍速く起動し（コールドスタート約 21ms 対約 80ms）、メモリ使用量は約 6 分の 1 でした。リクエストごとのレイテンシは、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