Spinnaker
MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management
Que pouvez-vous faire avec Spinnaker ?
- Applications and pipelines: list, read, trigger, save, update and delete pipelines, with revision history.
- Executions: list, search by trigger type, time range and status, cancel, pause, resume, restart a stage, evaluate SpEL.
- Deployment strategies: list, save and delete.
- Infrastructure: server groups, load balancers, clusters, firewalls, instances and console output, images, networks, subnets, accounts.
- Orchestration task status (deploy, resize, rollback).
- Bearer token, basic auth, x509 client certificate, or the session cookie of a Gate behind SSO (
spinnaker-mcp login). - stdio or HTTP transport; HTTP binds to
127.0.0.1by default. - Ships as an npm package (
npx spinnaker-mcp), a Docker image and multi-arch Go binaries.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
spinnaker-mcpclaude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- npx -y spinnaker-mcp@0.4.0
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": [
"-y",
"spinnaker-mcp@0.4.0"
],
"env": {
"GATE_URL": "<GATE_URL>",
"GATE_TOKEN": "<your gate_token>",
"GATE_USER": "<GATE_USER>",
"GATE_PASS": "<your gate_pass>",
"GATE_COOKIE": "<your gate_cookie>",
"GATE_COOKIE_FILE": "<GATE_COOKIE_FILE>",
"GATE_CERT_FILE": "<GATE_CERT_FILE>",
"GATE_KEY_FILE": "<GATE_KEY_FILE>",
"GATE_INSECURE": "false",
"TOOLSETS": "readonly"
}
}
}
}
Variables d'environnement
GATE_URLobligatoire Spinnaker Gate API URL (e.g. https://spin-gate.example.com)GATE_TOKENsecret Bearer token for GateGATE_USERBasic auth username (alternative to a token)GATE_PASSsecret Basic auth passwordGATE_COOKIEsecret SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' onceGATE_COOKIE_FILEFile holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)GATE_CERT_FILEx509 client certificate (PEM); needs GATE_KEY_FILEGATE_KEY_FILEx509 client key (PEM); needs GATE_CERT_FILEGATE_INSECURESkip TLS certificate verification of Gate (testing only)TOOLSETSTool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines
drumsergio/spinnaker-mcp:v0.4.0claude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- docker run -i --rm drumsergio/spinnaker-mcp:v0.4.0
{
"mcpServers": {
"spinnaker": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"drumsergio/spinnaker-mcp:v0.4.0"
],
"env": {
"GATE_URL": "<GATE_URL>",
"GATE_TOKEN": "<your gate_token>",
"GATE_USER": "<GATE_USER>",
"GATE_PASS": "<your gate_pass>",
"GATE_COOKIE": "<your gate_cookie>",
"GATE_COOKIE_FILE": "<GATE_COOKIE_FILE>",
"GATE_CERT_FILE": "<GATE_CERT_FILE>",
"GATE_KEY_FILE": "<GATE_KEY_FILE>",
"GATE_INSECURE": "false",
"TOOLSETS": "readonly"
}
}
}
}
Variables d'environnement
GATE_URLobligatoire Spinnaker Gate API URL (e.g. https://spin-gate.example.com)GATE_TOKENsecret Bearer token for GateGATE_USERBasic auth username (alternative to a token)GATE_PASSsecret Basic auth passwordGATE_COOKIEsecret SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' onceGATE_COOKIE_FILEFile holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)GATE_CERT_FILEx509 client certificate (PEM); needs GATE_KEY_FILEGATE_KEY_FILEx509 client key (PEM); needs GATE_CERT_FILEGATE_INSECURESkip TLS certificate verification of Gate (testing only)TOOLSETSTool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
spinnaker-mcp
A bridge that exposes any Spinnaker instance as an MCP server via the Gate API, written in Go.
It gives an LLM 37 tools to read and operate Spinnaker: applications, pipelines, executions, strategies and infrastructure.
Features
- Applications and pipelines: list, read, trigger, save, update and delete pipelines, with revision history.
- Executions: list, search by trigger type, time range and status, cancel, pause, resume, restart a stage, evaluate SpEL.
- Deployment strategies: list, save and delete.
- Infrastructure: server groups, load balancers, clusters, firewalls, instances and console output, images, networks, subnets, accounts.
- Orchestration task status (deploy, resize, rollback).
- Bearer token, basic auth, x509 client certificate, or the session cookie of a Gate behind SSO (
spinnaker-mcp login). - stdio or HTTP transport; HTTP binds to
127.0.0.1by default. - Ships as an npm package (
npx spinnaker-mcp), a Docker image and multi-arch Go binaries.
Quick start
Add the server to your MCP client (Claude Code, Claude Desktop, Cursor):
{
"mcpServers": {
"spinnaker": {
"command": "npx",
"args": ["-y", "spinnaker-mcp"],
"env": { "GATE_URL": "https://spin-gate.example.com", "GATE_TOKEN": "your-token-here" }
}
}
}
Needs Node 18 or newer; the npm package runs the Go binary over stdio. Docker, local builds and the other credentials are in Getting started.
A variable whose value is only an unexpanded placeholder, such as ${GATE_TOKEN}, counts as unset.
Documentation
The full documentation is at geiserx.github.io/spinnaker-mcp.
- Getting started: npm, Docker, Helm, local build, and the client configuration
- Configuration: every environment variable, the read-only toolset, the HTTP endpoints
- Usage: the 37 tools and which ones change Spinnaker, the 10 resources, the 5 prompts
- Development: testing, contributing, credits
- Related projects: the other MCP servers and the registry listings
License
Questions fréquentes
Qu'est-ce que Spinnaker ?
MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management
Comment installer Spinnaker ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add spinnaker -e 'GATE_URL=<GATE_URL>' -e 'GATE_TOKEN=<your gate_token>' -e 'GATE_USER=<GATE_USER>' -e 'GATE_PASS=<your gate_pass>' -e 'GATE_COOKIE=<your gate_cookie>' -e 'GATE_COOKIE_FILE=<GATE_COOKIE_FILE>' -e 'GATE_CERT_FILE=<GATE_CERT_FILE>' -e 'GATE_KEY_FILE=<GATE_KEY_FILE>' -e 'GATE_INSECURE=false' -e 'TOOLSETS=readonly' -- npx -y spinnaker-mcp@0.4.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Spinnaker ?
Oui. Il attend GATE_URL, GATE_TOKEN, GATE_PASS, GATE_COOKIE, à renseigner dans sa configuration.
Spinnaker est-il open source ?
Oui. Son code est sur GitHub sous licence GPL-3.0.
Qui maintient Spinnaker ?
Il est publié par GeiserX. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.