🎯 Kubernetes AI Management System

What is Kubernetes AI Management System?

Kubernetes AI Management System is an AI-powered tool that combines natural language processing with Kubernetes management. It provides real-time diagnostics, resource monitoring, and smart log analysis through an MCP server and an agent with a REST API, allowing users to manage clusters using conversational queries.

How to use Kubernetes AI Management System?

Install JDK 17+, Maven 3.8+, and configure a Kubernetes cluster with a valid ~/.kube/config file. Build all modules with mvn clean package, then run either the MCP server (java -jar mcp-server/target/mcp-server-1.0-SNAPSHOT.jar) or the agent (java -jar agent/target/agent-*-fat.jar). For a quick local test, set up Minikube and deploy a test workload.

Key features of Kubernetes AI Management System

• Cluster health diagnostics and resource monitoring
• Network analysis (logs, ingresses, services)
• Storage management (PVs, PVCs, storage classes)
• Job and CronJob analysis and history
• Helm release management (list, upgrade, rollback)
• Conversational AI interface for natural language queries

Use cases of Kubernetes AI Management System

• Check overall cluster health and identify failing pods
• Monitor resource usage and detect abnormal restarts
• Analyze network endpoints and exposed services
• Manage persistent volumes and storage claims
• Troubleshoot jobs and upgrade Helm releases via natural language

FAQ from Kubernetes AI Management System

What are the prerequisites?

JDK 17 or later, Maven 3.8 or later, and a Kubernetes cluster (e.g., Minikube) with a configured ~/.kube/config file.

How do I set up a local cluster for testing?

Install Minikube, start it with minikube start, and create a deployment (e.g., kubectl create deployment nginx --image=nginx:latest). Ensure kubectl config use-context minikube is set.

How can I integrate the MCP server with Claude Desktop?

Refer to the mcp-server/README.md file for detailed integration instructions.

How do I run the agent in agent mode?

Execute java -jar agent/target/agent-*-fat.jar after building the project.

Does the system store any data?

The system uses the kubeconfig file from ~/.kube/config to access cluster resources; no other data storage is mentioned.