Talos MCP Server
A Model Context Protocol server for Talos Linux cluster operations — one thin tool, typed actions, zero runtime dependencies.
Companion to virtualbox-mcp-server: that server provisions the nodes, this one turns them into a Kubernetes cluster.
Design
One tool (talos) with typed actions for the cluster hot path — no CLI syntax needed:
| Action | Does |
|---|---|
gen_config | Generate cluster config + talosconfig (cluster, endpoint, optional output_dir) |
apply_config | Apply machine config to a node (node, file, insecure for maintenance mode) |
bootstrap | Bootstrap etcd on the control plane (once per cluster) |
kubeconfig | Retrieve the cluster kubeconfig |
health | Cluster health validation |
config_merge | Merge a talosconfig context (never overwrites ~/.talos/config) |
version | Client or node version |
run | Raw talosctl argv for the long tail (etcd, logs, reboot, upgrade…) |
resolve | Report platform/install state without downloading or running |
Backend: talosctl — the official gRPC client of the Talos machine API. An existing PATH install is always preferred; otherwise the correct binary for the host's OS/architecture is auto-installed from the official Sidero release, verified against GitHub's asset digest.
The full cluster recipe ships to clients in the MCP initialize handshake, so a fresh session can bring up a cluster without external knowledge.
Prerequisites
None beyond a hypervisor for the nodes. The server is a single Go binary; talosctl is auto-installed if absent.
Installing
Published on the official MCP Registry
as io.github.bryanjbelanger/talos-mcp-server — that name is what
registry-aware clients install by
(current entry).
For hosts that support MCP Bundles, download the .mcpb from the
latest release
and open it. One bundle covers every platform; it carries a binary per
(os, arch) and picks one at startup. The server needs no configuration —
guest credentials and endpoints are per-call parameters, and talosctl is
auto-installed on first use if the host has none.
Otherwise take the bare binary for your platform from the same release, or build it:
go build -o talos-mcp-server .
Registration with Claude Code
claude mcp add --scope user talos -- /path/to/talos-mcp-server
Verify with claude mcp list (✔ Connected), then restart the session.
Bundled skill
skills/talos-cluster — the end-to-end procedure: provision nodes via the virtualbox MCP server, configure and bootstrap via this one. Install by copying (or symlinking) into ~/.claude/skills/.
License
MIT