Spinnaker

spinnaker-mcp

Go で書かれた、Gate API を介してあらゆる Spinnaker インスタンスを MCP サーバーとして公開するブリッジです。

LLM に、アプリケーション、パイプライン、実行、戦略、インフラストラクチャを読み取り、操作するための 38 個のツールを提供します。デフォルトでは読み取り専用の 27 個のツールだけが登録され、TOOLSETS=all を設定すると、変更を行う 11 個のツールが追加されます。

主な機能

• アプリケーションとパイプライン：一覧表示、読み取り、トリガー、保存、更新、削除、およびリビジョン履歴の確認。
• 実行：パイプライン、トリガーの種類、期間、ステータスによる一覧表示と検索、概要の読み取り、Manual Judgment の承認または却下、キャンセル、一時停止、再開、ステージの再起動、SpEL の評価。
• デプロイ戦略：一覧表示、保存、削除。
• インフラストラクチャ：サーバーグループ、ロードバランサー、クラスター、ファイアウォール、インスタンスとコンソール出力、イメージ、ネットワーク、サブネット、アカウント。
• オーケストレーションタスクのステータス（デプロイ、サイズ変更、ロールバック）。
• ベアラートークン、Basic 認証、x509 クライアント証明書、または SSO の背後にある Gate のセッションクッキー（spinnaker-mcp login）。
• MCP 2026-07-28 と、それ以前の 2024-11-05 までのすべてのバージョンに両方のトランスポートで対応しているため、最新のクライアントも古いクライアントも接続できます。
• すべてのツールにタイトルと 4 種類すべてのアノテーションヒントがあり、読み取りツールはスキーマ付きの構造化出力を返します。
• stdio またはステートレスな Streamable HTTP に対応します。HTTP は 127.0.0.1 にバインドされます。それ以外の場所で使用するにはベアラートークン（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、ローカルビルド、その他の認証情報については、Getting startedをご覧ください。

${GATE_TOKEN} のように、展開されていないプレースホルダーだけを値とする変数は、未設定として扱われます。

ドキュメント

ドキュメント全文はgeiserx.github.io/spinnaker-mcpでご覧いただけます。

• はじめに：npm、Docker、Helm、ローカルビルド、クライアントの設定
• 設定：すべての環境変数、読み取り専用ツールセット、HTTP エンドポイント
• 使い方：38 個のツールと Spinnaker を変更するもの、10 個のリソース、5 個のプロンプト
• 開発：テスト、コントリビューション、クレジット
• 関連プロジェクト：その他の MCP サーバーとレジストリへの掲載情報

ライセンス

GPL-3.0-or-later