Getting started¶
Needs a reachable Spinnaker Gate URL and, for the npm package, Node 18 or newer.
npm (stdio transport)¶
Or install globally:
The first run downloads the pre-built Go binary for your platform from the GitHub release, refuses it unless its SHA-256 matches the checksums.txt shipped in the package, and runs it with stdio transport. Install scripts are not needed, so it also works with --ignore-scripts.
Docker¶
docker run -i --rm -e GATE_URL=http://spin-gate:8084 -e TRANSPORT=stdio drumsergio/spinnaker-mcp:v0.4.0
Image tags carry the v prefix (v0.4.0). -i keeps stdin open, which the stdio transport needs.
Local build¶
git clone https://github.com/GeiserX/spinnaker-mcp
cd spinnaker-mcp
cp .env.example .env && $EDITOR .env
SPINNAKER_MCP_ENV_FILE=.env go run ./cmd/server
Kubernetes (Helm)¶
The chart is in the repository, not in a Helm repository, so install it from a checkout:
git clone https://github.com/GeiserX/spinnaker-mcp
kubectl create secret generic spinnaker-mcp-auth --from-literal=MCP_AUTH_TOKEN="$(openssl rand -hex 32)"
helm install spinnaker-mcp ./spinnaker-mcp/helm/spinnaker-mcp \
--set gate.url=http://spin-gate:8084 \
--set gate.auth.existingSecret=spinnaker-mcp-gate \
--set mcpAuth.existingSecret=spinnaker-mcp-auth
spinnaker-mcp-gate is a Secret you create with a GATE_TOKEN key, or GATE_USER and GATE_PASS. Without
it, gate.auth.type (token or basic) with gate.auth.token or gate.auth.user and gate.auth.pass
makes the chart create one. For an x509 client certificate, gate.tls.certSecret names a Secret with
tls.crt and tls.key. The pod runs the HTTP transport on port 8085
behind a ClusterIP Service, with liveness on /healthz and readiness on /readyz, and the image tag
defaults to v plus the chart's appVersion (v0.4.0). It listens on 0.0.0.0 inside the pod, so the chart
refuses to render without mcpAuth.existingSecret (a Secret with an MCP_AUTH_TOKEN key) or
mcpAuth.token: every /mcp request must carry that token as a bearer token. The chart registers only the
read tools; set toolsets=all only if the clients must change things, and still limit who reaches the Service.
Claude Code / Claude Desktop configuration¶
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": ["-y", "spinnaker-mcp"],
"env": {
"GATE_URL": "https://spin-gate.example.com",
"GATE_TOKEN": "your-token-here"
}
}
}
}
See Configuration for the environment variables. Behind a single sign-on login Gate takes no
token: leave GATE_TOKEN out and run npx -y spinnaker-mcp login --gate=https://spin-gate.example.com once, see
Gate behind SSO.