Skip to main content
Glama

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, sodass npx keinen 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

gocd_dashboard

Dashboard-Status. Ohne Argumente = Zusammenfassung; filter/status/detail ermöglichen Drill-down

gocd_pipeline_status

Pausiert / gesperrt / planbar für eine Pipeline

gocd_pipeline_instance

Ein Lauf: Stufen mit Ergebnis pro Job, plus Auslöser

gocd_pipeline_history

Letzte Läufe für eine Pipeline. Optional limit

gocd_stage_instance

Ein Stufenlauf mit Status pro Job und Agent

gocd_stage_history

Letzte Läufe einer Stufe

gocd_compare

Was sich zwischen zwei Läufen geändert hat: Commits pro Material

gocd_list_artifacts

Die Artefaktdateien eines Jobs als [path, url]

gocd_get_artifact

Eine Artefaktdatei, am Ende gekappt (cap_kb), um den Kontext schlank zu halten

gocd_list_agents

Build-Agents und Status. Optional filter, limit

gocd_get_agent

Ein Agent per UUID

gocd_materials

Konfigurierte Materialien. Optional filter

gocd_environments

Umgebungen und ihre Pipeline-/Variablen-Anzahl

gocd_pipeline_groups

Pipeline-Gruppen. Filtern, um die Pipelines einer Gruppe aufzulisten

gocd_server_health

Server-Statusmeldungen, nach Schweregrad gezählt

gocd_version

GoCD-Serverversion

Schreib-Tools (Operationen):

Tool

Was es tut

gocd_trigger_pipeline

Einen Pipeline-Lauf auslösen

gocd_pause_pipeline

Eine Pipeline pausieren

gocd_unpause_pipeline

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-mcp

Verö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-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

Um den TypeScript-Quellcode während der Entwicklung direkt auszuführen (Node >= 22.6, nutzt Type-Stripping):

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

Welche 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 manifest

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents and external systems to programmatically trigger and monitor Jenkins jobs, retrieve build status and logs via MCP standards.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides 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