Kubectl K8s MCP

MCP运维云端

提供方 bharathmadvar123

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

一个基于Model Context Protocol (MCP)的Kubernetes交互服务器,允许AI助手通过自然语言与Kubernetes集群进行交互。

一句话选型结论

按资料字段整理

Kubectl K8s MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Kubernetes管理Python本地部署自然语言处理AI集成集群监控安全审计

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install kubectl-mcp-tool

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Kubectl K8s MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bharathmadvar123上游标注的维护方 bharathmadvar123
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

Kubectl MCP服务器

Kubernetes的模型上下文协议(MCP)服务器,使Claude、Cursor等AI助手能够通过自然语言与Kubernetes集群进行交互。

🎥 现场演示-观看 kubectl-mcp-tool 与克劳德一起行动!

🎥 现场演示-观看 kubectl-mcp-tool 使用Cursor进行操作!

🎥 现场演示-观看 kubectl-mcp-tool 与Windsurf一起行动!

特性

Kubernetes核心操作

  • [x] 连接到Kubernetes集群
  • [x] 列出并管理Pod、服务、部署和节点
  • [x] 创建、删除和描述Pod和其他资源
  • [x] 获取pod日志和Kubernetes事件
  • [x] 支持Helm v3操作(安装、升级、卸载)
  • [x] kubectl说明和api资源支持
  • [x] 为下一个命令选择命名空间(内存持久性)
  • [x] 端口转发到Pod
  • [x] 扩展部署和状态集
  • [x] 在容器中执行命令
  • [x] 管理配置映射和机密
  • [x] 将部署回滚到以前的版本
  • [x] 入口和网络策略管理
  • [x] 集群之间的上下文切换

自然语言处理

  • [x] 处理kubectl操作的自然语言查询
  • [x] 具有先前操作记忆的上下文感知命令
  • [x] 对Kubernetes概念的人性化解释
  • [x] 基于意图的智能指挥构建
  • [x] 当专用工具不可用时,回退到kubectl
  • [x] 离线/测试场景的模拟数据支持
  • [x] 命名空间感知查询处理

监控

  • [x] 集群健康监测
  • [x] 资源利用率跟踪
  • [x] Pod状态和健康检查
  • [x] 事件监控和警报
  • [x] 节点容量和分配分析
  • [x] 历史绩效跟踪
  • [x] 通过kubectl top进行资源使用统计
  • [x] 容器准备状态和活性跟踪

安全

  • [x] RBAC验证和确认
  • [x] 安全上下文审核
  • [x] 与Kubernetes API的安全连接
  • [x] 凭证管理
  • [x] 网络策略评估
  • [x] 集装箱安全扫描
  • [x] 安全最佳实践执行
  • [x] 角色和集群角色管理
  • [x] ServiceAccount创建和绑定
  • [x] PodSecurityPolicy分析
  • [x] RBAC权限审核
  • [x] 安全上下文验证

诊断

  • [x] 集群诊断和故障排除
  • [x] 配置验证
  • [x] 错误分析和恢复建议
  • [x] 连接状态监控
  • [x] 日志分析和模式检测
  • [x] 资源约束识别
  • [x] Pod健康检查诊断
  • [x] 常见错误模式识别
  • [x] 对配置错误进行资源验证
  • [x] 详细的活性和准备状态探针验证

高级功能

  • [x] 支持多种传输协议(stdio、SSE)
  • [x] 与多个AI助手集成
  • [x] 可扩展的工具框架
  • [x] 自定义资源定义支持
  • [x] 跨命名空间操作
  • [x] 对多个资源进行批处理操作
  • [x] 智能资源关系映射
  • [x] 错误解释和恢复建议
  • [x] 卷管理和识别

建筑

模型上下文协议(MCP)集成

Kubectl MCP工具实现了 模型上下文协议(MCP),使AI助手能够通过标准化的接口与Kubernetes集群进行交互。该架构由以下部分组成:

  1. MCP服务器:处理来自MCP客户端(AI助手)请求的兼容服务器
  2. 工具注册表:使用模式将Kubernetes操作注册为MCP工具
  3. 传输层:支持stdio、SSE和HTTP传输方法
  4. 核心业务:将工具调用转换为Kubernetes API操作
  5. 响应格式化程序:将Kubernetes响应转换为符合MCP的响应

请求流

双模式操作

该工具以两种模式运行:

  1. 命令行接口命令模式:用于执行Kubernetes操作的直接命令行界面
  2. 服务器模式:作为MCP服务器运行,以处理来自AI助手的请求

安装

有关详细的安装说明,请参阅 安装指南.

您可以直接从PyPI安装kubectl mcp工具:```bash
pip install kubectl-mcp-tool


对于特定版本:```bash
pip install kubectl-mcp-tool==1.1.1

该软件包在PyPI上可用: https://pypi.org/project/kubectl-mcp-tool/1.1.1/

先决条件

  • Python 3.9+
  • kubectl CLI已安装并配置
  • 访问Kubernetes集群
  • pip(Python包管理器)

全球安装```bash

Install latest version from PyPI

pip install kubectl-mcp-tool

Or install development version from GitHub

pip install git+https://github.com/rohitg00/kubectl-mcp-server.git


### 本地开发安装```bash
# Clone the repository
git clone https://github.com/rohitg00/kubectl-mcp-server.git
cd kubectl-mcp-server

# Install in development mode
pip install -e .

验证安装

