MCP Kubernetes Server

🚀 Kubernetes MCP 服務器

Kubernetes MCP 服務器是一個輕量級的 MCP 服務器，它結合了自然語言處理和 API 來訪問 Kubernetes 集群，將 kubectl 命令與 Kubernetes Python 客戶端巧妙融合，為用戶提供便捷的集群操作體驗。

🚀 快速開始

Kubernetes MCP 服務器支持通過自然語言查詢和 API 端點兩種方式操作 Kubernetes 集群。使用前需完成安裝，安裝完成後即可根據需求進行資源管理等操作。

✨ 主要特性

• 自然語言接口：可將 plain English 查詢轉換為 kubectl 命令。
  • 能列出所有命名空間中的 pod 和部署。
  • 若遇到不支持的查詢，會回退到通用資源列表。
• 完整的 CRUD 操作：
  • 🆕 可通過 API 端點創建或刪除命名空間、pod 和部署。
  • 🔍 能檢查集群資源。
  • ✏️ 可修改標籤、註釋和部署配置。
  • 🗑️ 支持帶有空閒期的優雅刪除。
  • 📊 可調整部署規模。
• 雙執行模式：
  • 集成 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

💻 使用示例

基礎用法

自然語言處理

服務器支持基本的自然語言查詢以列出資源：

# 列出所有 pod
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 端點：

# 創建一個 pod
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 端點：提供 RESTful API 來管理 Kubernetes 資源。

📄 許可證

本項目遵循 MIT 許可證。