MCP K8s

MCP运维云端

提供方 silenceper

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

A Kubernetes MCP (Model Control Protocol) server that enables interaction with Kubernetes clusters through MCP tools.

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

developer-toolskubernetesmcpdebugmcp-serverKubernetes管理Go混合部署

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
mcp-k8s -kubeconfig /Users/demo/.kube/config -enable-create -enable-delete -enable-update {}

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

mcp-k8s

Kubernetes MCP(模型控制协议)服务器,通过MCP工具实现与Kubernetes集群的交互。

特性

  • 查询支持的Kubernetes资源类型(内置资源和CRD)
  • 具有细粒度控制的Kubernetes资源操作
  • 读取操作:获取资源详细信息,按类型列出具有过滤选项的资源
  • 写入操作:创建、更新和删除资源(每个都可以独立启用/禁用)
  • 支持所有Kubernetes资源类型,包括自定义资源
  • 使用kubeconfig连接到Kubernetes集群
  • Helm支持细粒度控制
  • Helm发布管理(列表、获取、安装、升级、卸载)
  • Helm存储库管理(列表、添加、删除)
  • 每个操作都可以独立启用/禁用

预览

> 通过光标进行交互

用例

1.通过LLM进行Kubernetes资源管理

  • 交互式资源管理:通过与LLM的自然语言交互来管理Kubernetes资源,无需记住复杂的kubectl命令
  • 批量操作:用自然语言描述复杂的批处理操作要求,让LLM将其转化为特定的资源操作
  • 资源状态查询:使用自然语言查询集群资源状态,并接收易于理解的响应

2.自动化操作场景

  • 智能运营助理:作为操作员在日常集群管理任务中的智能助手
  • 问题诊断:通过自然语言问题描述协助进行集群问题诊断
  • 配置审查:利用LLM的理解能力来帮助审查和优化Kubernetes资源配置

3.开发和测试支持

  • 快速原型验证:开发人员可以通过自然语言快速创建和验证资源配置
  • 环境管理:简化测试环境资源管理,快速创建、修改和清理测试资源
  • 配置生成:根据需求描述自动生成遵循最佳实践的资源配置

4.教育和培训方案

  • 互动学习:新手可以通过自然语言交互学习Kubernetes的概念和操作
  • 最佳实践指南:法学硕士在资源运营期间提供最佳实践建议
  • 错误解释:在操作失败时提供易于理解的错误解释和纠正建议

建筑

1.工程概况

一个基于stdio的MCP服务器,连接到Kubernetes集群并提供以下功能:

  • 查询Kubernetes资源类型(包括内置资源和CRD)
  • Kubernetes资源上的CRUD操作(具有可配置的写入操作)
  • Helm操作用于发布和存储库管理

2.技术栈

  • 去
  • mcp走 软件开发工具包
  • Kubernetes客户端go库
  • Helm v3客户端库
  • 通信标准

3.核心部件

  1. MCP服务器:使用mcp-go mcp-k8s 用于创建基于stdio的MCP服务器的包
  2. K8s客户端:使用客户端go连接到Kubernetes集群
  3. Helm客户端:使用Helm v3库进行Helm操作
  4. 工具实施:为不同的Kubernetes操作实现各种MCP工具

4.可用工具

资源类型查询工具

  • get_api_resources:获取群集中所有支持的API资源类型

资源操作工具

  • get_resource:获取特定资源的详细信息
  • list_resources:列出资源类型的所有实例
  • create_resource:创建新资源(可以禁用)
  • update_resource:更新现有资源(可以禁用)
  • delete_resource:删除资源(可以禁用)

Helm操作工具

  • list_helm_releases:列出集群中的所有Helm版本
  • get_helm_release:获取特定Helm版本的详细信息
  • install_helm_chart:安装Helm chart(可以禁用)
  • upgrade_helm_chart:升级Helm版本(可以禁用)
  • uninstall_helm_chart:卸载Helm版本(可以禁用)
  • list_helm_repositories:列出已配置的Helm存储库
  • add_helm_repository:添加新的Helm存储库(可以禁用)
  • remove_helm_repository:删除Helm存储库(可以禁用)

用法

mcp-k8s支持三种通信模式:

1.标准模式(默认)

在stdio模式下,mcp-k8s通过标准输入/输出流与客户端通信。这是默认模式,适用于大多数用例。```bash

Run in stdio mode (default)

{
"mcpServers":
{
"mcp-k8s":
{
"command": "/path/to/mcp-k8s",
"args":
[
"--kubeconfig",
"/path/to/kubeconfig",
"--enable-create",
"--enable-delete",
"--enable-update",
"--enable-list",
"--enable-helm-install",
"--enable-helm-upgrade"
]
}
}
}


### 2.SSE模式

在SSE(服务器发送事件)模式下,mcp-k8s向mcp客户端公开HTTP端点。
您可以在远程服务器上部署该服务(但需要注意安全性)```bash
# Run in SSE mode
./bin/mcp-k8s --kubeconfig=/path/to/kubeconfig --transport=sse --port=8080 --host=localhost --enable-create --enable-delete --enable-list --enable-update --enable-helm-install
# This command will open all operations

mcp配置```json
{
"mcpServers": {
"mcp-k8s": {
"url": "http://localhost:8080/sse",
"args": []
}
}
}


SSE模式配置:

- `--transport`:设置为“sse”以启用sse模式
- `--port`:HTTP服务器端口(默认值:8080)
- `--host`:HTTP服务器主机(默认:“localhost”)

### 3.流式HTTP模式

在Streamable HTTP模式下,mcp-k8s公开了一个支持直接HTTP响应和SSE流的HTTP端点。此模式提供了更好的灵活性,并支持流式输出。```bash
# Run in Streamable HTTP mode
./bin/mcp-k8s --kubeconfig=/path/to/kubeconfig --transport=streamable-http --port=8080 --host=localhost --endpoint-path=/mcp --enable-create --enable-delete --enable-list --enable-update --enable-helm-install

