https://github.com/basebandit/kai
An MCP Server for Kubernetes
https://github.com/basebandit/kai
golang kubernetes mcp mcp-server
Last synced: 3 months ago
JSON representation
An MCP Server for Kubernetes
- Host: GitHub
- URL: https://github.com/basebandit/kai
- Owner: basebandit
- License: mit
- Created: 2025-03-24T12:33:18.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-27T15:59:05.000Z (4 months ago)
- Last Synced: 2025-05-27T16:48:12.907Z (4 months ago)
- Topics: golang, kubernetes, mcp, mcp-server
- Language: Go
- Homepage:
- Size: 1.24 MB
- Stars: 16
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Kai - kubernetes MCP server
A Model Context Protocol (MCP) server for managing a Kubernetes cluster through llm clients like Claude, Ollama.
## Overview
Kai MCP server provides a bridge between large language models (LLMs) clients and your Kubernetes clusters, enabling users to interact with their Kubernetes resources through natural language. The server exposes a comprehensive set of tools for managing clusters, namespaces, pods, deployments, services, and other Kubernetes resources.
## Features
- [x] **Pods** - Create, list, get, delete, and stream logs
- [x] **Deployments** - Create, list, describe, and update deployments
- [x] **Services** - Create, get, list, and delete services
- [ ] **Cluster Management** - Connect, list, switch, and monitor clusters
- [ ] **Namespaces** - Create, list, update, and delete namespaces
- [ ] **Ingress** - HTTP/HTTPS routing and TLS configuration
- [ ] **ConfigMaps & Secrets** - Configuration and secret management
- [ ] **Jobs & CronJobs** - Batch workload orchestration
- [ ] **Nodes** - Node monitoring, cordoning, and draining
- [ ] **Utilities** - Port forwarding, events, and API exploration
- [ ] **Persistent Volumes** - Storage management and claims
- [ ] **RBAC** - Role-based access control
- [ ] **Custom Resources** - CRD and custom resource operations
## Requirements
The server will by default connect to your current context. Make sure you have:
Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, EKS, GKE, etc.)
## Installation
To install the Kubernetes MCP server, run:
```sh
go install github.com/basebandit/kai/cmd/kai
```
## Integration with Claude for Desktop
`code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
Add the server to your **Claude for Desktop** configuration by editing `claude_desktop_config.json`:
```json
{
"mcpServers": {
"kubernetes": {
"command": "/path/to/kai binary"
}
}
}
```
