K8s Ai Assistant MCP

🚀 K8s AI Assistant MCP

Kubernetesの管理において、MCP (Model Context Protocol) サーバー と Rancher UI拡張機能 を組み合わせた包括的なソリューションです。AIを活用したインテリジェントなKubernetesクラスター管理を実現します。

📋 目次

• 概要
• アーキテクチャ
• コンポーネント
• 機能
• デモ
• インストール
• 使用方法
• 開発
• ライセンス
• 謝辞

🎯 概要

このプロジェクトは、2つの強力な技術を統合し、シームレスなKubernetes管理体験を提供します。

1. Kubernetes用MCPサーバー - AIによるKubernetes操作のコマンドインターフェイス
2. Rancher UI拡張機能 - Rancher管理プラットフォームの視覚的なインターフェイス拡張

この組み合わせにより、統一されたインターフェイスを通じて、コマンドラインでのAI支援と視覚的な管理機能の両方を提供します。

🔄 システムワークフロー

アーキテクチャの概要

K8s AI Assistantは、多層アーキテクチャを採用しており、自然言語のクエリをAI分析で処理し、MCPプロトコルを介してKubernetes操作を実行します。

graph LR
    A[ユーザー入力] --> B[Rancher UI]
    B --> C[バックエンドAPI]
    C --> D[Ollama AI]
    D --> E[MCPサーバー]
    E --> F[Kubernetes]
    F --> E
    E --> D
    D --> C
    C --> B
    B --> A
    
    style A fill:#e1f5fe
    style B fill:#fff3e0
    style C fill:#f3e5f5
    style D fill:#e8f5e8
    style E fill:#fff8e1
    style F fill:#fce4ec

核心コンポーネント

リクエストフロー

1. ユーザーが自然言語のクエリを提出 - Rancher UI拡張機能を通じて
2. バックエンドAPIがリクエストを検証し、AIモデルにルーティング
3. Ollama AIが意図を分析し、Kubernetes操作にマッピング
4. MCPサーバーがJSON-RPCを介してkubectl/Helmコマンドを実行
5. Kubernetes APIがクラスターデータと操作結果を返す
6. レスポンスチェーンがAIフォーマットでデータを処理
7. フロントエンドがフォーマットされた結果を表示 (テーブル、ログ、洞察)

主要機能

• 自然言語処理 - ユーザーのクエリをKubernetesコマンドに変換
• リアルタイム実行 - ライブクラスターデータの取得と操作実行
• インテリジェントフォーマット - AIによるレスポンスのフォーマットと洞察提供
• 安全な操作 - RBAC準拠のクラスターアクセスと監査ログ
• 拡張可能なアーキテクチャ - 機能追加が容易なモジュール設計

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                    K8s AI Assistant MCP                     │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────────┐    ┌─────────────────────────────────┐  │
│  │   MCP Server    │    │      Rancher UI Extensions      │  │
│  │   (Backend)     │    │         (Frontend)              │  │
│  │                 │    │                                 │  │
│  │ • kubectl ops   │    │ • Visual dashboards            │  │
│  │ • Helm support  │    │ • Resource management UI       │  │
│  │ • AI diagnosis  │    │ • Real-time monitoring         │  │
│  │ • Port forward  │    │ • Custom extensions            │  │
│  └─────────────────┘    └─────────────────────────────────┘  │
│           │                           │                      │
│           └───────────┬───────────────┘                      │
│                       │                                      │
│  ┌─────────────────────────────────────────────────────────┐  │
│  │              Kubernetes Cluster                         │  │
│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐   │  │
│  │  │   Pods      │ │ Services    │ │   Deployments   │   │  │
│  │  └─────────────┘ └─────────────┘ └─────────────────┘   │  │
│  └─────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

🔧 コンポーネント

1. Kubernetes用MCPサーバー (mcp-server-kubernetes/)

フォーク元: Flux159/mcp-server-kubernetes

MCPサーバーは、自然言語コマンドと自動化操作によるAIベースのKubernetes管理を提供します。

主要機能:

• 統一されたkubectl API - 完全なkubectlコマンドサポート
• AIによる診断 - k8s-diagnoseによる自動トラブルシューティング
• Helm操作 - チャート管理とデプロイメント
• ポートフォワーディング - クラスターサービスへの安全なアクセス
• 非破壊モード - 安全な読み取り専用操作
• シークレットマスキング - セキュリティを重視したデータ処理

利用可能なコマンド:

# リソース管理
kubectl_get, kubectl_describe, kubectl_create, kubectl_apply
kubectl_delete, kubectl_scale, kubectl_patch, kubectl_rollout

# 監視とデバッグ
kubectl_logs, port_forward, k8s-diagnose

# Helm操作
install_helm_chart, upgrade_helm_chart, uninstall_helm_chart

# コンテキスト管理
kubectl_context, list_api_resources, explain_resource

2. Rancher UI拡張機能 (rancher-ui/)

フォーク元: rancher/ui-plugin-examples

Rancher UI拡張機能は、Rancherプラットフォームを通じてKubernetesリソースの視覚的な管理インターフェイスを提供します。

主要機能:

• ビジュアルダッシュボード - リアルタイムのクラスター監視
• リソース管理UI - 直感的なリソース操作
• カスタム拡張機能 - 拡張可能なプラグインアーキテクチャ
• マルチクラスターサポート - 複数のクラスターを管理
• ロールベースのアクセス - 安全なアクセス制御

拡張機能の種類:

• 時計拡張機能 - リアルタイムのクラスター時間表示
• ホームページ拡張機能 - カスタムダッシュボードビュー
• CRD拡張機能 - カスタムリソース定義
• ノードドライバー拡張機能 - クラウドプロバイダーの統合
• トップレベルの製品拡張機能 - 完全な製品統合

