Spinnaker

Name: Spinnaker
Author: GeiserX

本地服务

geiserx.github.io云与基础设施5今天更新

代码仓库访问官网

关于 Spinnaker

Spinnaker 是面向通过 Spinnaker 管理应用与部署的团队的 Go MCP 服务。它通过 Gate 连接 Spinnaker 实例，默认仅启用只读工具，写入操作需另行开启。

主要功能

01查看应用和流水线
02搜索并管理流水线执行
03读取部署与基础设施详情
04通过 TOOLSETS=all 启用写入工具
05使用 stdio 或 Streamable HTTP 连接

适用场景

01查看流水线执行状态
02检查集群和服务器组
03启用写入工具后触发或更新流水线
04部署操作期间核查基础设施详情

MCP 相关

Spinnaker 通过 Gate API 提供与 Spinnaker 实例交互的工具、资源和提示词，并支持 stdio 与无状态 Streamable HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "geiserx-spinnaker": {
      "command": "npx",
      "args": [
        "-y",
        "spinnaker-mcp"
      ],
      "env": {
        "GATE_URL": "<GATE_URL>",
        "GATE_TOKEN": "<GATE_TOKEN>",
        "GATE_USER": "<GATE_USER>",
        "GATE_PASS": "<GATE_PASS>",
        "GATE_COOKIE": "<GATE_COOKIE>",
        "GATE_COOKIE_FILE": "<GATE_COOKIE_FILE>",
        "GATE_CERT_FILE": "<GATE_CERT_FILE>",
        "GATE_KEY_FILE": "<GATE_KEY_FILE>",
        "GATE_INSECURE": "<GATE_INSECURE>",
        "TOOLSETS": "<TOOLSETS>"
      }
    }
  }
}

启动命令npx -y spinnaker-mcp

需要配置的环境变量

GATE_URLSpinnaker Gate API URL (e.g. https://spin-gate.example.com)

GATE_TOKEN密钥Bearer token for Gate

GATE_USERBasic 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_FILEFile holding that SESSION cookie (default: the file 'spinnaker-mcp login' writes)

GATE_CERT_FILEx509 client certificate (PEM); needs GATE_KEY_FILE

GATE_KEY_FILE密钥x509 client key (PEM); needs GATE_CERT_FILE

GATE_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

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmspinnaker-mcp0.4.0stdio

ocidrumsergio/spinnaker-mcp:v0.4.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

spinnaker-mcp

一个通过 Gate API 将任意 Spinnaker 实例接入为 MCP 服务的桥接工具，使用 Go 编写。

它为大模型提供 38 个工具，用于读取和操作 Spinnaker：应用、流水线、执行、策略和基础设施。默认只注册 27 个读取工具；设置 TOOLSETS=all 可添加另外 11 个变更类工具。

MCP Inspector 已连接到 spinnaker-mcp，并以 TOOLSETS=readonly 启动：列表中仅显示读取工具，且已选中 search_executions 及其参数

功能

应用和流水线：列出、读取、触发、保存、更新和删除流水线，并提供版本历史。
执行：列出执行记录；按流水线、触发类型、时间范围和状态搜索；读取精简摘要；批准或拒绝 Manual Judgment；取消、暂停、恢复、重启阶段、评估 SpEL。
部署策略：列出、保存和删除。
基础设施：服务器组、负载均衡器、集群、防火墙、实例和控制台输出、镜像、网络、子网、账户。
编排任务状态（部署、调整大小、回滚）。
支持 Bearer 令牌、基本身份验证、x509 客户端证书，或使用位于 SSO 后的 Gate 的会话 Cookie（spinnaker-mcp login）。
支持 MCP 2026-07-28 及更早版本，最低至 2024-11-05，并支持两种传输方式，当前和旧版客户端均可连接。
每个工具都有标题和全部四种注释提示；读取工具会返回带有架构的结构化输出。
支持 stdio 或无状态 Streamable HTTP。HTTP 绑定到 127.0.0.1；在其他地址使用时需要 Bearer 令牌（MCP_AUTH_TOKEN），并会拒绝跨站浏览器请求。
提供 npm 包（npx spinnaker-mcp）、Docker 镜像和多架构 Go 二进制文件。

快速开始

Claude Code：

claude mcp add spinnaker -e GATE_URL=https://spin-gate.example.com -e GATE_TOKEN=your-token-here -- npx -y spinnaker-mcp

Claude Desktop（claude_desktop_config.json）和 Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "spinnaker": {
      "command": "npx",
      "args": ["-y", "spinnaker-mcp"],
      "env": { "GATE_URL": "https://spin-gate.example.com", "GATE_TOKEN": "your-token-here" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "spinnaker": {
      "command": "npx",
      "args": ["-y", "spinnaker-mcp"],
      "env": { "GATE_URL": "https://spin-gate.example.com", "GATE_TOKEN": "your-token-here" }
    }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.spinnaker]
command = "npx"
args = ["-y", "spinnaker-mcp"]
env = { GATE_URL = "https://spin-gate.example.com", GATE_TOKEN = "your-token-here" }

在 env 中添加 "TOOLSETS": "all"，即可让助手触发、判定、取消或编辑。需要 Node 18 或更高版本；npm 包会在首次运行时为你的平台获取 Go 二进制文件，根据发布校验和进行校验，并通过 stdio 运行它。Docker、本地构建和其他凭据配置请参阅入门指南。

如果某个变量的值只是尚未展开的占位符（例如 ${GATE_TOKEN}），则视为未设置。