{"id":28047220,"url":"https://github.com/bourbonkk/k8s-pilot","last_synced_at":"2025-05-11T20:47:10.689Z","repository":{"id":288338894,"uuid":"967701161","full_name":"bourbonkk/k8s-pilot","owner":"bourbonkk","description":"Kubernetes Control Plane Server for Managing Multiple Clusters – the central pilot for your k8s fleets✈️✈️","archived":false,"fork":false,"pushed_at":"2025-04-23T00:56:58.000Z","size":980,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-11T20:46:24.967Z","etag":null,"topics":["k8s","kubernetes","kubernetes-cluster","mcp-server","multicluster"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bourbonkk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-16T21:35:54.000Z","updated_at":"2025-04-29T10:56:20.000Z","dependencies_parsed_at":"2025-04-17T10:34:37.180Z","dependency_job_id":"45880acd-1bb8-46b5-89de-49a96821d66b","html_url":"https://github.com/bourbonkk/k8s-pilot","commit_stats":null,"previous_names":["bourbonkk/k8s-pilot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bourbonkk%2Fk8s-pilot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bourbonkk%2Fk8s-pilot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bourbonkk%2Fk8s-pilot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bourbonkk%2Fk8s-pilot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bourbonkk","download_url":"https://codeload.github.com/bourbonkk/k8s-pilot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253632911,"owners_count":21939383,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["k8s","kubernetes","kubernetes-cluster","mcp-server","multicluster"],"created_at":"2025-05-11T20:47:05.548Z","updated_at":"2025-05-11T20:47:10.683Z","avatar_url":"https://github.com/bourbonkk.png","language":"Python","funding_links":[],"categories":["📦 Other","Cloud Platforms","Cloud Services","🏛️ Infrastructure"],"sub_categories":["How to Submit"],"readme":"\n![k8s-pilot-ci](https://github.com/user-attachments/assets/e2bc58d2-5ede-448b-bf4f-a3bb2c02cea4)\n\n\n[![smithery badge](https://smithery.ai/badge/@bourbonkk/k8s-pilot)](https://smithery.ai/server/@bourbonkk/k8s-pilot)\n\n**The Central Pilot for Your Kubernetes Fleets ✈️✈️**\n\n`k8s_pilot` is a lightweight, centralized control plane server for managing **multiple Kubernetes clusters** at once.  \nWith powerful tools and intuitive APIs, you can observe and control all your clusters from one cockpit.\n\n---\n\n## 🚀 Overview\n\n- 🔄 Supports **multi-cluster context switching**\n- 🔧 Enables **CRUD operations** on most common Kubernetes resources\n- ⚙️ Powered by [MCP](https://modelcontextprotocol.io/) for Claude AI and beyond\n\n---\n\n## 🧰 Prerequisites\n\n- Python **3.13** or higher\n- [`uv`](https://github.com/astral-sh/uv) package manager\n- Access to Kubernetes clusters (`~/.kube/config` or in-cluster config)\n\n```bash\n# Install uv (if not installed)\n\n# For MacOS\nbrew install uv\n\n# For Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/bourbonkk/k8s-pilot.git\ncd k8s-pilot\n\n# Launch with uv + MCP\nuv run --with mcp[cli] mcp run k8s_pilot.py\n```\n\n## Usage with Claude Desktop\n\nUse this config to run k8s_pilot MCP server from within Claude:\n\n```json\n{\n  \"mcpServers\": {\n    \"k8s_pilot\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u003cpath-to-cloned-repo\u003e/k8s-pilot\",\n        \"run\",\n        \"--with\",\n        \"mcp[cli]\",\n        \"mcp\",\n        \"run\",\n        \"k8s_pilot.py\"\n      ]\n    }\n  }\n}\n```\n\nReplace \u003cpath-to-cloned-repo\u003e with the actual directory where you cloned the repo.\n\n## Scenario\nCreate a Deployment using the nginx:latest image in the pypy namespace, and also create a Service that connects to it.\n![deploy와 서비스생성(영어](https://github.com/user-attachments/assets/eddc4ddf-ead9-47f2-aabc-e4e9e80a1e83)\n\n\n## Key Features\n\n### Multi-Cluster Management\n\n- Seamlessly interact with multiple Kubernetes clusters\n- Perform context-aware operations\n- Easily switch between clusters via MCP prompts\n\n### Resource Control\n\n- View, create, update, delete:\n    - Deployments, Services, Pods\n    - ConfigMaps, Secrets, Ingresses\n    - StatefulSets, DaemonSets\n    - Roles, ClusterRoles\n    - PersistentVolumes \u0026 Claims\n\n### Namespace Operations\n\n- Create/delete namespaces\n- List all resources in a namespace\n- Manage labels and resource quotas\n\n### Node Management\n\n- View node details and conditions\n- Cordon/uncordon, label/taint nodes\n- List pods per node\n\n# License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbourbonkk%2Fk8s-pilot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbourbonkk%2Fk8s-pilot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbourbonkk%2Fk8s-pilot/lists"}