MCP K8s Eye

🚀 mcp-k8s-eye

mcp-k8s-eye is a tool that can manage Kubernetes clusters and analyze the status of workloads.

🚀 Quick Start

mcp-k8s-eye simplifies the management of Kubernetes clusters and offers in - depth analysis of workload status, enhancing the efficiency of cluster management.

✨ Features

Core Kubernetes Operations

• [x] Connect to a Kubernetes cluster
• [x] General Kubernetes Resources management capabilities
  • Support for all built - in resources: Pod, Deployment, Service, StatefulSet, Ingress...
  • Support for CustomResourceDefinition (CRD)
  • Operations include: list, get, create, update, delete
• [x] Pod management capabilities (execute commands, view logs)
• [x] Deployment management capabilities (scale)

Diagnosis

• [x] Pod diagnosis (analyze pod and container status)
• [x] Service diagnosis (analyze service selector configuration, unready endpoints, events)
• [x] Deployment diagnosis (analyze the number of available replicas)
• [x] StatefulSet diagnosis (analyze the existence of statefulset services, the existence of PVCs, and the number of available replicas)
• [x] CronJob diagnosis (analyze cron job schedules, start deadlines, last execution times)
• [x] Ingress diagnosis (analyze ingress class configuration, related services, TLS certificates)
• [x] NetworkPolicy diagnosis (analyze network policy configuration, affected pods)
• [x] ValidatingWebhook diagnosis (analyze webhook configuration, referenced services and pods)
• [x] MutatingWebhook diagnosis (analyze webhook configuration, referenced services and pods)
• [x] Node diagnosis (analyze node conditions)
• [ ] Cluster diagnosis and troubleshooting

Monitoring

• [ ] Pod usage and utilization (CPU, memory)
• [ ] Resource usage at the Deployment and Namespace levels (CPU, memory)
• [ ] Node capacity and utilization (CPU, memory)
• [ ] Cluster capacity and utilization (CPU, memory)

Advanced Features

• [x] Support for multiple transport protocols (standard input/output, streaming data)
• [x] Support for multiple AI clients

📦 Installation

# 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

💻 Usage Examples

Basic Usage - Standard Input/Output 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 the kubeconfig file.

Advanced Usage - Streaming Data Mode

1. Start your mcp streaming server.
2. Configure your mcp server.

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

Cursor Tools