malepuppet/mcp-k8s-eye

mcp-k8s 눈

mcp-k8s-eye는 kubernetes 클러스터를 관리하고 워크로드 상태를 분석 할 수있는 도구입니다.

특징

핵심 Kubernetes 가동

• [x] Kubernetes 클러스터에 연결
• [x] **Generic Kubernetes Resources ** 관리 기능
• 모든 navtie 리소스 지원 : 포드, 배포, 서비스, StatefulSet, 진입 …
• CustomResourceDefinition 리소스 지원
• Operations include: 목록, get, create, update, delete
• [x] 파드 관리 기능 (exec, 로그)
• [x] 배포 관리 기능 (scale)
• [ ] Kubernetes 리소스 설명
• [ ] Kubernetes 리소스 설명

진단

• [x] 팟 진단 (일부 팟 상태, 컨테이너 상태, 팟 리소스 활용)
• [x] 서비스 진단(analyze service selector configuration, not ready endpoints, event)
• [x] 배포 진단 (analyze available replicas)
• [x] StatefulSet 진단 (이 존재하는 경우, pvc, 사용할 수 있는 복제)
• [x] CronJob 진단 (analyze cronjob 일정, 시작 마감일, 마지막 일정 시간)
• [x] Ingress 진단 (analyze ingress 클래스 구성, 관련 서비스, tls 비밀)

mcp-k8s-eye

mcp-k8s-eye is a tool that can manage kubernetes cluster and analyze workload status.

Features

Core Kubernetes Operations

• [x] Connect to a Kubernetes cluster
• [x] Generic Kubernetes Resources management capabilities
  • Support all navtie resources: Pod, Deployment, Service, StatefulSet, Ingress…
  • Support CustomResourceDefinition resources
  • Operations include: list, get, create, update, delete
• [x] Pod management capabilities (exec, logs)
• [x] Deployment management capabilities (scale)
• [ ] Describe Kubernetes resources
• [ ] Explain Kubernetes resources

Diagnostics

• [x] Pod diagnostics (analyze pod status, container status, pod resource utilization)
• [x] Service diagnostics (analyze service selector configuration, not ready endpoints, events)
• [x] Deployment diagnostics (analyze available replicas)
• [x] StatefulSet diagnostics (analyze statefulset service if exists, pvc if exists, available replicas)
• [x] CronJob diagnostics (analyze cronjob schedule, starting deadline, last schedule time)
• [x] Ingress diagnostics (analyze ingress class configuration, related services, tls secrets)
• [x] NetworkPolicy diagnostics (analyze networkpolicy configuration, affected pods)
• [x] ValidatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
• [x] MutatingWebhook diagnostics (analyze webhook configuration, referenced services and pods)
• [x] Node diagnostics (analyze node conditions)
• [ ] Cluster diagnostics and troubleshooting

Monitoring

• [x] Pod, Deployment, ReplicaSet, StatefulSet, DaemonSet workload resource usage (cpu, memory)
• [ ] Node capacity, utilization (cpu, memory)
• [ ] Cluster capacity, utilization (cpu, memory)

Advanced Features

• [x] Multiple transport protocols support (Stdio, SSE)
• [x] Support multiple AI Clients

Requirements

• Go 1.23 or higher
• kubectl configured

Installation

# clone the repository
git clone https://github.com/malepuppet/mcp-k8s-eye.git
cd mcp-k8s-eye

# build the binary
go build -o mcp-k8s-eye

Usage

Stdio mode

{
  "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.

SSE mode

1. start your mcp sse server
2. config your mcp server

{
  "mcpServers": {
    "k8s eye": {
      "url": "http://localhost:8080/sse",
      "env": {}
    }
  }
}

cursor tools