【技术文档摘要】

您的Kubernetes舰队中央控制台 ✈️✈️

k8s_pilot 是一个轻量级的集中式控制平面服务器，用于同时管理多个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

使用

正常模式（完全访问）

# 以完全读写权限启动
uv run --with mcp[cli] mcp run k8s_pilot.py

只读模式（安全检查）

# 启动在只读模式下 - 只允许读取操作
uv run --with mcp[cli] python k8s_pilot.py --readonly

命令行选项

# 显示帮助
uv run --with mcp[cli] python k8s_pilot.py --help

只读模式

--readonly 标志启用一种安全模式，该模式阻止对您的Kubernetes集群进行任何写入操作。这非常适合：

• 集群检查，无需担心意外更改
• 审计场景，您需要查看但不能修改
• 学习环境，您希望安全地探索
• 生产监控，零风险的修改

受保护的操作（只读模式下被阻止）

• pod_create, pod_update, pod_delete
• deployment_create, deployment_update, deployment_delete
• service_create, service_update, service_delete
• configmap_create, configmap_update, configmap_delete
• secret_create, secret_update, secret_delete
• namespace_create, namespace_delete
• 所有其他创建/更新/删除操作

允许的操作（始终可用）

• pod_list, pod_detail, pod_logs
• deployment_list, deployment_get
• service_list, service_get
• configmap_list, configmap_get
• secret_list, secret_get
• namespace_list, namespace_get
• 所有其他列表/获取操作

在Claude Desktop中使用

使用此配置从Claude内部运行k8s_pilot MCP服务器：

{
  "mcpServers": {
    "k8s_pilot": {
      "command": "uv",
      "args": [
        "--directory",
        "<克隆仓库的实际路径>/k8s-pilot",
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "k8s_pilot.py"
      ]
    }
  }
}

对于只读模式，使用以下配置：

{
  "mcpServers": {
    "k8s_pilot_readonly": {
      "command": "uv",
      "args": [
        "--directory",
        "<克隆仓库的实际路径>/k8s-pilot",
        "run",
        "--with",
        "mcp[cli]",
        "python",
        "k_8s_pilot.py",
        "--readonly"
      ]
    }
  }
}

将 <克隆仓库的实际路径> 替换为您实际克隆仓库的目录。

场景

在pypy命名空间中使用nginx:latest镜像创建一个Deployment，并且创建一个连接到它的Service。

主要特性

多集群管理

• 无缝与多个Kubernetes集群交互
• 执行上下文感知操作
• 通过MCP提示轻松在集群之间切换

资源控制

• 查看、创建、更新、删除：
  • 部署、服务、Pod
  • 配置映射、秘密、入口
  • 有状态集、守护集
  • 角色、集群角色
  • 持久卷及声明

命名空间操作

• 创建/删除命名空间
• 列出命名空间中的所有资源
• 管理标签和资源配额

节点管理

• 查看节点详情和状况
• 封锁/解封、标记/污染节点
• 列出每个节点上的Pod

许可证

本项目根据MIT许可证发布。详情见LICENSE文件。