K8s Pilot

🚀 k8s-pilot

Kubernetesクラスタの中央コンソール ✈️✈️

k8s_pilot は、複数のKubernetesクラスタを管理するための軽量で集中型のコントロールプレーンサーバーです。
強力なツールと直感的なAPIを使って、1つのコンソールからすべてのクラスタを同時に監視および管理できます。

🚀 クイックスタート

k8s_pilot は、複数のKubernetesクラスタを管理するための軽量で集中型のコントロールプレーンサーバーです。強力なツールと直感的なAPIを使って、1つのコンソールからすべてのクラスタを同時に監視および管理できます。

✨ 主な機能

• 🔄 複数のクラスタコンテキストの切り替えをサポート
• 🔧 ほとんどの一般的なKubernetesリソースに対するCRUD（作成、読み取り、更新、削除）操作を提供
• ⚙️ MCP（Claude AIやその他のモデルをサポートするプロトコル）によって駆動されます。

📦 インストール

🧰 前提条件

• Python 3.13 以上
• uv パッケージマネージャー
• Kubernetesクラスタへのアクセス権限（~/.kube/config またはクラスタ内の設定）

# uvをインストールする（まだインストールされていない場合）

# MacOSの場合
brew install uv

# Linuxの場合
curl -LsSf https://astral.sh/uv/install.sh | sh

インストール手順

# リポジトリをクローンする
git clone https://github.com/bourbonkk/k8s-pilot.git
cd k8s-pilot

# uvとMCPを使用して起動する
uv run --with mcp[cli] mcp run k8s_pilot.py

Claude Desktopとの連携

以下の設定を使用して、Claudeでk8s_pilot MCPサーバーを実行します。

{
  "mcpServers": {
    "k8s_pilot": {
      "command": "uv",
      "args": [
        "--directory",
        "<クローンしたリポジトリの実際のパス>/k8s-pilot",
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "k8s_pilot.py"
      ]
    }
  }
}

<クローンしたリポジトリの実際のパス> を実際のディレクトリパスに置き換えてください。

シナリオ

pypy名前空間でnginx:latestイメージを使用するDeploymentを作成し、同時に接続するサービスを作成します。

主要機能

マルチクラスタ管理

• 複数のKubernetesクラスタとシームレスにやり取りできます。
• コンテキストを意識した操作を実行できます。
• MCPの指示を通じて簡単にクラスタを切り替えることができます。

リソース管理

• 以下のリソースの表示、作成、更新、削除が可能です。
  • デプロイメント、サービス、ポッド
  • ConfigMaps、Secrets、Ingresses
  • StatefulSets、DaemonSets
  • ロール、クラスタロール
  • 永続ボリュームとクレーム

名前空間操作

• 名前空間の作成と削除ができます。
• 名前空間内のすべてのリソースを一覧表示できます。
• ラベルとリソースクォータを管理できます。

ノード管理

• ノードの詳細情報と状態を表示できます。
• ノードのディレイン/アンディレイン、タメ/マークを行うことができます。
• 各ノードのポッドを一覧表示できます。