Talos Mcp Server

io.github.bryanjbelanger由 GitHub 帳號 bryanjbelanger 發布v1.1.2更新於 Oct 24, 2026

Talos Linux cluster operations as one thin MCP tool over the official machine API.

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓助理透過 talosctl 為 Talos Linux 叢集產生設定、套用設定、引導 etcd 並檢查健康狀態。

可以做什麼
產生叢集設定與 talosconfig，並合併 talosconfig 內容而不覆寫預設設定檔。將機器設定套用到節點（含維護模式），並在控制平面引導 etcd。取得叢集 kubeconfig 並驗證叢集健康狀態。回報用戶端或節點版本，以及平台與安裝狀態，且不下載或執行任何內容。執行原始 talosctl 參數，用於 etcd、日誌、重新開機和升級等長尾操作。
適用情境
適合在助理工作階段中建置或維運 Talos Linux Kubernetes 叢集，尤其是搭配負責建立節點的虛擬機管理伺服器使用。也適合希望使用具型別的叢集操作、而不必記住 talosctl 語法的使用者。
執行需求
在桌面上以本機程序執行；為單一 Go 二進位檔或 MCP 套件，未宣告環境變數或驗證。後端使用 talosctl：優先使用 PATH 中既有的安裝，否則從官方發行自動安裝相符的二進位檔。節點憑證與端點依每次呼叫傳入。節點需要虛擬機管理程式。
安裝前請注意
這些操作會變更真實基礎設施：套用機器設定、引導 etcd 以及重新開機、升級等原始 talosctl 指令可能改變或中斷叢集。首次使用時伺服器可能從網際網路下載並安裝 talosctl。叢集憑證與端點依每次呼叫傳入，需謹慎處理。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Talos Mcp Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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:

ActionDoes
gen_configGenerate cluster config + talosconfig (cluster, endpoint, optional output_dir)
apply_configApply machine config to a node (node, file, insecure for maintenance mode)
bootstrapBootstrap etcd on the control plane (once per cluster)
kubeconfigRetrieve the cluster kubeconfig
healthCluster health validation
config_mergeMerge a talosconfig context (never overwrites ~/.talos/config)
versionClient or node version
runRaw talosctl argv for the long tail (etcd, logs, reboot, upgrade…)
resolveReport 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:

bash
go build -o talos-mcp-server .

Registration with Claude Code

bash
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

來源：README.md，提交 5fb6e38

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。