用于连接到Kubernetes集群并进行管理的Docker镜像

20 次收藏下载次数: 0状态:社区镜像维护者:mcp(Model Context Protocol)仓库类型:镜像最近更新:
下载命令
点击查看

Kubernetes MCP服务器

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

https://www.anthropic.com/news/model-context-protocol

镜像概述和主要用途

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

核心功能和特性

基本信息

属性详情
Docker镜像https://hub.docker.com/repository/docker/mcp/kubernetes
作者https://github.com/Flux159
代码仓库https://github.com/Flux159/mcp-server-kubernetes
Dockerfilehttps://github.com/Flux159/mcp-server-kubernetes/blob/main/Dockerfile
镜像构建方Docker Inc.
Docker Scout健康评分
验证签名COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/kubernetes --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
许可证MIT License

可用工具(22个)

服务器提供的工具简要描述
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资源
kubectl_logs从Pod、Deployment或Job等Kubernetes资源获取日志
kubectl_patch使用策略合并补丁、JSON合并补丁或JSON补丁更新资源的字段
kubectl_rollout管理资源的滚动更新(如Deployment、DaemonSet、StatefulSet)
kubectl_scale扩展Kubernetes Deployment
list_api_resources列出集群中可用的API资源
node_management通过cordon、drain和uncordon操作管理Kubernetes节点
ping验证对方是否仍响应且连接处于活动状态
port_forward将本地端口转发到Kubernetes资源上的端口
stop_port_forward停止端口转发进程
uninstall_helm_chart卸载Helm图表发布
upgrade_helm_chart升级现有Helm图表发布

使用场景和适用范围

适用场景

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

适用人员

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

详细使用方法和配置说明

Docker部署方案

1. 基础运行命令

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

bash
docker run -i --rm docker.xuanyuan.run/mcp/kubernetes

2. 挂载Kubeconfig配置(推荐)

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

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

3. Docker Compose配置

创建docker-compose.yml文件:

yaml
version: '3'
services:
  kubernetes-mcp:
    image: docker.xuanyuan.run/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或容器中执行命令并返回输出

参数类型描述
commandstring要在Pod中执行的命令(字符串或参数数组)
namestring要执行命令的Pod名称
containerstring可选,容器名称(当Pod有多个容器时必填)
contextstring可选,Kubeconfig上下文(默认null)
namespacestring可选,Kubernetes命名空间
shellstring可选,执行命令使用的Shell(如'/bin/sh')
timeoutnumber可选,命令超时时间(毫秒,默认60000)

工具:explain_resource

获取Kubernetes资源或字段的文档

参数类型描述
resourcestring资源名称或字段路径(如'pods'或'pods.spec.containers')
apiVersionstring可选,API版本(如'apps/v1')
contextstring可选,Kubeconfig上下文(默认null)
outputstring可选,输出格式(plaintext或plaintext-openapiv2)
recursiveboolean可选,递归打印字段的子字段

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

工具:install_helm_chart

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

参数类型描述
chartstring图表名称(如'nginx')或图表目录路径
namestringHelm发布名称
namespacestringKubernetes命名空间
contextstring可选,Kubeconfig上下文(默认null)
createNamespaceboolean可选,命名空间不存在时创建
repostring可选,Helm仓库URL(使用本地图表时可选)
useTemplateboolean可选,使用helm template + kubectl apply替代helm install(绕过认证问题)
valuesobject可选,覆盖图表默认值的自定义值
valuesFilestring可选,值文件路径(替代values对象)

工具:kubectl_apply

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

参数类型描述
contextstring可选,Kubeconfig上下文(默认null)
dryRunboolean可选,仅验证资源,不实际执行操作
filenamestring可选,要应用的YAML文件路径(二选一:manifest或filename)
forceboolean可选,强制删除资源并绕过优雅删除
manifeststring可选,要应用的YAML清单字符串
namespacestring可选,Kubernetes命名空间

工具:kubectl_context

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

