Kubernetes MCP Server 🚀

Overview

基本能力

产品定位

Kubernetes MCP Server 是一个用于 Kubernetes 集群的 AI 交互工具，旨在通过自然语言简化 Kubernetes 操作和管理。

核心功能

🔍 检索和分析集群资源
📈 监控部署、Pod 和服务
🛠️ 通过 AI 接口执行常见的 kubectl 操作
🔧 使用 AI 辅助排查集群问题

适用场景

开发者通过自然语言与 Kubernetes 集群交互
运维人员监控和管理集群状态
AI 工具集成 Kubernetes 操作

工具列表

资源操作 📦

get_pod - 获取特定 Pod 的详细信息
list_pods - 列出命名空间中的 Pod
get_pod_logs - 获取 Pod 日志
get_deployment - 获取部署信息
list_deployments - 列出命名空间中的部署
scale_deployment - 扩展部署
get_service - 获取服务信息
list_services - 列出命名空间中的服务
get_configmap - 获取 ConfigMap 信息
list_configmaps - 列出命名空间中的 ConfigMap
list_namespaces - 列出集群中的所有命名空间
list_nodes - 列出集群中的所有节点

管理操作 ⚙️

delete_pod - 从命名空间中删除 Pod

常见问题解答

默认情况下，服务器应用提供的 kubeconfig 或服务账户的权限
可以创建具有受限 RBAC 权限的专用服务账户
可以设置命名空间限制以防止跨命名空间操作
可以启用只读模式以防止对集群状态的更改

使用教程

使用依赖

具有 API 访问权限的 Kubernetes 集群
有效的 kubeconfig 文件或服务账户凭据
所需操作的适当 RBAC 权限

安装教程

与 Claude Desktop 一起使用

在 Claude Desktop 配置文件中添加以下内容：

{
  "mcpServers": {
    "kubernetes": {
      "command": "path/to/k8smcp",
      "args": [
        "stdio",
        "--kubeconfig=/path/to/your/kubeconfig"
      ],
      "env": {
        "KUBECONFIG": "/path/to/your/kubeconfig"
      }
    }
  }
}

与 VS Code 一起使用

在 VS Code 用户设置文件中添加以下内容：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kubeconfig_path",
        "description": "Path to kubeconfig file",
        "default": "${env:HOME}/.kube/config"
      }
    ],
    "servers": {
      "kubernetes": {
        "command": "path/to/k8smcp",
        "args": [
          "stdio",
          "--kubeconfig=/path/to/your/kubeconfig"
        ],
        "env": {
          "KUBECONFIG": "${input:kubeconfig_path}"
        }
      }
    }
  }
}

从源代码构建

git clone https://github.com/briankscheong/k8s-mcp-server.git
cd k8s-mcp-server
make build

或直接使用 Go 安装：

go install github.com/briankscheong/k8s-mcp-server/cmd/k8s-mcp-server@latest

调试方式

启动 stdio 服务器进行调试：

k8smcp stdio --kubeconfig=/path/to/your/kubeconfig

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。