k8s_pilot is a lightweight, centralized control plane server for managing multiple Kubernetes clusters at once.
With powerful tools and intuitive APIs, you can observe and control all your clusters from one cockpit.
Kubernetes Control Plane Server for Managing Multiple Clusters – the central pilot for your k8s fleets✈️✈️
Звёзды
14
Инструменты
—
Аптайм
—
🚀 Overview
🔄 Supports multi-cluster context switching
🔧 Enables CRUD operations on most common Kubernetes resources
Access to Kubernetes clusters (~/.kube/config or in-cluster config)
# Install uv (if not 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
# Launch with uv + MCP
uv run --with "mcp[cli]>=1.28.0,<2" python k8s_pilot.py
🆕 What's New in v2.0
Streamable HTTP Transport: Remote cluster management via HTTP (in addition to stdio)
MCP Prompts: Built-in prompt templates for common K8s operations
Context-aware Logging: Write operations now report progress via MCP context
Bug Fixes: Fixed missing API clients for Ingress and RBAC resources
Security: Added readonly checks for node modification operations
Dockerfile: Modernized with uv package manager for faster builds
Usage
Normal Mode (Full Access)
# Start with full read/write access
uv run --with "mcp[cli]>=1.28.0,<2" python k8s_pilot.py
Readonly Mode (Safe Inspection)
# Start in readonly mode - only read operations allowed
uv run --with "mcp[cli]>=1.28.0,<2" python k8s_pilot.py --readonly
Streamable HTTP Mode (Remote Access)
# Start with Streamable HTTP transport for remote access
uv run --with "mcp[cli]>=1.28.0,<2" python k8s_pilot.py --transport streamable-http
Command Line Options
# Show help
uv run --with "mcp[cli]>=1.28.0,<2" python k8s_pilot.py --help
Run via Docker
You can run k8s-pilot directly using the published Docker image without installing uv locally.
Make sure to mount your ~/.kube/config so the container can access your clusters.
docker run -i --rm \
-v ~/.kube/config:/root/.kube/config \
ghcr.io/bourbonkk/k8s-pilot:latest
Readonly Mode
The --readonly flag enables a safety mode that prevents any write operations to your Kubernetes clusters. This is perfect for:
Cluster inspection without risk of accidental changes
Audit scenarios where you need to view but not modify
Learning environments where you want to explore safely
Production monitoring with zero risk of modifications
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Вопросы
Как установить K8s Pilot?
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Нужен ли API-ключ для K8s Pilot?
В этой записи не указано обязательных переменных окружения.
Какой транспорт использует K8s Pilot?
K8s Pilot работает локально через stdio.
Когда K8s Pilot проверялся в последний раз?
Последняя проверка: 2026-10-28. Kubernetes Control Plane Server for Managing Multiple Clusters – the central pilot for your k8s fleets✈️✈️