mcp-k8s-eye is a tool that can manage kubernetes cluster and analyze workload status.
- Connect to a Kubernetes cluster
- Generic Kubernetes Resources management capabilities
- Support all navtie resources: Pod, Deployment, Service, StatefulSet, Ingress...
- Support CustomResourceDefinition resources
- Operations include: list, get, create, update, delete
- Pod management capabilities (exec, logs)
- Deployment management capabilities (scale)
- Describe Kubernetes resources
- Explain Kubernetes resources
- Pod diagnostics (analyze pod status, container status, pod resource utilization)
- Service diagnostics (analyze service selector configuration, not ready endpoints, events)
- Deployment diagnostics (analyze available replicas)
- StatefulSet diagnostics (analyze statefulset service if exists, pvc if exists, available replicas)
- CronJob diagnostics (analyze cronjob schedule, starting deadline, last schedule time)
- Ingress diagnostics (analyze ingress class configuration, related services, tls secrets)
- NetworkPolicy diagnostics (analyze networkpolicy configuration, affected pods)
- ValidatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
- MutatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
- Node diagnostics (analyze node conditions)
- Cluster diagnostics and troubleshooting
- Pod and container resource usage (cpu, memory)
- Deployment and Namespace dimension resource usage (cpu, memory)
- Node capacity, utilization (cpu, memory)
- Cluster capacity, utilization (cpu, memory)
- Multiple transport protocols support (Stdio, SSE)
- Support multiple AI Clients
- Go 1.23 or higher
- kubectl configured
# clone the repository
git clone https://github.com/wenhuwang/mcp-k8s-eye.git
cd mcp-k8s-eye
# build the binary
go build -o mcp-k8s-eye
{
"mcpServers": {
"k8s eye": {
"command": "YOUR mcp-k8s-eye PATH",
"env": {
"HOME": "USER HOME DIR"
},
}
}
}
env.HOME is used to set the HOME directory for kubeconfig file.
- start your mcp sse server
- config your mcp server
{
"mcpServers": {
"k8s eye": {
"url": "http://localhost:8080/sse",
"env": {}
}
}
}