MCP Servers

spinnaker-mcp

MCP server bridging Spinnaker continuous delivery platform to LLMs for application, pipeline, and deployment management

README

<h1 align="center">Spinnaker-MCP</h1>

A bridge that exposes any Spinnaker instance as an MCP v1 server via the Gate API, written in Go.

What you get

Category	Tool	Description
Applications	`list_applications`	List all Spinnaker applications
	`get_application`	Get detailed application info (accounts, clusters, attributes)
Pipelines	`list_pipelines`	List pipeline configurations for an application
	`get_pipeline`	Get a specific pipeline's full configuration
	`trigger_pipeline`	Trigger a pipeline with optional parameters
	`save_pipeline`	Save/create a pipeline definition
	`update_pipeline`	Update an existing pipeline definition
	`delete_pipeline`	Delete a pipeline definition
	`get_pipeline_history`	Get revision history for a pipeline config
Executions	`list_executions`	List recent executions, filterable by status
	`get_execution`	Get full execution details (stages, outputs, timing)
	`search_executions`	Rich search by trigger type, time range, status
	`cancel_execution`	Cancel a running execution with optional reason
	`pause_execution`	Pause a running execution at the current stage
	`resume_execution`	Resume a paused execution
	`restart_stage`	Restart a failed stage within an execution
	`evaluate_expression`	Evaluate a SpEL expression against an execution
Strategies	`list_strategies`	List deployment strategy configurations
	`save_strategy`	Create or update a deployment strategy
	`delete_strategy`	Delete a deployment strategy
Infrastructure	`list_server_groups`	List server groups (deployment targets) with instance counts
	`list_load_balancers`	List load balancers across all accounts and regions
	`list_clusters`	List cluster names grouped by account
	`get_cluster`	Get cluster details including server groups
	`get_scaling_activities`	Get scaling activities for a cluster
	`get_target_server_group`	Target-based server group lookup (newest, oldest, etc.)
	`list_firewalls`	List all firewalls/security groups across accounts
	`get_firewall`	Get firewall details by account, region, and name
	`get_instance`	Get instance details (health, metadata, launch time)
	`get_console_output`	Get instance console output for debugging
	`find_images`	Search for machine images by tags, region, account
	`get_image_tags`	List image tags for a repository
	`list_networks`	List VPCs/networks by cloud provider
	`list_subnets`	List subnets by cloud provider
	`list_accounts`	List all configured cloud accounts/credentials
	`get_account`	Get account details and permissions
Tasks	`get_task`	Get orchestration task status (deploy, resize, rollback)

Everything is exposed over JSON-RPC. LLMs and agents can: initialize -> listTools -> callTool and interact with your Spinnaker deployments.

Quick-start

npm (stdio transport)

npx spinnaker-mcp

Or install globally:

npm install -g spinnaker-mcp
spinnaker-mcp

This downloads the pre-built Go binary for your platform and runs it with stdio transport.

Docker

docker run --rm -e GATE_URL=http://spin-gate:8084 -e TRANSPORT=stdio drumsergio/spinnaker-mcp:0.3.1

Local build

git clone https://github.com/GeiserX/spinnaker-mcp
cd spinnaker-mcp

cp .env.example .env && $EDITOR .env

go run ./cmd/server

Configuration

Variable	Default	Description
`GATE_URL`	`http://localhost:8084`	Spinnaker Gate API endpoint (without trailing /)
`GATE_TOKEN`	(empty)	Bearer token for authentication
`GATE_USER`	(empty)	Basic auth username (alternative to token)
`GATE_PASS`	(empty)	Basic auth password
`GATE_CERT_FILE`	(empty)	Path to x509 client certificate (PEM)
`GATE_KEY_FILE`	(empty)	Path to x509 client key (PEM)
`GATE_INSECURE`	`false`	Skip TLS certificate verification
`TRANSPORT`	(empty = HTTP)	Set to `stdio` for stdio transport
`MCP_PORT`	`8085`	HTTP transport port (ignored when TRANSPORT=stdio)
`MCP_BIND_ADDR`	`127.0.0.1`	HTTP transport bind address (set to `0.0.0.0` to listen on all interfaces)

Authentication priority: Bearer token > Basic auth > x509 client cert > No auth.

Put them in a .env file (from .env.example) or set them in the environment.

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"
      }
    }
  }
}

Testing

go test -v -race ./...

Tested with Inspector. Before making a PR, make sure this MCP server behaves well via that tool.

Credits

Spinnaker -- open-source continuous delivery platform

MCP-GO -- Go MCP implementation

GoReleaser -- painless multi-arch releases

Maintainers

@GeiserX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

Spinnaker-MCP follows the Contributor Covenant Code of Conduct.

Other MCP Servers by GeiserX

genieacs-mcp -- TR-069 device management
cashpilot-mcp -- Passive income monitoring
duplicacy-mcp -- Backup health monitoring
lynxprompt-mcp -- AI configuration blueprints
pumperly-mcp -- Fuel and EV charging prices
telegram-archive-mcp -- Telegram message archive

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured