A
securityF
licenseA
qualityA server that enables LLMs to manage Kubernetes clusters through natural language commands, wrapping kubectl operations to provide a simplified interface for common Kubernetes tasks.
Last updated -
25
9
The k8s-pilot server provides a centralized control plane for managing multiple Kubernetes clusters with comprehensive operations on various resources.
Multi-Cluster Management: List clusters, switch between contexts, and perform cluster-aware operations
Resource Management: CRUD operations on Deployments, Services, Pods, ConfigMaps, Secrets, Ingresses, StatefulSets, DaemonSets, Roles, ClusterRoles, PersistentVolumes, Claims, ReplicaSets, and ServiceAccounts
Namespace Operations: Create/delete namespaces, manage labels, set resource quotas, and list resources
Node Management: View node details, manage labels and taints, cordon/uncordon nodes, and list pods per node
Monitoring: Fetch logs for pods (with container specification and tailing options) and inspect detailed resource information
Enables management of multiple Kubernetes clusters simultaneously, including CRUD operations on common resources like Deployments, Services, Pods, ConfigMaps, Secrets, Ingresses, StatefulSets, DaemonSets, Roles, and PersistentVolumes, as well as namespace and node management operations.
Supports creating and managing NGINX deployments within Kubernetes clusters, including setting up NGINX containers and connecting them to services.
Enables operations within the PyPy namespace in Kubernetes clusters, allowing resource deployment and management specific to this namespace.
The Central Pilot for Your Kubernetes Fleets ✈️✈️
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.
🚀 Overview
🔄 Supports multi-cluster context switching
🔧 Enables CRUD operations on most common Kubernetes resources
⚙️ Powered by MCP for Claude AI and beyond
🧰 Prerequisites
Python 3.13 or higher
uvpackage managerAccess to Kubernetes clusters (
~/.kube/configor 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] mcp run k8s_pilot.py
Usage with Claude Desktop
Use this config to run k8s_pilot MCP server from within Claude:
{
"mcpServers": {
"k8s_pilot": {
"command": "uv",
"args": [
"--directory",
"<path-to-cloned-repo>/k8s-pilot",
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"k8s_pilot.py"
]
}
}
}
Replace with the actual directory where you cloned the repo.
Scenario
Create a Deployment using the nginx:latest image in the pypy namespace, and also create a Service that connects to it.
Key Features
Multi-Cluster Management
Seamlessly interact with multiple Kubernetes clusters
Perform context-aware operations
Easily switch between clusters via MCP prompts
Resource Control
View, create, update, 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 conditions
Cordon/uncordon, label/taint nodes
List pods per node
License
This project is licensed under the MIT License. See the LICENSE file for details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A lightweight, centralized control plane server that enables management of multiple Kubernetes clusters simultaneously, supporting context switching and CRUD operations on common Kubernetes resources.
Related MCP Servers
- -securityAlicense-qualityProvides MCP multi-cluster Kubernetes management and operations, featuring a management interface, logging, and nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD resources.Last updated -671MIT License
- -securityAlicense-qualityProvides MCP multi-cluster Kubernetes management and operations. It can be integrated as an SDK into your own project and includes nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD resources.Last updated -125MIT License
- -securityFlicense-qualityAn MCP server that enables interaction with multiple Kubernetes clusters simultaneously, providing comprehensive tools for cluster management, resource operations, and diagnostics across different environments.Last updated -