Kubernetes MCP服务器

连接到Kubernetes集群并对其进行管理。

什么是MCP服务器？

镜像概述和主要用途

Kubernetes MCP服务器是一个Docker镜像，旨在提供连接和管理Kubernetes集群的能力。通过集成多种Kubernetes管理工具和命令，该镜像支持资源操作、集群监控、Helm图表管理等核心功能，适用于通过容器化方式安全高效地执行Kubernetes集群管理任务。

核心功能和特性

基本信息

可用工具（22个）

使用场景和适用范围

适用场景

• Kubernetes集群日常管理（资源创建、删除、更新、查询）
• 容器化应用部署与维护（通过kubectl和Helm操作）
• 集群故障排查（日志获取、资源描述、节点状态管理）
• 多环境集群切换与上下文管理
• 自动化运维任务（如资源清理、滚动更新）

适用人员

• 开发人员：在本地或CI/CD环境中管理Kubernetes资源
• 运维工程师：执行集群日常运维和节点管理操作
• DevOps工程师：构建基于容器的Kubernetes管理工作流

详细使用方法和配置说明

Docker部署方案

1. 基础运行命令

通过Docker直接运行MCP服务器容器：

bash
docker run -i --rm mcp/kubernetes

2. 挂载Kubeconfig配置（推荐）

为使容器能够访问Kubernetes集群，需挂载本地Kubeconfig文件：

bash
docker run -i --rm \
  -v $HOME/.kube/config:/root/.kube/config \
  mcp/kubernetes

3. Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  kubernetes-mcp:
    image: mcp/kubernetes
    volumes:
      - $HOME/.kube/config:/root/.kube/config
    stdin_open: true
    tty: true

运行容器：

bash
docker-compose up -d

MCP环境配置示例

在MCP配置中集成该服务器：

json
{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "$HOME/.kube/config:/root/.kube/config",
        "mcp/kubernetes"
      ]
    }
  }
}

工具详情

工具：cleanup

清理所有受管理的资源

工具：exec_in_pod

在Kubernetes Pod或容器中执行命令并返回输出

工具：explain_resource

获取Kubernetes资源或字段的文档

此工具为只读，不会修改环境。

工具：install_helm_chart

安装Helm图表，支持标准和基于模板的安装方式

工具：kubectl_apply

从字符串或文件应用Kubernetes YAML清单

工具：kubectl_context

管理Kubernetes上下文 - 列出、获取或设置当前上下文

此工具为只读，不会修改环境。

工具：kubectl_create

使用多种方式（从文件或子命令）创建Kubernetes资源

工具：kubectl_delete

通过资源类型、名称、标签或清单文件删除Kubernetes资源

此工具可能执行破坏性更新。

工具：kubectl_describe

通过资源类型、名称和可选命名空间描述Kubernetes资源

此工具为只读，不会修改环境。

工具：kubectl_generic

执行任何kubectl命令，支持提供参数和标志

此工具可能执行破坏性更新。

工具：kubectl_get

通过资源类型、名称和可选命名空间获取或列出Kubernetes资源