rohitghumare64/kubectl-mcp-server

kubectl-mcp-server镜像说明

镜像概述

kubectl-mcp-server是一款允许AI助手通过自然语言对话控制整个Kubernetes基础设施的工具。您可以像与DevOps专家交流一样与集群交互，完成调试崩溃pod、优化成本、部署应用、审计安全、管理Helm图表、可视化仪表盘等操作。该工具属于CNCF生态系统，与Terraform并列。

核心功能

• 自然语言交互：通过AI助手的自然语言指令管理K8s集群，无需记忆kubectl命令。
• AI驱动诊断：智能排查pod崩溃原因，提供日志、事件分析及可行动建议。
• 成本优化：识别资源浪费，给出成本节省建议。
• 安全审计：分析RBAC权限、扫描秘密安全及检查pod安全策略。
• 多AI助手兼容：支持Claude、Cursor、Windsurf、Copilot等15+主流AI工具。
• 可视化仪表盘：提供交互式HTML仪表盘，展示实时指标和事件时间线。
• 多集群支持：通过上下文参数管理多个K8s集群。
• 企业级特性：支持OAuth 2.1认证、RBAC验证、非破坏性模式及秘密掩码。

使用场景

1. 故障排查：通过自然语言查询pod崩溃原因、网络连通性问题。
2. 应用部署：快速创建、缩放或回滚应用部署。
3. 成本优化：分析资源使用情况，识别闲置资源。
4. 安全审计：检查集群中的RBAC权限和不安全配置。
5. 多集群管理：切换不同集群上下文，查看集群信息。

配置说明

Docker部署示例

拉取镜像

bash
# 从Docker Hub拉取
docker pull docker.xuanyuan.run/rohitghumare64/kubectl-mcp-server:latest
# 从GitHub Container Registry拉取
docker pull ***-ghcr.xuanyuan.run/rohitg00/kubectl-mcp-server:latest

运行镜像

标准stdio传输模式

bash
docker run -i -v $HOME/.kube:/root/.kube:ro docker.xuanyuan.run/rohitghumare64/kubectl-mcp-server:latest

HTTP传输模式

bash
docker run -p 8000:8000 -v $HOME/.kube:/root/.kube:ro docker.xuanyuan.run/rohitghumare64/kubectl-mcp-server:latest --transport sse

AI助手配置示例

Claude Desktop

添加到~/Library/Application Support/Claude/claude_desktop_config.json：

json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Cursor AI

添加到~/.cursor/mcp.json：

json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

GitHub Copilot (VS Code)

添加到VS Code settings.json：

json
{
  "mcp": {
    "servers": {
      "kubernetes": {
        "command": "npx",
        "args": ["-y", "kubectl-mcp-server"]
      }
    }
  }
}