English Français العربية

Spinnaker

السجل الرسمي السحابة وDevOps

MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع 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.1 by default.
  • Ships as an npm package (npx spinnaker-mcp), a Docker image and multi-arch Go binaries.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package spinnaker-mcp
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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"
            }
        }
    }
}

متغيرات البيئة

  • GATE_URL إلزامي Spinnaker Gate API URL (e.g. https://spin-gate.example.com)
  • GATE_TOKEN سري Bearer token for Gate
  • GATE_USER Basic auth username (alternative to a token)
  • GATE_PASS سري Basic auth password
  • GATE_COOKIE سري SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' once
  • GATE_COOKIE_FILE File holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)
  • GATE_CERT_FILE x509 client certificate (PEM); needs GATE_KEY_FILE
  • GATE_KEY_FILE x509 client key (PEM); needs GATE_CERT_FILE
  • GATE_INSECURE Skip TLS certificate verification of Gate (testing only)
  • TOOLSETS Tool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines
OCI package drumsergio/spinnaker-mcp:v0.4.0
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' -- docker run -i --rm drumsergio/spinnaker-mcp:v0.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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"
            }
        }
    }
}

متغيرات البيئة

  • GATE_URL إلزامي Spinnaker Gate API URL (e.g. https://spin-gate.example.com)
  • GATE_TOKEN سري Bearer token for Gate
  • GATE_USER Basic auth username (alternative to a token)
  • GATE_PASS سري Basic auth password
  • GATE_COOKIE سري SESSION cookie of a Gate behind SSO (OAuth2, SAML); or run 'spinnaker-mcp login' once
  • GATE_COOKIE_FILE File holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)
  • GATE_CERT_FILE x509 client certificate (PEM); needs GATE_KEY_FILE
  • GATE_KEY_FILE x509 client key (PEM); needs GATE_CERT_FILE
  • GATE_INSECURE Skip TLS certificate verification of Gate (testing only)
  • TOOLSETS Tool groups to register. Default readonly; 'all' also registers the tools that trigger, cancel, edit, delete and judge pipelines

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. spinnaker-mcp
  2. Features
  3. Quick start
  4. Documentation
  5. License

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.1 by 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

GPL-3.0-or-later

الأسئلة الشائعة

ما هو Spinnaker؟

MCP server exposing Spinnaker CD platform via Gate API for pipeline and deployment management

كيف أثبّت Spinnaker؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Spinnaker إلى مفتاح API؟

نعم. يتطلب GATE_URL, GATE_TOKEN, GATE_PASS, GATE_COOKIE، وتضبطها في إعداداته.

هل Spinnaker مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.

من يصون Spinnaker؟

ينشره GeiserX. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.