K8s Ai

🚀 Kubernetes AI Management System

Kubernetes management with AI (MCP + Agent)

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

🚀 Quick Start

This project combines artificial intelligence with Kubernetes management. Users can perform real - time diagnosis, resource monitoring, and intelligent log analysis, simplifying Kubernetes management and offering a modern alternative.

💡 Simply ask questions naturally - no need to memorize commands!

✨ Features

This AI - driven system understands natural - language queries about Kubernetes clusters. Here are some of the functions that the system can provide through natural - language queries:

🏥 Cluster Health and Diagnosis

• "How is the status of my cluster?"
• "Show all pods in the default namespace."
• "Are there any failed pods in the default namespace?"
• "Is my application running properly?"
• "Do I need to optimize the resource usage of my Kubernetes cluster?"

Detailed Functional Modules

🛠️ Cluster Status Monitoring

View the real - time health status of the cluster, including the status of nodes, pods, and services.

🚨 Anomaly Detection

Automatically identify and report potential issues, such as pod failures or resource shortages.

🔍 Resource Usage Analysis

Provide detailed resource usage reports to help optimize the performance of the Kubernetes cluster.

📈 Performance Monitoring

Track key metrics, such as CPU, memory, and disk usage, and generate trend charts.

🛠️ Cluster Status Monitoring

• View the real - time operating status of all nodes.
• Monitor the health status of pods.
• Check if services are running properly.

🚨 Anomaly Detection

• Automatically identify pod failures.
• Report resource shortage situations.
• Provide repair suggestions.

🔍 Resource Usage Analysis

• Analyze CPU and memory usage.
• Generate resource usage reports.
• Help optimize cluster configuration.

📈 Performance Monitoring

• Monitor key metrics.
• Generate trend charts.
• Provide performance optimization suggestions.

📦 Installation

Prerequisites

1. JDK 8 or higher
2. Maven 3.5 or higher
3. Kubernetes environment

Build the Project

# Download the project source code
git clone https://github.com/your-repository.git
cd kubernetes-ai-system

# Build with Maven
mvn clean package

Test the Project

3.1 Integration of MCP Server and Claude Desktop

Refer to 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 for instructions on how to run the agent.

📚 Documentation

Project Structure

The project is divided into the following modules:

• agent: Agent mode with Rest API, used to analyze the cluster through natural language.
• mcp-server: MCP server, used in combination with tools (such as Claude Desktop) to provide a complete experience.
• tools: Kubernetes tools for cluster analysis/management (used jointly by the agent and mcp - server).

📄 License

This project is open - sourced under the MIT License - see the LICENSE file for details.