参数类型描述
operationstring要执行的操作:列出上下文、获取当前上下文或设置当前上下文
detailedboolean可选,包含上下文的详细信息
namestring可选,要设置为当前的上下文名称(设置操作必填)
outputstring可选,输出格式
showCurrentboolean可选,列出上下文时高亮当前活动上下文

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

工具:kubectl_create

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

参数类型描述
annotationsarray可选,应用于资源的注解(如["key1=value1", "key2=value2"])
commandarray可选,容器中运行的命令
contextstring可选,Kubeconfig上下文(默认null)
dryRunboolean可选,仅验证资源,不实际执行操作
filenamestring可选,用于创建资源的YAML文件路径
fromFilearray可选,创建ConfigMap的文件路径(如["key1=/path/to/file1"])
fromLiteralarray可选,创建ConfigMap的键值对(如["key1=value1"])
imagestring可选,Deployment中容器使用的镜像
labelsarray可选,应用于资源的标签(如["key1=value1"])
manifeststring可选,用于创建资源的YAML清单字符串
namestring可选,要创建的资源名称
namespacestring可选,Kubernetes命名空间
outputstring可选,输出格式(json|yaml|name等)
portnumber可选,容器暴露的端口
replicasnumber可选,Deployment的副本数
resourceTypestring可选,要创建的资源类型(namespace、configmap等)
schedulestring可选,CronJob的调度表达式(如"*/5 * * * *")
secretTypestring可选,Secret类型(generic、docker-registry、tls)
serviceTypestring可选,Service类型(clusterip、nodeport等)
suspendboolean可选,是否暂停CronJob
tcpPortarray可选,TCP服务的端口对(如["80:8080"])
validateboolean可选,是否验证资源 schema 与服务器 schema

工具:kubectl_delete

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

参数类型描述
namestring要删除的资源名称
namespacestringKubernetes命名空间
resourceTypestring要删除的资源类型(如pods、deployments)
allNamespacesboolean可选,是否跨所有命名空间删除资源
contextstring可选,Kubeconfig上下文(默认null)
filenamestring可选,用于删除资源的YAML文件路径
forceboolean可选,立即从API删除资源并绕过优雅删除
gracePeriodSecondsnumber可选,资源优雅终止的秒数
labelSelectorstring可选,删除匹配标签选择器的资源(如'app=nginx')
manifeststring可选,定义要删除资源的YAML清单字符串

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

工具:kubectl_describe

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

参数类型描述
namestring要描述的资源名称
resourceTypestring要描述的资源类型(如pods、deployments)
allNamespacesboolean可选,是否跨所有命名空间描述资源
contextstring可选,Kubeconfig上下文(默认null)
namespacestring可选,Kubernetes命名空间

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

工具:kubectl_generic

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

参数类型描述
commandstring要执行的kubectl命令(如patch、rollout)
argsarray可选,额外命令参数
contextstring可选,Kubeconfig上下文(默认null)
flagsobject可选,命令标志(键值对)
namestring可选,资源名称
namespacestring可选,Kubernetes命名空间
outputFormatstring可选,输出格式(如json、yaml、wide)
resourceTypestring可选,资源类型(如pod、deployment)
subCommandstring可选,子命令(如rollout的'history')

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

工具:kubectl_get

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

参数类型描述
namestring可选,资源名称(未提供则列出指定类型所有资源)
namespacestringKubernetes命名空间
resourceTypestring要获取的资源类型(如pods、deployments)
allNamespacesboolean可选,是否跨所有命名空间列出资源
contextstring可选,Kubeconfig上下文(默认null)
fieldSelectorstring可选,按字段选择器筛选资源(如'metadata.name=my-pod')
labelSelectorstring可选,按标签选择器筛选资源(如'app=nginx')
outputstring可选,输出格式
sortBystring可选,事件排序

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 kubernetes 镜像标签

docker pull docker.xuanyuan.run/mcp/kubernetes:<标签>

DockerHub 原生拉取命令

docker pull mcp/kubernetes:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告