K8s Pilot

🚀 k8s-pilot-ci

k8s_pilot 是一個輕量級、集中式控制平面服務器，可作為您 Kubernetes 集群的中央控制檯，助力您管理多個 Kubernetes 集群。藉助強大的工具和直觀的 API，您能從一個控制檯同時觀察和管理所有集群。

🚀 快速開始

概覽

• 🔄 支持多集群上下文切換。
• 🔧 提供對大多數常見 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 提示輕鬆切換集群。

資源控制

可對以下資源進行查看、創建、更新、刪除操作：

• 部署、服務、Pods
• ConfigMaps、Secrets、Ingresses
• StatefulSets、DaemonSets
• Roles、ClusterRoles
• PersistentVolumes & Claims

命名空間操作

• 創建/刪除命名空間。
• 列出命名空間中的所有資源。
• 管理標籤和資源配額。

節點管理

• 查看節點詳細信息和狀態。
• 打結/解開、標記/汙損節點。
• 列出每個節點的 Pods