Kubectl MCP

MCP运维云端

提供方 rkirkendall

运维云端 未标注 无需鉴权 社区 / 第三方

一个提供通过kubectl对Kubernetes集群进行只读访问的MCP服务器,明确禁止对Secrets的访问。

一句话选型结论

按资料字段整理

Kubectl MCP 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

KubernetesJavaScript本地部署只读访问安全控制MCP协议集群管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Kubectl MCP当前 未标注 未标注 未标注 无 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

服务器档案

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

详细介绍

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

kubectl MCP服务器

一个模型上下文协议(MCP)服务器,通过以下方式提供对Kubernetes集群的只读访问 kubectl,明确阻止Secrets访问。

特性

  • 只读操作:只允许使用安全的只读kubectl动词
  • 秘密被封锁:显式阻止对Kubernetes Secrets的任何访问
  • 壳牌保险箱:不允许使用shell元字符,防止命令注入
  • 可配置的:支持配置文件和环境变量
  • 优雅关闭:正确处理信号情报/信号

安装```bash

npm install


## 用法

### 作为HTTP MCP服务器

服务器作为HTTP服务器运行,可以通过网络访问:```bash
node index.js

默认情况下,服务器会监听 http://0.0.0.0:3005

配置

配置可以通过以下方式提供:

  1. 配置文件 (按顺序检查):
  • 中指定的路径 KUBECTL_MCP_CONFIG 环境变量
  • ./kubectl-mcp.json 在当前目录中
  • ~/.kubectl-mcp.json 在主目录中
  1. 环境变量:
  • KUBECTL_PATH -kubectl二进制文件的路径(默认: kubectl)
  • KUBECTL_MCP_LOG_LEVEL -日志级别:调试、信息、警告、错误、静默(默认值: info)
  • KUBECTL_MCP_CONFIG -配置文件的路径
  • PORT -HTTP服务器端口(默认值: 3005)
  • HOST -HTTP服务器主机(默认值: 0.0.0.0)

示例 kubectl-mcp.json:```json
{
"kubectlPath": "kubectl",
"logLevel": "info",
"port": 3005,
"host": "0.0.0.0",
"additionalResources": [],
"additionalFlags": []
}


### 使用MCP客户端(网络接入)

服务器公开以下HTTP端点:

- **发布 `/mcp`** -主MCP协议端点
- **获取 `/health`** -健康检查端点
- **获取 `/sse`** -用于流式传输的服务器发送事件端点

要通过网络从MCP客户端连接:```javascript
// Example connection
const mcpEndpoint = 'http://your-server-ip:3005/mcp';

// To list tools
const response = await fetch(mcpEndpoint, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'tools/list',
params: {}
})
});

// To call kubectl tool
const response = await fetch(mcpEndpoint, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
jsonrpc: '2.0',
id: 2,
method: 'tools/call',
params: {
name: 'kubectl',
arguments: {
command: 'get pods -n default'
}
}
})
});

可用工具

kubectl

执行只读kubectl命令。

输入:

  • command (string):kubectl命令为字符串(例如。, "get pods -n default")
  • 或 args (array):kubectl命令作为数组(例如。, ["get", "pods", "-n", "default"])

例子:```json
{
"name": "kubectl",
"arguments": {
"command": "get pods -n kube-system"
}
}


### `kubectl_status`

获取kubectl代理服务器的状态信息。

**例子:**```json
{
"name": "kubectl_status",
"arguments": {}
}

安全策略

允许的动词

  • get -获取资源
  • describe -描述资源
  • logs -查看容器日志
  • top -显示资源使用情况
  • api-resources -列出API资源
  • api-versions -列出API版本
  • cluster-info -显示集群信息
  • version -显示kubectl和Kubernetes版本
  • config view -查看kubeconfig(仅查看子命令)

受阻资源

  • secrets / secret -明确阻止
  • 名称中包含“secret”的任何资源

允许的资源

核心命名空间:

  • Pod、部署、状态集、守护进程、作业、cronjobs
  • 服务、端点、复制集、配置映射
  • 服务帐户、播客中断预算、网络策略
  • 租赁、事件、持续的财产索赔

核心集群范围:

  • 节点、命名空间、组件状态

自定义资源(CRD):

  • Traefik:入口路由、中间件、服务器端口
  • 证书管理器:证书、颁发者、集群颁发者、订单、挑战
  • Calico:ippools、bgppeers、bgp配置、felix配置、阻塞性
  • 自定义:endpointalias(根据需要扩展)

允许的标志

允许使用常见的只读标志:

  • 输出: -o, --output
  • 选择器: -l, --selector, --field-selector
  • 命名空间: -n, --namespace, -A, --all-namespaces
  • 观看: -w, --watch
  • 显示器: --show-labels, --show-kind, --no-headers
  • 日志: --tail, --since, --follow, -f, --previous, --timestamps
  • 集装箱: -c, --container
  • 其他: --context, --kubeconfig, --sort-by等等。

被拒旗帜

任何可能引发突变或危险操作的标志:

  • --force, --grace-period, --cascade
  • --dry-run, --field-manager, --overwrite
  • --patch, --prune, --filename, --from-file
  • --save-config, --record

附加保护

  • 不允许使用shell元字符(|, ;, &,回溯, >等等)
  • 无球形图案
  • 命令直接通过spawn执行,而不是通过shell执行
  • 所有命令都在启动环境中从启动目录执行

示例命令

有效命令```bash

Get all pods in default namespace

kubectl get pods

Get deployments with labels

kubectl get deployments -l app=nginx -n production

Describe a specific node

kubectl describe node worker-1

View logs with tail

kubectl logs my-pod -n default --tail=100 -f

Get resource usage

kubectl top nodes

List API resources

kubectl api-resources

View cluster info

kubectl cluster-info

Get services across all namespaces

kubectl get svc -A

Describe a certificate

kubectl describe certificate my-cert -n cert-manager


### 被拒绝的命令```bash
# Blocked: mutation verb
kubectl delete pod my-pod

# Blocked: accessing secrets
kubectl get secrets

# Blocked: applying changes
kubectl apply -f config.yaml

# Blocked: shell metacharacters
kubectl get pods | grep nginx

# Blocked: dangerous flag
kubectl get pods --force

发展

项目结构```

cluster-info-mcp/
├── index.js # Main MCP server
├── validator.js # Command validation logic
├── executor.js # kubectl command execution
├── config.js # Configuration management
├── package.json # Node.js dependencies
└── README.md # This file


### 日志记录

通过环境变量或配置文件设置日志级别:```bash
KUBECTL_MCP_LOG_LEVEL=debug node index.js

日志被写入stderr以避免干扰stdio协议。

故障排除

未找到kubectl

确保kubectl在您的PATH中或设置kubectl_PATH环境变量:```bash
export KUBECTL_PATH=/usr/local/bin/kubectl
node index.js


### 权限不足

确保脚本可执行:```bash
chmod +x index.js

连接问题

检查你的kubeconfig配置是否正确:bash kubectl config view kubectl cluster-info

许可证

麻省理工学院

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Kubectl MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Kubectl MCP 收费吗?

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

Kubectl MCP 需要 API Key 吗?

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

Kubectl MCP 能提供哪些能力?

资料显示能力标签包括 安全控制、集群管理、Kubernetes、只读访问、JavaScript。具体工具清单以官方文档为准。

热门专题

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

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