gocd-mcp
gocd-mcp
Ein MCP-Server für GoCD. Er stellt die REST-API von GoCD als MCP-Tools bereit, sodass jeder MCP-Client (Claude Code, Claude Desktop, Cursor) den Pipeline-Status lesen und Pipelines steuern kann. Hier gibt es zwei Implementierungen, die sich im Netzwerkverkehr identisch verhalten: Wählen Sie diejenige, die zu Ihrer gewünschten Installationsweise passt.
go/— Go-Implementierung. Wird als einzelnes statisches Binary oder als Docker-Image ausgeliefert. Schneller Kaltstart, geringer Speicherverbrauch.ts/— TypeScript-Implementierung. Läuft auf Node ohne Abhängigkeiten, sodassnpxkeinen Build-Schritt benötigt.
Beide liefern dieselbe kontextsparsame Ausgabe: Das Dashboard wird standardmäßig zusammengefasst, Zeilen sind spaltenorientiert und Antworten sind kompaktes JSON. Ein vollständiges GoCD-Dashboard umfasst über viele Pipelines hinweg mehrere MB; diese Tools reduzieren es auf das, was das Modell benötigt.
Tools
Lese-Tools (sicher):
Tool | Was es tut |
| Dashboard-Status. Ohne Argumente = Zusammenfassung; |
| Pausiert / gesperrt / planbar für eine Pipeline |
| Ein Lauf: Stufen mit Ergebnis pro Job, plus Auslöser |
| Letzte Läufe für eine Pipeline. Optional |
| Ein Stufenlauf mit Status pro Job und Agent |
| Letzte Läufe einer Stufe |
| Was sich zwischen zwei Läufen geändert hat: Commits pro Material |
| Die Artefaktdateien eines Jobs als |
| Eine Artefaktdatei, am Ende gekappt ( |
| Build-Agents und Status. Optional |
| Ein Agent per UUID |
| Konfigurierte Materialien. Optional |
| Umgebungen und ihre Pipeline-/Variablen-Anzahl |
| Pipeline-Gruppen. Filtern, um die Pipelines einer Gruppe aufzulisten |
| Server-Statusmeldungen, nach Schweregrad gezählt |
| GoCD-Serverversion |
Schreib-Tools (Operationen):
Tool | Was es tut |
| Einen Pipeline-Lauf auslösen |
| Eine Pipeline pausieren |
| Eine Pipeline fortsetzen |
Mit GOCD_READONLY=1 werden die drei Schreib-Tools ausgeblendet. Große Auflistungen (dashboard, pipeline_groups, materials, environments) werden zusammengefasst oder sind filterbar, sodass der rohe, mehrere MB große Inhalt nie in den Kontext des Modells gelangt.
Related MCP server: Jenkins MCP Proxy
Konfiguration
Zwei Umgebungsvariablen, beide erforderlich:
GOCD_BASE_URL=https://gocd.example.com
GOCD_ACCESS_TOKEN=<personal access token>GOCD_BASE_URL ist der reine Host ohne ein nachgestelltes /go. Die Tools hängen /go/api/... selbst an. Erstellen Sie das Token in GoCD in Ihrem Profil unter „Persönliche Zugriffstokens“.
Installation
npx (Node >= 18), empfohlen
Keine Installation, nichts zu bauen. Dies ist der einfachste Weg, den Server auszuführen:
claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- npx -y gocd-mcpVeröffentlicht auf npm als gocd-mcp und im MCP-Registry als io.github.Sahilll15/gocd, sodass Registry-fähige Clients es über den Namen finden können.
Go-Binary
Laden Sie ein vorgefertigtes Binary von Releases herunter, oder bauen Sie es selbst:
cd go && go build -o gocd-mcp .Registrieren Sie es:
claude mcp add gocd -e GOCD_BASE_URL=... -e GOCD_ACCESS_TOKEN=... -- /path/to/gocd-mcpDocker
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-mcpUm den TypeScript-Quellcode während der Entwicklung direkt auszuführen (Node >= 22.6, nutzt Type-Stripping):
cd ts && node --experimental-strip-types src/server.tsWelche Variante
Sie sind funktional identisch. In einem lokalen Benchmark startete der Go-Build etwa 4-mal schneller (~21ms vs. ~80ms Kaltstart) und verbrauchte etwa 6-mal weniger Speicher; die Latenz pro Anfrage war gleichauf, da der Netzwerk-Round-Trip zu GoCD dominiert. Bevorzugen Sie für einen pro Sitzung gestarteten Server das Go-Binary oder das Docker-Image; bevorzugen Sie npx, wenn Sie den Weg ohne Installation möchten und bereits Node haben.
Layout
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 manifestThis server cannot be deployed
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
GitLab MCP — wraps the GitLab REST API v4 (BYO API key)
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Manage Pipefork API projects, drafts, connections, secrets, and deployments through MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Jenkins CI/CD integration with job management, pipeline monitoring, artifact handling, and batch operations via MCP.26 npm4Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI agents and external systems to programmatically trigger and monitor Jenkins jobs, retrieve build status and logs via MCP standards.-
- AlicenseNot gradedqualityBmaintenanceEnables agents to inspect repositories, manage Golden Packs, plan golden flows, and run asynchronous validation tasks over MCP, providing a deterministic foundation for project-specific workflows.MIT
- AlicenseNot gradedqualityCmaintenanceProvides a runtime-only MCP server and REST API for datasets, connections, flows, pipelines, and cron scheduling, without server-side LLM execution or entity-authoring admin UI, enabling clients to operate and manage these resources programmatically.Apache 2.0