🎯 Kubernetes AI 管理系统

AI 驱动的 Kubernetes 管理 (MCP + Agent)

    ⎈ K8s AI 管理
    ├── 🤖 MCP 服务器
    ├── 🔍 K8s 工具
    └── 🚀 带有 Rest API 的 Agent 模式

✨ 概述

本项目将 AI 的强大功能与 Kubernetes 管理相结合。用户可以执行实时诊断、资源监控和智能日志分析。它通过对话式 AI 简化了 Kubernetes 管理，提供了一种现代化的替代方案。

💡 只需自然地提问 - 无需记住命令！

🏗️ 项目结构

该项目被组织成以下模块：

• agent: 由 Rest API 支持的 Agent 模式，用于使用自然语言分析集群
• mcp-server: 由工具支持的 MCP 服务器，可以与 MCP 主机（如 Claude 桌面）集成，以提供完整的体验
• tools: 用于集群分析/管理的 Kubernetes 工具（由 agent 和 mcp-server 使用）

🎁 功能

这个 AI 驱动的系统可以理解关于你的 Kubernetes 集群的自然语言查询。以下是系统提供的一些功能，可以使用自然语言查询：

🏥 集群健康和诊断

• "我的集群状态如何？"
• "显示 default 命名空间中的所有 Pod"
• "在 default 命名空间中是否有任何失败的 Pod？"
• "我的集群中什么占用了最多的资源？"
• "给我一个完整的集群健康检查"
• "是否有任何节点不在 Ready 状态？"
• "显示 default 命名空间中已运行超过 7 天的 Pod"
• "识别 default 命名空间中重启次数高的任何 Pod"

🌐 网络分析

• "显示 payment 服务的日志"
• "列出集群中的所有 Ingress"
• "显示所有服务及其端点"
• "检查我的 'api-gateway' 服务是否有任何端点"
• "显示所有具有外部 IP 的暴露服务"

💾 存储管理

• "列出集群中的所有持久卷"
• "显示未绑定的存储声明"
• "集群中有哪些存储类可用？"
• "哪些 Pod 正在使用持久存储？"
• "是否有任何存储卷即将达到容量？"

⏱️ Job 和 CronJob 分析

• "列出 batch 命名空间中所有正在运行的 Job"
• "显示过去 24 小时内失败的 Job"
• "哪些 CronJob 计划在下一小时运行？"
• "显示 'backup' Job 的执行历史"

⎈ Helm Release 管理

• "列出所有 Helm Release"
• "将 MongoDB chart 升级到 12.1.0 版本"
• "我的 Prometheus Release 配置了哪些值？"
• "回滚失败的 Elasticsearch Release"
• "显示我的 Prometheus Release 的修订历史"
• "比较不同 Helm Release 之间的值"
• "检查我的集群中是否有过时的 Helm chart"
• "我的 Elasticsearch chart 有哪些依赖项？"

注意：该系统使用 AI 分析日志、事件和资源使用情况中的模式，以提供智能诊断和建议。

🛠️ 前提条件

要求	版本
☕ JDK	17 或更高版本
🧰 Maven	3.8 或更高版本
⎈ Minikube/任何 Kubernetes 集群	已配置 ~/.kube/config

注意： 该系统使用 ~/.kube/config 中的 kubeconfig 文件，因此请确保已正确配置。

---

🏗️ 1. 项目构建

# 构建所有模块
mvn clean package

# 运行 MCP 服务器
java -jar mcp-server/target/mcp-server-1.0-SNAPSHOT.jar

# 或者，直接运行 agent
java -jar agent/target/agent-*-fat.jar

🛠️ 2. Minikube 设置

安装 minikube 并创建一个 nginx 部署：

# 安装 minikube
brew install minikube

# 启动 minikube
minikube start

# 确保 kubeconfig 已设置
kubectl config use-context minikube

# 部署 nginx
kubectl create deployment nginx --image=nginx:latest

# 检查 nginx 是否正在运行
kubectl get pods

注意： 你应该在输出中看到 nginx Pod

🛠️ 3. 测试项目

🤝 3.1 MCP 服务器与 Claude Desktop 集成

有关如何与 Claude Desktop 集成的说明，请参阅 mcp-server/README.md

3.2. 带有 Rest API 的 Agent 模式

有关如何运行 agent 的说明，请参阅 agent/README.md

---

📄 许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。