Content
# 🎯 Kubernetes AI Management System
[](https://spring.io/projects/spring-boot)
[](https://kubernetes.io/)
[](https://kotlinlang.org/)
[](LICENSE)
> AI-Powered Kubernetes Management (MCP + Agent)
```ascii
⎈ K8s AI Management
├── 🤖 MCP Server
├── 🔍 K8s Tools
└── 🚀 Agent mode with Rest API
```
## ✨ Overview
This project combines the power of AI with Kubernetes management. Users can perform real-time diagnostics, resource monitoring, and smart log analysis. It simplifies Kubernetes management through conversational AI, providing a modern alternative.
> 💡 Just ask questions naturally - no need to memorize commands!
## 🏗️ Project Structure
The project is organized into the following modules:
- **agent**: Agent mode backed by Rest API to analyze the cluster using natural language
- **mcp-server**: MCP server backed by tools which can be integrated with MCP host (like Claude desktop) to provide a full experience
- **tools**: Kubernetes tools for cluster analysis/management (used by both agent and mcp-server)
## 🎁 Features
This AI-powered system understands natural language queries about your Kubernetes cluster. Here are some of the capabilities provided by the system which can be queried using natural language:
### 🏥 Cluster Health and Diagnostics
- "What's the status of my cluster?"
- "Show me all pods in the default namespace"
- "Are there any failing pods? in default namespace"
- "What's using the most resources in my cluster?"
- "Give me a complete health check of the cluster"
- "Are there any nodes not in Ready state?"
- "Show me pods in default namespace that have been running for more than 7 days"
- "Identify any pods running in default namespace with high restart counts"
### 🌐 Network Analysis
- "Show me the logs for the payment service"
- "List all ingresses in the cluster"
- "Show me all services and their endpoints"
- "Check if my service 'api-gateway' has any endpoints"
- "Show me all exposed services with external IPs"
### 💾 Storage Management
- "List all persistent volumes in the cluster"
- "Show me storage claims that are unbound"
- "What storage classes are available in the cluster?"
- "Which pods are using persistent storage?"
- "Are there any storage volumes nearing capacity?"
### ⏱️ Job and CronJob Analysis
- "List all running jobs in the batch namespace"
- "Show me failed jobs from the last 24 hours"
- "What CronJobs are scheduled to run in the next hour?"
- "Show me the execution history of the 'backup' job"
### ⎈ Helm Release Management
- "List all Helm releases"
- "Upgrade the MongoDB chart to version 12.1.0"
- "What values are configured for my Prometheus release?"
- "Rollback the failed Elasticsearch release"
- "Show me the revision history for my Prometheus release"
- "Compare values between different Helm releases"
- "Check for outdated Helm charts in my cluster"
- "What are the dependencies for my Elasticsearch chart?"
> Note: The system uses AI to analyze patterns in logs, events, and resource usage to provide intelligent diagnostics and recommendations.
## 🛠️ Prerequisites
| Requirement | Version |
|------------|----------|
| ☕ JDK | 17 or later |
| 🧰 Maven | 3.8 or later |
| ⎈ Minikube/Any Kubernetes cluster | Configured `~/.kube/config` |
> **Note:** The system uses the kubeconfig file from `~/.kube/config`, so make sure it is properly configured.
---
## 🏗️ 1. Project Build
```bash
# 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 setup
Install minikube and create a nginx deployment:
```bash
# 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
```
> **Note:** You should see `nginx` pod in the output
## 🛠️ 3. Testing project
### 🤝 3.1 MCP Server integration with Claude Desktop
Refer to [mcp-server/README.md](mcp-server/README.md) for instructions on how to integrate with Claude Desktop
### 3.2. Agent Mode with Rest API
Refer to [agent/README.md](agent/README.md) for instructions on how to run the agent
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
MCP Store
