El Pilot Central per a les teves Flotes de Kubernetes ✈️✈️

k8s_pilot és un servidor de pla de control lleuger i centralitzat per gestionar múltiples clústers de Kubernetes a la vegada.
Amb eines potents i APIs intuïtives, pots observar i controlar tots els teus clústers des d’un sol cockpit.

🚀 Visió General

• 🔄 Suporta canvi de context multi-clúster
• 🔧 Permet operacions CRUD sobre la majoria de recursos comuns de Kubernetes
• 🔒 Mode només lectura per a una inspecció segura del clúster
• ⚙️ Impulsat per MCP per a Claude AI i més enllà

🧰 Requisits Prèvius

• Python 3.13 o superior
• uv gestor de paquets
• Accés als clústers de Kubernetes (~/.kube/config o configuració dins del clúster)

# Instal·la uv (si no està instal·lat)

# Per MacOS
brew install uv

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

Instal·lació

# Clona el repositori
git clone https://github.com/bourbonkk/k8s-pilot.git
cd k8s-pilot

# Llança amb uv + MCP
uv run --with mcp[cli] mcp run k8s_pilot.py

Ús

Mode Normal (Accés Complet)

# Inicia amb accés complet de lectura/escriptura
uv run --with mcp[cli] mcp run k8s_pilot.py

Mode Només Lectura (Inspecció Segura)

# Inicia en mode només lectura - només s'permeten operacions de lectura
uv run --with mcp[cli] python k8s_pilot.py --readonly

Opcions de Línia de Comando

# Mostra l'ajuda
uv run --with mcp[cli] python k8s_pilot.py --help

Mode Només Lectura

La bandera --readonly habilita un mode de seguretat que impedeix qualsevol operació d'escriptura als teus clústers de Kubernetes. És perfecte per a:

• Inspecció del clúster sense risc de canvis accidentals
• Escenaris d'auditoria on només es necessita veure però no modificar
• Entorns d'aprenentatge on es vol explorar de manera segura
• Monitorització de producció amb zero risc de modificacions

Operacions Protegides (Bloquejades en Mode Només Lectura)

• 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
• Totes les altres operacions de creació/actualització/eliminació

Operacions Permeses (Sempre Disponibles)

• 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
• Totes les altres operacions de llistat/obtenir

Ús amb Claude Desktop

Utilitza aquesta configuració per executar el servidor MCP k8s_pilot des de dins de Claude:

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

Per al mode només lectura, utilitza aquesta configuració:

{
  "mcpServers": {
    "k8s_pilot_readonly": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-cloned-repo>/k8s-pilot",
        "run",
        "--with",
        "mcp[cli]",
        "python",
        "k8s_pilot.py",
        "--readonly"
      ]
    }
  }
}

Reemplaça amb el directori real on has clonat el repositori.

Escenari

Crea un Deployment amb la imatge nginx:latest al namespace pypy, i també crea un Service que es connecti a ell.

Característiques Clau

Gestió Multi-Cluster

• Interactua sense interrucció amb múltiples clústers de Kubernetes
• Realitza operacions conscient del context
• Canvia fàcilment entre clústers mitjançant indicadors MCP

Control de Recursos

• Veure, crear, actualitzar, eliminar:
  • Deployments, Services, Pods
  • ConfigMaps, Secrets, Ingresses
  • StatefulSets, DaemonSets
  • Roles, ClusterRoles
  • PersistentVolumes & Claims

Operacions de Namespace

• Crear/eliminar namespaces
• Llistar tots els recursos dins d’un namespace
• Gestionar etiquetes i quotas de recursos

Gestió de Nodes

• Veure detalls i condicions dels nodes
• Cordon/uncordon, etiquetar/taint nodes
• Llistar pods per node

Licència

Aquest projecte està llicenciat sota la Llicència MIT. Consulta el fitxer LICENSE per a més detalls.