✨ 機能

AIベースの管理

• 自然言語によるKubernetesコマンド
• 自動トラブルシューティングと診断
• インテリジェントなリソース推奨
• 予測的なスケーリングと最適化

ビジュアルインターフェイス

• リアルタイムのクラスター監視ダッシュボード
• ドラッグアンドドロップによるリソース管理
• ビジュアルなポッドとサービスのトポロジー
• インタラクティブなログビューイング

セキュリティとコンプライアンス

• ロールベースのアクセス制御 (RBAC)
• シークレット管理とマスキング
• 監査ログとコンプライアンスレポート
• 安全なポートフォワーディング

マルチクラスターサポート

• 複数のクラスターを統一的に管理
• クラスター間のリソース監視
• 集中的な構成管理
• クラスターの健全性スコアリング

🎬 デモ

デモスクリーンショット

Rancher UI拡張機能インターフェイス

Kubernetes管理機能を示すRancher UI拡張機能インターフェイス

追加のデモコンテンツ (近日公開)

📸 さらなるデモ画像

K8s AI Assistantの動作を示す追加のスクリーンショットとビデオ

予定されているデモコンテンツ:

• MCPサーバーのコマンドラインインターフェイス
• AIベースのトラブルシューティングワークフロー
• マルチクラスター管理インターフェイス
• リアルタイム監視とアラート
• Helmチャートのデプロイメントプロセス
• ポートフォワーディングとサービスアクセス
• カスタム拡張機能の開発

インタラクティブデモ

🔗 ライブデモの予定

近日公開: 実践的な体験のためのインタラクティブデモ環境

🚀 インストール

前提条件

• Kubernetesクラスター (ローカルまたはリモート)
• Node.js 18以上とnpm/bun
• クラスターアクセス用に設定されたkubectl
• Rancher Manager (UI拡張機能用)
• Ollamaサーバー (AIモデル用)

クイックスタート

1. リポジトリをクローン:

git clone https://github.com/Thanhdeptr/K8s_AI_Assistant_MCP.git
cd K8s_AI_Assistant_MCP

2. MCPサーバーをインストール:

cd mcp-server-kubernetes
npm install
npm run build

3. Rancher UI拡張機能をインストール:

cd ../rancher-ui
npm install

4. Claude Desktopを設定:

{
  "mcpServers": {
    "k8s-ai-assistant": {
      "command": "node",
      "args": ["/path/to/K8s_AI_Assistant_MCP/mcp-server-kubernetes/dist/index.js"]
    }
  }
}

5. Rancher拡張機能をデプロイ:

# 拡張機能をビルドしてパッケージ化
npm run build
npm run package

# Rancherにデプロイ
helm install k8s-ai-extensions ./charts/

詳細なセットアップ手順

MCPサーバーとバックエンドサーバーの実行方法を含む詳細なセットアップ手順については、SETUP.md を参照してください。

📖 使用方法

MCPサーバーコマンド

# デフォルトネームスペースのすべてのポッドを取得
kubectl_get pods

# 特定のデプロイメントを説明
kubectl_describe deployment my-app

# デプロイメントをスケール
kubectl_scale deployment my-app --replicas=5

# ポッドの問題を診断
k8s-diagnose my-app-pod

# サービスにポートフォワーディング
port_forward service/my-app-service 8080:80

Rancher UI拡張機能

1. Rancher Managerにアクセス
2. 拡張機能に移動
3. K8s AI Assistant拡張機能をインストール
4. カスタムダッシュボードとツールにアクセス

🛠️ 開発

プロジェクト構造

K8s_AI_Assistant_MCP/
├── mcp-server-kubernetes/     # MCPサーバーのバックエンド
│   ├── src/                   # ソースコード
│   ├── tests/                 # 単体テスト
│   └── dist/                  # ビルドされたアーティファクト
├── rancher-ui/               # Rancher UI拡張機能
│   ├── pkg/                  # 拡張機能パッケージ
│   ├── charts/               # Helmチャート
│   └── assets/               # 拡張機能のアセット
└── docs/                     # ドキュメント

開発環境のセットアップ

1. MCPサーバーの開発:

cd mcp-server-kubernetes
npm run dev          # ホットリロード付きの開発モード
npm run test         # テストを実行
npm run build        # 本番用にビルド

2. Rancher UIの開発:

cd rancher-ui
npm run dev          # 開発サーバーを起動
npm run build        # 拡張機能をビルド
npm run package      # デプロイ用にパッケージ化

テスト

# すべてのテストを実行
npm run test:all

# MCPサーバーのみテスト
cd mcp-server-kubernetes && npm run test

# UI拡張機能のみテスト
cd rancher-ui && npm run test

📄 ライセンス

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

🙏 謝辞

このプロジェクトは、以下の優れたオープンソースプロジェクトの成果を基に構築されています。

Kubernetes用MCPサーバー

• オリジナルリポジトリ: Flux159/mcp-server-kubernetes
• 作者: Paras PatelとSuyog Sonwalkar
• ライセンス: MITライセンス
• 説明: AIインターフェイスを通じてKubernetes管理コマンドを提供するMCPサーバー

Rancher UIプラグインの例

• オリジナルリポジトリ: rancher/ui-plugin-examples
• 作者: Rancher Labs
• ライセンス: Apache 2.0
• 説明: Rancher管理プラットフォームのUI拡張機能の例

主要貢献者

• Flux159 - MCPサーバーの開発とメンテナンス
• Rancher Labs - UI拡張機能のフレームワークと例
• オープンソースコミュニティ - 継続的な改善とフィードバック

⭐ このリポジトリが役に立った場合は、スターをつけてください！

🔄 フォークして貢献し、さらに良いものにしましょう！