MCP K8s Eye

🚀 mcp-k8s-eye

mcp-k8s-eye 是一款强大的工具，它能够对 Kubernetes 集群进行有效管理，同时还能深入分析工作负载的状态，为用户提供全面的集群管理和监控能力。

🚀 快速开始

在使用 mcp-k8s-eye 之前，需要满足以下要求：

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

✨ 主要特性

核心 Kubernetes 操作

• [x] 可连接到 Kubernetes 集群
• [x] 通用 Kubernetes 资源 管理功能：
  • 全面支持所有内置资源，如 Pod、Deployment、Service、StatefulSet、Ingress 等。
  • 支持自定义资源定义（CustomResourceDefinition）。
  • 支持的操作包括列出、获取、创建、更新、删除。
• [x] Pod 管理功能，可执行命令、查看日志。
• [x] Deployment 管理功能，支持缩放操作。

诊断

• [x] Pod 诊断：分析_pod 和容器状态。
• [x] Service 诊断：分析服务选择器配置、未就绪的端点、事件。
• [x] Deployment 诊断：分析可用副本数。
• [x] StatefulSet 诊断：分析有状态集服务是否存在、PVC 是否存在、可用副本数。
• [x] CronJob 诊断：分析定时任务计划、开始截止时间、上次执行时间。
• [x] Ingress 诊断：分析 ingress 类配置、相关服务、TLS 证书。
• [x] NetworkPolicy 诊断：分析网络策略配置、受影响的 pod。
• [x] ValidatingWebhook 诊断：分析 webhook 配置、引用的服务和 pod。
• [x] MutatingWebhook 诊断：分析 webhook 配置、引用的服务和 pod。
• [x] Node 诊断：分析节点条件。
• [ ] 集群诊断和故障排除

监控

• [ ] Pod 使用情况，利用率（CPU、内存）
• [ ] Deployment 和 Namespace 维度的资源使用情况（CPU、内存）
• [ ] Node 容量，利用率（CPU、内存）
• [ ] 集群容量，利用率（CPU、内存）

高级功能

• [x] 支持多种传输协议，包括标准输入输出、流式数据。
• [x] 支持多个 AI 客户端。

📦 安装指南

# 克隆仓库
git clone https://github.com/wenhuwang/mcp-k8s-eye.git
cd mcp-k8s-eye

# 构建二进制文件
go build -o mcp-k8s-eye

💻 使用示例

基础用法

标准输入输出模式

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

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

流式数据模式

1. 启动你的 mcp 流式服务器
2. 配置你的 mcp 服务器

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

高级用法

光标工具