LINSTOR MCP Server

linstor-mcp-server is a Go MCP server for LINSTOR and the Piraeus operator. It exposes canonical inventory reads plus a staged cluster-configuration write flow designed for stateful infrastructure: plan first, review the diff, then apply only while the target state is still fresh.

Desired state comes from piraeus.io/v1 CRDs. Runtime state comes from the LINSTOR controller API.

Installation

Via npm (no Go required, Linux/macOS, amd64/arm64):

npx linstor-mcp

Note: npm and binary installs become available only after the automated release pipeline has published the first tagged release.

Download binary (Linux/macOS, amd64/arm64):

Download the latest release from GitHub Releases, extract it, and place linstor-mcp-server in your $PATH.

Build from source (requires Go 1.26.2):

git clone https://github.com/Nosmoht/linstor-mcp-server
cd linstor-mcp-server
make build

Supported Versions

Pinned and currently validated:

• Go 1.26.2
• Go toolchain go1.26.2
• MCP Go SDK v1.5.0
• Kubernetes client libraries v0.35.3
• SQLite driver modernc.org/sqlite v1.48.1
• Acceptance cluster:
  • Kubernetes v1.35.0
  • Piraeus operator v2.10.4
  • LINSTOR server v1.33.1
  • LINSTOR API 1.27.0
• Agent clients validated during development:
  • Codex CLI 0.118.0
  • Claude Code 2.1.97

Configuration

The built-in homelab profile is the default. Configuration precedence is:

flags > env > config file > built-in profile defaults

Optional config.toml:

profile = "homelab"
kube_context = "admin@homelab"
linstor_cluster = "homelab"
controller_mode = "port-forward"
controller_service = "linstor-controller"
controller_namespace = "piraeus-datastore"
tls_ca_secret = "linstor-api-tls"
tls_client_secret = "linstor-client-tls"
state_dir = "~/.local/state/linstor-mcp-server"
http_addr = ""
enable_http_beta = false
log_format = "text"

Environment overrides:

... View full README on GitHub