talos-mcp-server

Talos MCP サーバー

Talos Linux のクラスター運用向け Model Context Protocol サーバーです。薄型のツールが 1 つあり、アクションは型付けされ、ランタイム依存関係はありません。

virtualbox-mcp-server と連携します。前者のサーバーがノードをプロビジョニングし、こちらのサーバーがそれらを Kubernetes クラスターにします。

設計

クラスターの主要な操作向けに、型付けされたアクションを備えた 1 つのツール（talos）を提供します。CLI の構文は不要です。

アクション	内容
gen_config	クラスター設定と talosconfig を生成します（cluster、endpoint、任意の output_dir）
apply_config	ノードにマシン設定を適用します（node、file、メンテナンスモード用の insecure）
bootstrap	コントロールプレーン上で etcd をブートストラップします（クラスターごとに 1 回）
kubeconfig	クラスターの kubeconfig を取得します
health	クラスターの健全性を検証します
config_merge	talosconfig のコンテキストをマージします（~/.talos/config は上書きしません）
version	クライアントまたはノードのバージョンを取得します
run	低頻度の操作（etcd、ログ、再起動、アップグレードなど）向けに、生の talosctl argv を実行します
resolve	ダウンロードや実行をせずに、プラットフォームとインストールの状態を報告します

バックエンド： Talos マシン API の公式 gRPC クライアントである talosctl を使用します。PATH 上に既存のインストールがある場合は常にそちらを優先します。ない場合は、ホストの OS／アーキテクチャに適したバイナリを公式の Sidero リリースから自動インストールし、GitHub のアセットダイジェストと照合して検証します。

クラスター構築の手順一式は MCP の初期化ハンドシェイクでクライアントに送信されるため、新しいセッションでも外部の知識なしにクラスターを起動できます。

前提条件

ノード用のハイパーバイザー以外に必要なものはありません。サーバーは単一の Go バイナリで、talosctl が見つからない場合は自動インストールされます。

インストール

公式 MCP Registry に io.github.bryanjbelanger/talos-mcp-server として公開されています。レジストリ対応クライアントでは、この名前を使ってインストールします（現在のエントリー）。

MCP Bundles に対応するホストでは、最新リリースから .mcpb をダウンロードして開いてください。1 つのバンドルであらゆるプラットフォームに対応します。各（OS、アーキテクチャ）用のバイナリが含まれており、起動時に適切なものが選択されます。サーバーの設定は不要です。ゲストの認証情報とエンドポイントは呼び出しごとに指定し、ホストに 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