MCP Kubernetes Server

🚀 Kubernetes MCP サーバー

自然言語処理とAPIを組み合わせてKubernetesクラスタにアクセスする軽量MCPサーバーで、kubectlコマンドとKubernetes Pythonクライアントを統合します。

Kubernetes MCP Server

🚀 クイックスタート

このサーバーは、自然言語クエリを使ってKubernetesクラスタのリソースを管理できます。以下のセクションで、インストール方法と使用方法を説明します。

✨ 主な機能

• 自然言語インターフェース：英語のクエリをkubectlコマンドに変換します。
  • すべての名前空間のポッドとデプロイをリストします。
  • サポートされていないクエリの場合は、一般的なリソースリストにフォールバックします。
• 完全なCRUD操作：
  • 🆕 APIエンドポイントを通じて名前空間、ポッド、デプロイを作成/削除します。
  • 🔍 クラスタリソースを確認します。
  • ✏️ ラベル、注釈、デプロイ構成を変更します。
  • 🗑️ アイドル期間を持つグレースフルな削除を行います。
  • 📊 デプロイのスケールを調整します。
• 二重実行モード：
  • kubectl コマンドの統合
  • Kubernetes公式Pythonクライアント（SDK）
• 高度な機能：
  • 名前空間の検証（DNS - 1123互換）
  • ラベルフィルタリング
  • アイドル期間の制御
  • 自動コマンドフォールバック
  • リソース管理（CPU、メモリ）
  • 環境変数の設定

📦 インストール

前提条件

• Python 3.11+
• アクセス可能なKubernetesクラスタ
• ローカルに設定された kubectl
• UV がインストールされていること

# リポジトリをクローン
git clone https://github.com/ductnn/mcp-kubernetes-server.git 
cd mcp-kubernetes-server

# 仮想環境を作成
uv venv .venv

# アクティブ化（Unix）
source .venv/bin/activate

# 依存関係をインストール
uv pip install -r requirements.txt

💻 使用例

基本的な使用法

自然言語処理

サーバーは、リソースをリストするための基本的な自然言語クエリをサポートしています。

# すべてのポッドをリスト
result = nl_processor.process("Show me all pods")

# すべてのデプロイをリスト
result = nl_processor.process("Show me all deployments")

# 名前空間付きのクエリ
result = nl_processor.process("Show me all resources", "kube - system")

APIエンドポイント

サーバーは、すべての操作に対するRESTfulエンドポイントを提供します。

• /api/pods：すべてのポッドをリスト
• /api/deployments：すべてのデプロイをリスト
• /api/services：すべてのサービスをリスト
• /api/namespaces：すべての名前空間をリスト
• /api/resources：すべてのリソースをリスト

高度な使用法

より複雑な操作には、専用のAPIエンドポイントを使用します。

# ポッドを作成
pod_service.create_pod(
    name="my-pod",
    namespace="default",
    image="nginx:latest",
    labels={"app": "my-app"}
)

# デプロイを作成
deployment_service.create_deployment(
    name="my-deployment",
    namespace="default",
    image="nginx:latest",
    replicas=3
)

# 名前空間を削除
namespace_service.delete("my-namespace", force=True)

🤖 AIアシスタントとの統合

以下のように設定します。

# パスを設定
export PATH="/path/to/uv:$PATH"

💻 テスト

基本的なテスト

# 依存関係をインストール
pip install -r requirements.txt

# テストを実行
pytest tests/

詳細説明

• 自然言語処理：ユーザーのクエリをKubernetes操作に変換します。
• APIエンドポイント：Kubernetesリソースを管理するためのRESTful APIを提供します。

📄 ライセンス

このプロジェクトは、MITライセンスに基づいています。