K8s Pilot

🚀 k8s-pilot

The central console for your Kubernetes clusters ✈️✈️

k8s_pilot is a lightweight, centralized control plane server designed to manage multiple Kubernetes clusters. With powerful tools and an intuitive API, you can observe and manage all clusters from a single console simultaneously.

🚀 Overview

• 🔄 Supports multi-cluster context switching
• 🔧 Provides Create, Read, Update, Delete (CRUD) operations for most common Kubernetes resources
• ⚙️ Powered by MCP (a support protocol for Claude AI and more models)

🧰 Prerequisites

• Python 3.13 or higher
• The uv package manager
• Access to a Kubernetes cluster (~/.kube/config or in-cluster configuration)

# Install uv (if not already installed)

# For MacOS
brew install uv

# For Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

📦 Installation

# Clone the repository
git clone https://github.com/bourbonkk/k8s-pilot.git
cd k8s-pilot

# Start with uv and MCP
uv run --with mcp[cli] mcp run k8s_pilot.py

💻 Usage Examples

Use with Claude Desktop

Run the k8s_pilot MCP server in Claude with the following configuration:

{
  "mcpServers": {
    "k8s_pilot": {
      "command": "uv",
      "args": [
        "--directory",
        "<Actual path of the cloned repository>/k8s-pilot",
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "k8s_pilot.py"
      ]
    }
  }
}

Replace <Actual path of the cloned repository> with the actual directory path.

Scenario Example

Create a Deployment using the nginx:latest image in the pypy namespace and create a connected service at the same time.

✨ Features

Multi-Cluster Management

• Interact seamlessly with multiple Kubernetes clusters
• Perform context-aware operations
• Easily switch clusters via MCP prompts

Resource Control

• View, create, update, and delete:
  • Deployments, Services, Pods
  • ConfigMaps, Secrets, Ingresses
  • StatefulSets, DaemonSets
  • Roles, ClusterRoles
  • PersistentVolumes & Claims

Namespace Operations

• Create/delete namespaces
• List all resources in a namespace
• Manage labels and resource quotas

Node Management

• View node details and status
• Cordon/uncordon, label/taint nodes
• List Pods on each node