用途
mcp-k8s-eye 是一个用于 Kubernetes 集群管理与应用诊断的 MCP 服务器。它的目标是把 Kubernetes 的日常运维操作和集群、应用健康分析能力,以工具的形式提供给 AI 客户端调用。
主要能力
核心 Kubernetes 操作
- 连接 Kubernetes 集群。
- 通用 Kubernetes 资源管理能力,支持所有原生资源,包括 Pod、Deployment、Service、StatefulSet、Ingress 等,并支持 CustomResourceDefinition 资源。
- 资源操作包括:list、get、create、update、delete。
- Pod 管理能力:exec、logs。
- Deployment 管理能力:scale。
- 对 Kubernetes 资源执行 describe。
- 对 Kubernetes 资源执行 explain。
诊断能力
- Pod 诊断:分析 Pod 状态、容器状态、Pod 资源利用率。
- Service 诊断:分析 Service selector 配置、未就绪端点、事件。
- Deployment 诊断:分析可用副本数。
- StatefulSet 诊断:分析 StatefulSet 对应的 Service 是否存在、PVC 是否存在、可用副本数。
- CronJob 诊断:分析 CronJob 的 schedule、starting deadline、last schedule time。
- Ingress 诊断:分析 Ingress class 配置、相关 Service、TLS Secret。
- NetworkPolicy 诊断:分析 NetworkPolicy 配置、受影响的 Pod。
- ValidatingWebhook 诊断:分析 webhook 配置、引用的 Service 与 Pod。
- MutatingWebhook 诊断:分析 webhook 配置、引用的 Service 与 Pod。
- Node 诊断:分析 Node 状况(conditions)。
- 集群诊断与故障排查。
监控能力
- 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。
- 使用 env.HOME 设置 kubeconfig 文件所在的主目录。
- 启动 MCP SSE 服务器。
- 配置你的 MCP 服务器。
适用场景
- 通过 AI 客户端对 Kubernetes 集群进行资源查询、创建、更新、删除等日常操作。
- 对 Pod、Deployment、Service、StatefulSet、CronJob、Ingress、NetworkPolicy、Webhook、Node 等对象进行诊断分析。
- 查看工作负载、Node 与集群的 CPU、内存使用情况。
限制
资料未提供收费、价格、平台支持范围、性能或效果方面的说明,暂未提供。