🤖 AI-Powered Kubernetes Assistant with MCP

An AI-driven Kubernetes assistant built using Model Context Protocol (MCP) that enables natural language interaction with your Kubernetes cluster. It supports dynamic tooling, safe command generation, Helm integration, and real-time AI explanations — all from a clean web UI.

---

🚀 Key Features

🧠 Natural Language Kubernetes Control

Convert natural language queries into safe kubectl/helm commands using Groq/OpenAI (LLM).
Auto-validates generated commands (get, describe, logs, top, etc.).
Fallback mechanism for unsupported or unsafe commands.

naturalLanguageKubectl — Parse and run safe Kubernetes commands.
logsFetcher — Fetch pod logs.
rolloutChecker — Monitor deployment rollout status.
scaleDeployment — Scale deployments up/down.
namespaceAnalyzer — Analyze namespaces.
explain_kubectl_result — AI explanation of command outputs.
kubectlExplain — Explain Kubernetes object fields.
portForwardPod — Port forward from a pod to your local machine.
execCommandInPod — Execute shell commands in a pod.
getPodEvents — Get Kubernetes event history for a pod.
monitoringTool — Check pod health, node resource usage, cluster health, etc.
helmTool — Install, upgrade, or uninstall Helm charts.
createPodTool — Dynamically generate and deploy pods from templates or custom specs.

> 🗂 Tools are located in /tools and registered centrally in tool.ts.

---

🧬 Architecture

User Query (UI)
      ↓
   /api/mcp
      ↓
 +-------------+
 |  MCPServer  |
 +-------------+
     ↓       ↘
 Tool Router   LLM Agent (Groq/OpenAI)
     ↓             ↓
 Tool Handler → kubectl / helm
     ↓             ↓
   Response    (Optional AI Explanation)
      ↓
    UI Renderer

---

🧪 Example Prompts

General Use

"Get all pods not in running state."
"Show logs for pod nginx-deployment-abc123 in namespace default."
"Port-forward traefik pod port 80 to local port 8080."
"Explain what kubectl get namespaces shows."

Monitoring

"Check if any pods are failing their liveness probe."
"What is the current CPU and memory usage across nodes?"

• "List top resource-consuming pods."