mcp-k8s-eye

command module
v0.0.0-...-2da0a07 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 20, 2025 License: Apache-2.0 Imports: 9 Imported by: 0

README

mcp-k8s-eye

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

Features

Core Kubernetes Operations

  • 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

Diagnostics

  • 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

Monitoring

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

Advanced Features

  • Multiple transport protocols support (Stdio, SSE)
  • 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

cursor tools

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg
k8s
mcp

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL