K8s MCP Server G9i

🚀 K8s MCP Server 配置指南

K8s MCP Server 是一個用於簡化 Kubernetes 操作的工具，它支持通過自然語言交互，執行 kubectl 命令、部署 Helm Chart、管理 Istio 服務網格和 ArgoCD 應用等功能。

🚀 快速開始

使用以下命令啟動 K8s MCP Server：

docker run -i --rm ghcr.io/alexei-led/k8s-mcp-server:latest

通過自然語言與 MCP 服務器交互，例如：

flowchart TB
    User->MCP_Server: "顯示默認命名空間中的所有 pod"
    MCP_Server->K8s_API: kubectl get pods -n default
    K8s_API->MCP_Server: 返回 pod 列表
    MCP_Server->User: 顯示結果並進行解釋

✨ 主要特性

K8s MCP Server 支持以下功能：

• kubectl 命令執行：通過自然語言理解 (NLU) 解析用戶意圖並執行相應的 kubectl 命令。
• Helm Chart 部署：自動解析 Helm 圖表並生成部署命令。
• Istio 服務網格管理：支持 Istio 服務網格的配置和狀態檢查。
• ArgoCD 應用管理：集成 ArgoCD 進行應用交付和版本控制。

💻 使用示例

基本交互

查詢集群信息

flowchart TB
    subgraph "Basic Commands"
        A1["顯示默認命名空間中的所有 pod"]
        A2["獲取所有命名空間中的服務"]
        A3["顯示 nginx pod 的日誌"]
    end

故障排除

flowchart TB
    subgraph "故障排查"
        B1["為什麼我的部署沒有啟動？"]
        B2["描述失敗的 pod 並解釋錯誤原因"]
        B3["檢查我的服務是否正確連接到 pod"]
    end

高級配置

指定目標集群和命名空間

在 config.json 中添加以下配置：

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-e", "K8S_CONTEXT=production-cluster",
        "-e", "K8S_NAMESPACE=my-application",
        "-e", "K8S_MCP_TIMEOUT=600",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

連接到 AWS EKS 集群

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-v", "/Users/YOUR_USER_NAME/.aws:/home/appuser/.aws:ro",
        "-e", "AWS_PROFILE=production",
        "-e", "AWS_REGION=us-west-2",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

連接到 Azure Kubernetes Service (AKS)

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-e", "K8S_CONTEXT=aks-cluster",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

啟用日誌記錄

在 config.json 中添加以下內容以啟用調試模式：

{
  "logging": {
    "level": "debug",
    "file": "mcp_server.log"
  }
}

🔒 安全注意事項

• 認證：通過 Kubernetes 服務賬號或 IAM 角色進行身份驗證。
• 授權：使用 RBAC 策略限制 MCP Server 的訪問權限。
• 網絡隔離：將 MCP Server 部署在受信任的網絡環境中。

📄 許可證

本項目遵循 MIT 許可證，具體條款如下：

版權所有 (c) 2023, Alexei Ledovskoi
Permission is granted to use, modify and distribute this software under the MIT License.

📞 聯繫方式

• GitHub：alexei-ledovskoi/k8s-mcp-server
• 郵件：support@k8s-mcp-server.com
• 社區論壇：Discussions