安装后,验证工具是否正常工作:```bash
kubectl-mcp --help


注意:此工具旨在作为AI助手连接的MCP服务器工作,而不是作为kubectl的直接替代品。可用的主要命令是 `kubectl-mcp serve` 启动MCP服务器。

## Docker镜像

如果你更喜欢使用Docker,Docker Hub上有一个预构建的镜像:```bash
# Pull the latest image
docker pull rohitghumare64/kubectl-mcp-server:latest

运行图像

容器内的服务器监听端口 8000.将任意空闲主机端口绑定到8000并挂载kubeconfig:```bash

Replace 8081 with any free port on your host

Mount your local ~/.kube directory for cluster credentials

docker run -p 8081:8000 \
-v $HOME/.kube:/root/.kube \
rohitghumare64/kubectl-mcp-server:latest


- `-p 8081:8000` 映射主机端口8081→ 集装箱港口8000。
- `-v $HOME/.kube:/root/.kube` 挂载kubeconfig,以便服务器可以访问集群。

### 构建多架构映像(AMD64和ARM64)

如果你想构建和推送一个多拱形镜像(这样它就可以在x86_64和Apple Silicon上运行),请使用Docker Buildx:```bash
# Ensure Buildx and QEMU are installed once per machine
# docker buildx create --name multiarch --use
# docker buildx inspect --bootstrap

# Build and push for linux/amd64 and linux/arm64
# (replace  if you're publishing to your own registry)

docker buildx build \
--platform linux/amd64,linux/arm64 \
-t rohitghumare64/kubectl-mcp-server:latest \
--push .

发布的镜像将包含一个包含两种架构的清单列表,Docker将自动在每台机器上提取正确的变体。

配置

允许MCP服务器访问这些路径以读取Kubernetes配置:```yaml
run:
volumes:
- '{{kubectl-mcp-server.kubeconfig}}:/root/.kube'
config:
description: The MCP server is allowed to access this path
parameters:
type: object
properties:
kubeconfig:
type: string
default:
$HOME/.kube
required:
- kubeconfig


此配置允许用户将他们的kubeconfig目录添加到容器中,使MCP服务器能够通过他们的Kubernetes集群进行身份验证。

## 使用AI助手

### 使用MCP服务器

MCP服务器(`kubectl_mcp_tool.mcp_server`)是一个基于FastMCP SDK的强大实现,可在不同的AI助手之间提供增强的兼容性:

> **备注**:如果您在MCP Server实现中遇到任何错误,您可以通过替换来重新使用最小包装器 `kubectl_mcp_tool.mcp_server` 随着 `kubectl_mcp_tool.minimal_wrapper` 在您的配置中。最小包装器以更简单的实现提供基本功能。

1. **直接配置**```json
{
"mcpServers": {
"kubernetes": {
"command": "python",
"args": ["-m", "kubectl_mcp_tool.mcp_server"],
"env": {
"KUBECONFIG": "/path/to/your/.kube/config",
"PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
"MCP_LOG_FILE": "/path/to/logs/debug.log",
"MCP_DEBUG": "1"
}
}
}
}
  1. 关键环境变量
  • MCP_LOG_FILE:日志文件的路径(建议避免stdout污染)
  • MCP_DEBUG:设置为“1”以进行详细日志记录
  • MCP_TEST_MOCK_MODE:设置为“1”以使用模拟数据而不是真实集群
  • KUBECONFIG:Kubernetes配置文件的路径
  • KUBECTL_MCP_LOG_LEVEL:设置为“调试”、“信息”、“警告”或“错误”
  1. 测试MCP服务器
    您可以通过以下方式测试服务器是否正常工作:```bash
    python -m kubectl_mcp_tool.simple_ping

这将尝试连接到服务器并执行ping命令。

或者,您可以直接使用以下命令运行服务器:```bash
python -m kubectl_mcp_tool

克劳德桌面

将以下内容添加到您的Claude Desktop配置中 ~/Library/Application\ Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\mcp.json):```json
{
"mcpServers": {
"kubernetes": {
"command": "python",
"args": ["-m", "kubectl_mcp_tool.mcp_server"],
"env": {
"KUBECONFIG": "$HOME/.kube/config" // or whatever your path is for the config file
}
}
}
}


### 光标AI

通过添加新的全局MCP服务器,将以下内容添加到MCP下的Cursor AI设置中:```json
{
"mcpServers": {
"kubernetes": {
"command": "python",
"args": ["-m", "kubectl_mcp_tool.mcp_server"],
"env": {
"KUBECONFIG": "/path/to/your/.kube/config",
"PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin"
}
}
}
}

将此配置保存到 ~/.cursor/mcp.json 用于全局设置。

> 备注:替换 /path/to/your/.kube/config 带有kubeconfig文件的实际路径。在大多数系统中,这是 ~/.kube/config.

帆板运动

将以下内容添加到您的Windsurf配置中 ~/.config/windsurf/mcp.json (Windows: %APPDATA%\WindSurf\mcp.json):```json
{
"mcpServers": {
"kubernetes": {
"command": "python",
"args": ["-m", "kubectl_mcp_tool.mcp_server"],
"env": {
"KUBECONFIG": "/path/to/your/.kube/config"
}
}
}
}


### 自动配置

要自动配置所有支持的AI助手,请运行提供的安装脚本:```bash
bash install.sh

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Kubectl K8s MCP 怎么安装?

在客户端按下面的安装命令接入:pip install kubectl-mcp-tool。装完在客户端配置里引用同一个包或端点。

Kubectl K8s MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Kubectl K8s MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Kubectl K8s MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Kubectl K8s MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Kubectl K8s MCP 能提供哪些能力?

资料显示能力标签包括 Kubernetes管理、安全审计、Python、Claude。具体工具清单以官方文档为准。

Kubectl K8s MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Kubectl K8s MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。