talos-mcp-server

Talos MCP 服务

用于 Talos Linux 集群操作的模型上下文协议服务——一个轻量工具、类型化操作、零运行时依赖。

与 virtualbox-mcp-server 配套使用：该服务负责创建节点，本服务则将它们组成 Kubernetes 集群。

设计

一个工具（talos），包含适用于集群关键操作路径的类型化操作——无需 CLI 语法：

操作	功能
gen_config	生成集群配置和 talosconfig（cluster、endpoint、可选的 output_dir）
apply_config	将机器配置应用到节点（node、file，以及用于维护模式的 insecure）
bootstrap	在控制平面上引导 etcd（每个集群执行一次）
kubeconfig	获取集群 kubeconfig
health	验证集群健康状况
config_merge	合并 talosconfig 上下文（绝不覆盖 ~/.talos/config）
version	客户端或节点版本
run	用于处理其他操作（etcd、日志、重启、升级……）的原始 talosctl argv
resolve	报告平台／安装状态，不下载或运行任何内容

后端：talosctl——Talos 机器 API 的官方 gRPC 客户端。始终优先使用 PATH 中已有的安装；否则会从官方 Sidero 版本自动安装适用于主机操作系统／架构的二进制文件，并根据 GitHub 的资源摘要进行验证。

完整的集群操作流程会在 MCP 初始化握手时发送给客户端，因此新会话无需外部知识即可启动集群。

先决条件

除节点所需的虚拟机监控程序外，无其他要求。本服务是一个 Go 单文件二进制程序；如果尚未安装 talosctl，会自动安装。

安装

已发布到官方 MCP 注册表， 名称为 io.github.bryanjbelanger/talos-mcp-server——支持注册表的客户端会使用此名称进行安装 （当前条目）。

对于支持 MCP Bundles 的主机，请从 最新版本 下载 .mcpb 并打开。一个捆绑包适用于所有平台；它包含各 （os、arch）对应的二进制文件，并在启动时选择其中一个。本服务无需配置—— 来宾凭据和端点均为每次调用的参数；如果主机上没有 talosctl， 首次使用时会自动安装。

否则，请从同一版本中下载适用于你平台的独立二进制文件，或 自行构建：

go build -o talos-mcp-server .

在 Claude Code 中注册

claude mcp add --scope user talos -- /path/to/talos-mcp-server

运行 claude mcp list（显示 ✔ Connected）进行验证，然后重启会话。

捆绑技能

skills/talos-cluster——端到端操作流程：通过 virtualbox MCP 服务创建节点，再通过本服务进行配置和引导。将其复制（或创建符号链接）到 ~/.claude/skills/ 即可安装。

许可证

MIT