轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像
交易
充值流量¥8起我的订单
文档
工具
提交工单页面收录
kubernetes

mcp/kubernetes

mcp(Model Context Protocol)

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

19 次收藏下载次数: 0状态:社区镜像维护者:mcp(Model Context Protocol)仓库类型:镜像最近更新:2 个月前
让 AI 帮你使用轩辕镜像? · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这段话即可:

请先阅读并遵守:https://xuanyuan.cloud/agents.md

未读文档前不要生成 pull 命令或排错方案。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。

DockerHub 官方简介
轩辕镜像中文简介
下载命令
镜像标签列表与下载命令
使用轩辕镜像,把时间还给真正重要的事。
点击查看

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:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

登录 · 专属域名 · 配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest(架构)

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票(企业 / 个人)

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

轩辕镜像
mcp(Model Context Protocol)
...
mcp/kubernetes
定价查看流量套餐与价格
博客Docker 镜像公告与技术博客
专业版 · 高速稳定拉取镜像
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
50GB 仅 ¥8/年
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
用户协议·隐私政策·增值电信业务经营许可证:浙B2-20261007·©2024-2026 源码跳动©2024-2026 杭州源码跳动科技有限公司·商务合作:点击复制邮箱

更多相关 Docker 镜像与资源

以下是 mcp/kubernetes 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:

  • labring/kubernetes Docker 镜像说明(Kubernetes 容器镜像,适合 labring 维护的 Kubernetes 工作负载部署)
  • openeuler/kubernetes Docker 镜像说明(Kubernetes 容器镜像,适合 openeuler 维护的 Kubernetes 工作负载部署)
  • rancher/k8s Docker 镜像说明(Kubernetes 容器编排平台,Rancher 版本)
  • alpine/k8s Docker 镜像说明(Alpine 精简 Kubernetes 客户端/工具镜像,适合 CI 与集群运维脚本)
  • bitnamicharts/cert-manager Docker 镜像说明(Cert Manager 容器镜像,适合 bitnamicharts 维护的 Cert Manager 工作负载部署)

更多 kubernetes 镜像推荐

rancher/kubernetes logo

rancher/kubernetes

rancher
暂无描述
2 次收藏1万+ 次下载
6 年前更新
openeuler/kubernetes logo

openeuler/kubernetes

openeuler
官方Kubernetes Docker镜像,由openEuler CloudNative SIG维护,支持amd64和arm64多架构,适用于在openEuler系统上部署Kubernetes集群,提供控制平面和工作节点组件。
5.2千+ 次下载
2 个月前更新
kubernetes/pause logo

kubernetes/pause

kubernetes
用于从备份恢复kubernetes/pause镜像,保障Kubernetes集群中作为Pod网络命名空间基础容器的pause镜像可恢复性。
17 次收藏1000万+ 次下载
7 年前更新
jelastic/kubernetes logo

jelastic/kubernetes

jelastic
由Jelastic PaaS维护的Kubernetes服务器镜像,具备基于负载的预配置资源优化、定期更新及安全补丁,专为高级Kubernetes Cluster包设计,用于创建可靠且自动扩展的容器化工作负载和服务管理平台。
500万+ 次下载
2 个月前更新
baselibrary/kubernetes logo

baselibrary/kubernetes

baselibrary
ThoughtWorks提供的Kubernetes Docker镜像,包含1.1.2版本,用于在Docker环境中部署和运行Kubernetes相关组件。
8 次收藏10万+ 次下载
9 年前更新
radhikagupta5/kubernetes logo

radhikagupta5/kubernetes

radhikagupta5
Testing Kubernetes with AzureStack changes.
1 次收藏10万+ 次下载
8 年前更新

查看更多 kubernetes 相关镜像