mcp配置```json
{
"mcpServers": {
"mcp-k8s": {
"url": "http://localhost:8080/mcp",
"args": []
}
}
}


流式HTTP模式配置:

- `--transport`:设置为“streamable http”以启用streamable http模式
- `--port`:HTTP服务器端口(默认值:8080)
- `--host`:HTTP服务器主机(默认:“localhost”)
- `--endpoint-path`:MCP服务器的端点路径(默认值:“/MCP”)

### 4.Docker环境

#### SSE模式

1. 完整示例
假设您的映像名为mcp-k8s,您需要映射端口并设置环境参数,您可以运行:```bash
docker run --rm -p 8080:8080 -i -v ~/.kube/config:/root/.kube/config ghcr.io/silenceper/mcp-k8s:latest --transport=sse

流式HTTP模式```bash

docker run --rm -p 8080:8080 -i -v ~/.kube/config:/root/.kube/config ghcr.io/silenceper/mcp-k8s:latest --transport=streamable-http --endpoint-path=/mcp


#### stdio模式```json
{
"mcpServers": {
"mcp-k8s": {
"command": "docker",
"args": [
"run",
"-i",
"-v",
"~/.kube/config:/root/.kube/config",
"--rm",
"ghcr.io/silenceper/mcp-k8s:latest"
]
}
}
}

入门指南

直接使用

您可以直接从以下网址下载适用于您平台的二进制文件 发布页面 并立即使用。

去安装```bash

go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest


### 构建

#### 使用Makefile(推荐)

Makefile会自动从version文件中注入版本信息:```bash
git clone https://github.com/silenceper/mcp-k8s.git
cd mcp-k8s
make build

这将使用通过ldflags注入的版本信息构建。

直接构建```bash

git clone https://github.com/silenceper/mcp-k8s.git
cd mcp-k8s
go build -o bin/mcp-k8s cmd/mcp-k8s/main.go


注意:直接构建将显示版本为“dev”,除非您手动指定ldflags。

### 命令行参数

你可以使用 `mcp-k8s --help` 查看所有可用选项,或 `mcp-k8s --version` 检查版本。

#### Kubernetes资源操作

- `--kubeconfig`:Kubernetes配置文件的路径(如果未指定,则使用默认配置)
- `--enable-create`:启用资源创建操作(默认值:false)
- `--enable-update`:启用资源更新操作(默认值:false)
- `--enable-delete`:启用资源删除操作(默认值:false)
- `--enable-list`:启用资源列表操作(默认值:true)

#### Helm操作

- `--enable-helm-release-list`:启用Helm发布列表操作(默认值:true)
- `--enable-helm-release-get`:启用Helm release-get操作(默认值:true)
- `--enable-helm-install`:启用Helm chart安装(默认值:false)
- `--enable-helm-upgrade`:启用Helm chart升级(默认值:false)
- `--enable-helm-uninstall`:启用Helm chart卸载(默认值:false)
- `--enable-helm-repo-list`:启用Helm存储库列表操作(默认值:true)
- `--enable-helm-repo-add`:启用Helm存储库添加操作(默认值:false)
- `--enable-helm-repo-remove`:启用Helm存储库删除操作(默认值:false)

#### 传输配置

- `--transport`:传输类型(stdio、sse或可流式传输的http)(默认值:“stdio”)
- `--host`:HTTP传输主机(SSE或流式HTTP)(默认:“localhost”)
- `--port`:用于HTTP传输的TCP端口(SSE或流式HTTP)(默认值:8080)
- `--endpoint-path`:可流式HTTP传输的端点路径(默认值:“/mcp”)

#### 版本信息

- `--version`:显示版本信息,包括版本、提交哈希和生成日期
- `--help` 或 `-h`:显示帮助信息

### 测试流式HTTP

要测试Streamable HTTP模式是否正常工作,您可以使用提供的测试脚本:```bash
# Start the server in one terminal
./bin/mcp-k8s --transport=streamable-http --port=8080 --enable-list

# In another terminal, run the test script
./test_streamable_http.sh

有关详细的测试说明,请参阅 TEST_REAMALE_HTTP.md.

与MCP客户端集成

mcp-k8s是一个基于stdio的mcp服务器,可以与任何兼容mcp的LLM客户端集成。有关集成说明,请参阅MCP客户的文档。

安全考虑

  • 通过独立的配置开关严格控制写入操作
  • 使用RBAC确保K8s客户端只有必要的权限
  • 验证所有用户输入以防止注入攻击
  • Helm操作遵循相同的安全原则,默认启用读取操作,默认禁用写入操作

关注微信公众号

常见问题

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

在客户端按下面的安装命令接入:mcp-k8s -kubeconfig /Users/demo/.kube/config -enable-create -enable-delete -enable-update {}。装完在客户端配置里引用同一个包或端点。

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

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

MCP K8s 收费吗?

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

MCP K8s 需要 API Key 吗?

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

MCP K8s 能提供哪些能力?

资料显示能力标签包括 Kubernetes管理、自动化运维、Go。具体工具清单以官方文档为准。

MCP K8s 需要什么运行环境?

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

MCP K8s 是本地还是远程?

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

热门专题

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

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