Mcp K8s Eye

mcp-k8s-eye

mcp-k8s-eye 是一款可管理 Kubernetes 集群并分析工作负载状态的工具。

功能

Kubernetes 核心操作

• 连接到 Kubernetes 集群
• 通用 Kubernetes 资源管理功能
  • 支持所有原生资源：Pod、Deployment、Service、StatefulSet、Ingress……
  • 支持 CustomResourceDefinition 资源
  • 操作包括：列表、获取、创建、更新、删除
• Pod 管理功能（exec、日志）
• Deployment 管理功能（扩缩容）
• 描述 Kubernetes 资源
• 解释 Kubernetes 资源

诊断

• Pod 诊断（分析 Pod 状态、容器状态、Pod 资源使用情况）
• Service 诊断（分析 Service 选择器配置、未就绪端点、事件）
• Deployment 诊断（分析可用副本）
• StatefulSet 诊断（分析是否存在 StatefulSet Service、PVC，以及可用副本）
• CronJob 诊断（分析 CronJob 调度、启动截止时间、上次调度时间）
• Ingress 诊断（分析 Ingress 类配置、相关 Service、TLS Secret）
• NetworkPolicy 诊断（分析 NetworkPolicy 配置、受影响的 Pod）
• ValidatingWebhook 诊断（分析 Webhook 配置、引用的 Service 和 Pod）
• MutatingWebhook 诊断（分析 Webhook 配置、引用的 Service 和 Pod）
• Node 诊断（分析 Node 状况）
• 集群诊断和故障排查

监控

• Pod、Deployment、ReplicaSet、StatefulSet、DaemonSet 工作负载资源使用情况（CPU、内存）
• Node 容量、使用情况（CPU、内存）
• 集群容量、使用情况（CPU、内存）

高级功能

• 支持多种传输协议（Stdio、SSE）
• 支持多个 AI 客户端

工具用法

资源操作工具

• resource_get：获取命名空间中某个指定资源的详细信息
• resource_list：列出命名空间中所有资源的详细信息
• resource_create_or_update：在命名空间中创建或更新资源
• resource_delete：删除命名空间中的资源
• resource_describe：描述命名空间中资源的详细信息
• deployment_scale：扩缩容命名空间中的 Deployment
• pod_exec：在命名空间中的 Pod 内执行命令`
• pod_logs：获取命名空间中 Pod 的日志

诊断工具

• pod_analyze：诊断命名空间中的所有 Pod
• deployment_analyze：诊断命名空间中的所有 Deployment
• statefulset_analyze：诊断命名空间中的所有 StatefulSet
• service_analyze：诊断命名空间中的所有 Service
• cronjob_analyze：诊断命名空间中的所有 CronJob
• ingress_analyze：诊断命名空间中的所有 Ingress
• networkpolicy_analyze：诊断命名空间中的所有 NetworkPolicy
• validatingwebhook_analyze：诊断所有 ValidatingWebhook
• mutatingwebhook_analyze：诊断所有 MutatingWebhook
• node_analyze：诊断集群中的所有 Node

监控工具

• workload_resource_usage：获取命名空间中 Pod/Deployment/ReplicaSet/StatefulSet 的资源使用情况（CPU、内存）

要求

• Go 1.23 或更高版本
• 已配置 kubectl

安装

# 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

用法

Stdio 模式

{
  "mcpServers": {
    "k8s eye": {
      "command": "YOUR mcp-k8s-eye PATH",
      "env": {
        "HOME": "USER HOME DIR"
      },
    }
  }
}

env.HOME 用于设置 kubeconfig 文件的 HOME 目录。

SSE 模式

1. 启动 MCP SSE 服务
2. 配置 MCP 服务

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

cursor 工具