https://github.com/bourbonkk/k8s-pilot
Kubernetes Control Plane Server for Managing Multiple Clusters – the central pilot for your k8s fleets✈️✈️
https://github.com/bourbonkk/k8s-pilot
k8s kubernetes kubernetes-cluster mcp-server multicluster
Last synced: about 1 month ago
JSON representation
Kubernetes Control Plane Server for Managing Multiple Clusters – the central pilot for your k8s fleets✈️✈️
- Host: GitHub
- URL: https://github.com/bourbonkk/k8s-pilot
- Owner: bourbonkk
- License: apache-2.0
- Created: 2025-04-16T21:35:54.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-23T00:56:58.000Z (about 2 months ago)
- Last Synced: 2025-05-11T20:46:24.967Z (about 1 month ago)
- Topics: k8s, kubernetes, kubernetes-cluster, mcp-server, multicluster
- Language: Python
- Homepage:
- Size: 957 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - k8s-pilot - A centralized control plane for managing multiple Kubernetes clusters, enabling multi-cluster context switching and CRUD operations on common Kubernetes resources. (Cloud Services)
- awesome-mcp-servers - bourbonkk/k8s-pilot - cluster context switching. (🏗️ Infrastructure)
README
[](https://smithery.ai/server/@bourbonkk/k8s-pilot)
**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](https://modelcontextprotocol.io/) for Claude AI and beyond
---
## 🧰 Prerequisites
- Python **3.13** or higher
- [`uv`](https://github.com/astral-sh/uv) package manager
- Access to Kubernetes clusters (`~/.kube/config` or in-cluster config)
```bash
# Install uv (if not installed)
# For MacOS
brew install uv
# For Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
```
## Installation
```bash
# 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:
```json
{
"mcpServers": {
"k8s_pilot": {
"command": "uv",
"args": [
"--directory",
"/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](LICENSE) file for details.