🎯 Kubernetes AI Management System

🎯 Kubernetes AI 管理系统

AI 驱动的 Kubernetes 管理（MCP + Agent）

    ⎈ K8s AI Management
    ├── 🤖 MCP Server
    ├── 🔍 K8s Tools
    └── 🚀 Agent mode with Rest API

✨ 概述

本项目将 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 发布管理

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

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

🛠️ 前提条件

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

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

---

🏗️ 1. 构建项目

# Build all modules
mvn clean package

# Run the MCP server
java -jar mcp-server/target/mcp-server-1.0-SNAPSHOT.jar

# Alternatively, run the agent directly
java -jar agent/target/agent-*-fat.jar

🛠️ 2. 配置 Minikube

安装 minikube 并创建 nginx 部署：

# Install minikube
brew install minikube

# Start minikube
minikube start

# Make sure kubeconfig is set
kubectl config use-context minikube

# Deploy nginx
kubectl create deployment nginx --image=nginx:latest

# Check whether nginx is running
kubectl get pods

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

🛠️ 3. 测试项目

🤝 3.1 将 MCP 服务集成到 Claude Desktop

请参阅 mcp-server/README.md，了解如何与 Claude Desktop 集成。

3.2. 使用 REST API 的 Agent 模式

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

---

📄 许可证

本项目基于 MIT License 授权，详情请参阅 LICENSE 文件。