🎯 Kubernetes AI Management System

🎯 Kubernetes AI 管理システム

AI を活用した Kubernetes 管理（MCP + エージェント）

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

✨ 概要

このプロジェクトは、AI の力と Kubernetes 管理を組み合わせています。ユーザーはリアルタイム診断、リソース監視、スマートなログ分析を実行できます。会話型 AI を通じて Kubernetes 管理を簡素化し、最新の代替手段を提供します。

💡 自然な言葉で質問するだけです。コマンドを覚える必要はありません！

🏗️ プロジェクト構成

プロジェクトは次のモジュールで構成されています。

• agent：Rest API を利用したエージェントモードで、自然言語を使ってクラスターを分析します
• mcp-server：MCP ホスト（Claude desktop など）と統合できるツールを備えた MCP サーバーで、すべての機能を提供します
• tools：クラスターの分析／管理に使用する Kubernetes ツール（agent と mcp-server の両方で使用）

🎁 機能

この AI 搭載システムは、Kubernetes クラスターに関する自然言語の問い合わせを理解します。自然言語で問い合わせられる機能の例を以下に示します。

🏥 クラスターの健全性と診断

• 「クラスターの状態はどうなっていますか？」
• 「default 名前空間のすべてのポッドを表示してください」
• 「default 名前空間に問題のあるポッドはありますか？」
• 「クラスター内で最も多くのリソースを使用しているものは何ですか？」
• 「クラスターの完全なヘルスチェックを実行してください」
• 「Ready 状態ではないノードはありますか？」
• 「default 名前空間で 7 日以上稼働しているポッドを表示してください」
• 「default 名前空間で再起動回数の多いポッドを特定してください」

🌐 ネットワーク分析

• 「payment サービスのログを表示してください」
• 「クラスター内のすべての Ingress を一覧表示してください」
• 「すべてのサービスとそのエンドポイントを表示してください」
• 「サービス 'api-gateway' にエンドポイントがあるか確認してください」
• 「外部 IP を持つ、公開されているすべてのサービスを表示してください」

💾 ストレージ管理

• 「クラスター内のすべての永続ボリュームを一覧表示してください」
• 「バインドされていないストレージ要求を表示してください」
• 「クラスターで利用可能なストレージクラスは何ですか？」
• 「永続ストレージを使用しているポッドはどれですか？」
• 「容量が上限に近づいているストレージボリュームはありますか？」

⏱️ Job と CronJob の分析

• 「batch 名前空間で実行中のすべての Job を一覧表示してください」
• 「過去 24 時間に失敗した Job を表示してください」
• 「次の 1 時間以内に実行予定の CronJob は何ですか？」
• 「'backup' Job の実行履歴を表示してください」

⎈ Helm リリース管理

• 「すべての Helm リリースを一覧表示してください」
• 「MongoDB チャートをバージョン 12.1.0 にアップグレードしてください」
• 「Prometheus リリースにはどの値が設定されていますか？」
• 「失敗した Elasticsearch リリースをロールバックしてください」
• 「Prometheus リリースのリビジョン履歴を表示してください」
• 「異なる Helm リリース間の値を比較してください」
• 「クラスター内の古くなった Helm チャートを確認してください」
• 「Elasticsearch チャートの依存関係は何ですか？」

注：システムは 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 ポッドが表示されるはずです。

🛠️ 3. プロジェクトのテスト

🤝 3.1 MCP サーバーと Claude Desktop の統合

Claude Desktop との統合方法については、mcp-server/README.md を参照してください。

3.2. Rest API を使用したエージェントモード

エージェントの実行方法については、agent/README.md を参照してください。

---

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。