MCP Kubernetes Server

MCP开发工具

提供方 feiskyer

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 ClaudeCursor
查看接入方式

A Model Context Protocol (MCP) server that enables AI assistants to interact with Kubernetes clusters. It serves as a bridge between AI tools (like Claude, Cursor, and GitHub Copilot) and Kubernetes, translating natural language requests into Kubernetes operations and returning the results in a format the AI tools can understand.

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

developer-toolskubernetesmcpclaudemcp-serverKubernetes管理Python混合部署

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run -m src.mcp_kubernetes_server.main

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Kubernetes Server当前 未标注 stdio · 本地进程 本地部署 有 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

mcp kubernetes服务器

这 mcp-kubernetes-server 是一个实现模型上下文协议(MCP)的服务器,使AI助手(如Claude、Cursor和GitHub Copilot)能够与Kubernetes集群交互。它充当桥梁,将来自这些助手的自然语言请求转换为Kubernetes操作并返回结果。

它允许AI助手:

  • 查询Kubernetes资源
  • 执行kubectl命令
  • 通过自然语言交互管理Kubernetes集群
  • 诊断和解释Kubernetes资源的状态

运作原理

如何安装

先决条件

安装前 mcp-kubernetes-server,确保您拥有以下内容:

  • 一个工作的Kubernetes集群。
  • A. kubeconfig 文件已正确配置以访问Kubernetes集群(服务器需要此文件进行交互)。
  • 这 kubectl 命令行工具已安装并位于系统的PATH中(服务器用于执行许多Kubernetes命令)。
  • 这 helm 命令行工具已安装并位于系统的PATH中(由服务器用于Helm chart操作)。
  • Python>=3.11,如果你打算直接使用 uvx (没有Docker)。

码头工人

获取Kubernetes集群的kubeconfig文件,并在mcpServers中进行设置(将src路径替换为kubeconfig路径):```json
{
"mcpServers": {
"kubernetes": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount", "type=bind,src=/home/username/.kube/config,dst=/home/mcp/.kube/config",
"ghcr.io/feiskyer/mcp-kubernetes-server"
]
}
}
}


### UVX

使用以下命令运行服务器 `uvx` (随附的工具 `uv`Python打包器),首先确保 `uv` 已安装:

Install uv

安装 紫外线 如果尚未安装,请将其添加到PATH中,例如使用curl:```bash
# For Linux and MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh

Install kubectl

安装 kubectl 如果尚未安装,请将其添加到PATH中,例如。```bash

For Linux

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"

For MacOS

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"


Install helm

安装 舵 如果尚未安装,请将其添加到PATH中,例如。```bash
curl -sSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

在中配置MCP服务器 克劳德桌面, 光标, ChatGPT 副驾驶, Github Copilot 以及其他受支持的AI客户端,例如。```json
{
"mcpServers": {
"kubernetes": {
"command": "uvx",
"args": [
"mcp-kubernetes-server"
],
"env": {
"KUBECONFIG": ""
}
}
}
}


### MCP服务器选项

Environment Variables

**环境变量:**

- `KUBECONFIG`:kubeconfig文件的路径,例如。 `/home//.kube/config`.

Command line arguments

**命令行参数:**```sh
usage: main.py [-h] [--disable-kubectl] [--disable-helm] [--disable-write]
[--disable-delete] [--transport {stdio,sse,streamable-http}]
[--host HOST] [--port PORT]

MCP Kubernetes Server

options:
-h, --help            show this help message and exit
--disable-kubectl     Disable kubectl command execution
--disable-helm        Disable helm command execution
--disable-write       Disable write operations
--disable-delete      Disable delete operations
--transport {stdio,sse,streamable-http}
Transport mechanism to use (stdio or sse or streamable-http)
--host HOST           Host to use for sse or streamable-http server
--port PORT           Port to use for sse or streamable-http server

用法

一旦 mcp-kubernetes-server 在您的AI客户端中安装和配置(使用Docker或UVX的“如何安装”部分中提供的JSON片段),您可以通过自然语言开始与Kubernetes集群交互。例如,你可以问:```txt
What is the status of my Kubernetes cluster?

What is wrong with my nginx pod?


**验证服务器:** 如果您正在运行服务器 `stdio` 运输(通用 `uvx` AI客户端通常将启动并管理服务器进程。对于 `sse` 或 `streamable-http` 传输时,服务器独立运行。您本可以手动启动它(例如。, `uvx mcp-kubernetes-server --transport sse`)并且应该在终端中看到输出,指示它正在运行(例如。, `INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)`).如果AI客户端无法连接,您还可以检查服务器终端中的任何错误消息。

## 可用工具

mcp kubernetes服务器提供了一套全面的与kubernetes集群交互的工具,按操作类型分类:

Command Tools

### 命令工具

这些工具提供一般命令执行功能:

|工具|说明|参数|
|------|-------------|------------|
| **kubectl** |运行任何kubectl命令并返回输出| `command` (字符串)|
| **舵** |运行任何helm命令并返回输出| `command` (字符串)|

Read Tools

### 阅读工具

这些工具提供对Kubernetes资源的只读访问:

|工具|说明|参数|
|------|-------------|------------|
| **k8s_get** |获取任何Kubernetes对象(或列表)作为JSON字符串| `resource` (字符串), `name` (字符串), `namespace` (字符串)|
| **k8s_describes** |显示特定资源或资源组的详细信息| `resource_type` (字符串), `name` (字符串,可选), `namespace` (字符串,可选), `selector` (字符串,可选), `all_namespaces` (布尔值,可选)|
| **k8s_logs** |打印pod中容器的日志| `pod_name` (字符串), `container` (字符串,可选), `namespace` (字符串,可选), `tail` (整数,可选), `previous` (布尔值,可选), `since` (字符串,可选), `timestamps` (布尔值,可选), `follow` (布尔值,可选)|
| **k8s_事件** |列出集群中的事件| `namespace` (字符串,可选), `all_namespaces` (布尔值,可选), `field_selector` (字符串,可选), `resource_type` (字符串,可选), `resource_name` (字符串,可选), `sort_by` (字符串,可选), `watch` (布尔值,可选)|
| **k8s_api** |列出Kubernetes集群中的所有可用API |无|
| **k8s_crds** |列出Kubernetes集群中的所有自定义资源定义(CRD)|无|
| **k8s_top_nodes** |显示节点的资源使用情况(CPU/内存)| `sort_by` (字符串,可选)|
| **k8s_top_pods** |显示Pod的资源使用情况(CPU/内存)| `namespace` (字符串,可选), `all_namespaces` (布尔值,可选), `sort_by` (字符串,可选), `selector` (字符串,可选)|
| **k8s_推出状态** |获取部署、守护进程启动或状态集的卷展状态| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选)|
| **k8s_推出历史** |获取部署、守护进程启动或状态集的推出历史记录| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选), `revision` (字符串,可选)|
| **k8s_auth_can_i** |检查是否允许某个操作| `verb` (字符串), `resource` (字符串), `subresource` (字符串,可选), `namespace` (字符串,可选), `name` (字符串,可选)|
| **k8s_auth_woami** |显示您当前身份验证为|none的主题|

Write Tools

### 写入工具

这些工具为Kubernetes资源提供创建、更新或补丁操作:

|工具|说明|参数|
|------|-------------|------------|
| **k8s_create** |从YAML/JSON内容创建Kubernetes资源| `yaml_content` (字符串), `namespace` (字符串,可选)|
| **k8s_apply** |按文件名或stdin将配置应用于资源| `yaml_content` (字符串), `namespace` (字符串,可选)|
| **k8s_曝光** |将资源作为新的Kubernetes服务公开| `resource_type` (字符串), `name` (字符串), `port` (整数), `target_port` (整数,可选), `namespace` (字符串,可选), `protocol` (字符串,可选), `service_name` (字符串,可选), `labels` (对象,可选), `selector` (字符串,可选), `type` (字符串,可选)|
| **k8s_run** |在pod中创建并运行特定图像| `name` (字符串), `image` (字符串), `namespace` (字符串,可选), `command` (数组,可选), `env` (对象,可选), `labels` (对象,可选), `restart` (字符串,可选)|
| **k8s_set_resources** |设置容器的资源限制和请求| `resource_type` (字符串), `resource_name` (字符串), `namespace` (字符串,可选), `containers` (数组,可选), `limits` (对象,可选), `requests` (对象,可选)|
| **k8s_set_image** |设置容器的图像| `resource_type` (字符串), `resource_name` (字符串), `container` (字符串), `image` (字符串), `namespace` (字符串,可选)|
| **k8s_set_env** |为容器设置环境变量| `resource_type` (字符串), `resource_name` (字符串), `container` (字符串), `env_dict` (对象), `namespace` (字符串,可选)|
| **k8s_推出\_ ndo** |撤消部署、守护进程启动或状态集的卷展栏| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选), `to_revision` (字符串,可选)|
| **k8s_rollout_restart** |重新启动部署、守护进程启动或状态集的卷展栏| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选)|
| **k8s_推出_使用** |暂停部署、守护进程启动或状态集的推出| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选)|
| **k8s_推出_总结** |恢复部署、守护进程启动或状态集的推出| `resource_type` (字符串), `name` (字符串), `namespace` (字符串,可选)|
| **k8s_刻度** |扩展资源| `resource_type` (字符串), `name` (字符串), `replicas` (整数), `namespace` (字符串,可选)|
| **k8s_自动缩放** |自动缩放部署、副本集、有状态集或复制控制器| `resource_type` (字符串), `name` (字符串), `min` (整数), `max` (整数), `namespace` (字符串,可选), `cpu_percent` (整数,可选)|
| **k8s_警戒线** |将节点标记为不可调度| `node_name` (字符串)|
| **k8s_解锁** |将节点标记为可调度| `node_name` (字符串)|
| **k8s_排水管** |排空节点,为维护做准备| `node_name` (字符串), `force` (布尔值,可选), `ignore_daemonsets` (布尔值,可选), `delete_local_data` (布尔值,可选), `timeout` (整数,可选)|
| **k8s_污染** |更新一个或多个节点上的污染| `node_name` (字符串), `key` (字符串), `value` (字符串,可选), `effect` (字符串)|
| **k8s_取消打印** |从节点中删除污点| `node_name` (字符串), `key` (字符串), `effect` (字符串,可选)|
| **k8s_exec_命令** |在容器中执行命令| `pod_name` (字符串), `command` (字符串), `container` (字符串,可选), `namespace` (字符串,可选), `stdin` (布尔值,可选), `tty` (布尔值,可选), `timeout` (整数,可选)|
| **k8s_port_forward** |将一个或多个本地端口转发到pod| `resource_type` (字符串), `name` (字符串), `ports` (阵列), `namespace` (字符串,可选), `address` (字符串,可选)|
| **k8s_cp** |在容器之间复制文件和目录| `src_path` (字符串), `dst_path` (字符串), `container` (字符串,可选), `namespace` (字符串,可选)|
| **k8s_patch** |更新资源的字段| `resource_type` (字符串), `name` (字符串), `patch` (对象), `namespace` (字符串,可选)|
| **k8s_标签** |更新资源上的标签| `resource_type` (字符串), `name` (字符串), `labels` (对象), `namespace` (字符串,可选), `overwrite` (布尔值,可选)|
| **k8s_注释** |更新资源上的注释| `resource_type` (字符串), `name` (字符串), `annotations` (对象), `namespace` (字符串,可选), `overwrite` (布尔值,可选)|

Delete Tools

### 删除工具

这些工具为Kubernetes资源提供删除操作:

|工具|说明|参数|
|------|-------------|------------|
| **k8s_delete** |按名称、标签选择器或命名空间中的所有资源删除资源| `resource_type` (字符串), `name` (字符串,可选), `namespace` (字符串,可选), `label_selector` (字符串,可选), `all_namespaces` (布尔值,可选), `force` (布尔值,可选), `grace_period` (整数,可选)|

## 发展

如何在本地运行项目:```sh
uv run -m src.mcp_kubernetes_server.main

如何检查MCP服务器请求和响应:sh npx @modelcontextprotocol/inspector uv run -m src.mcp_kubernetes_server.main

故障排除

以下是使用时遇到的一些常见问题及其解决方案 mcp-kubernetes-server:

问题: mcp-kubernetes-server 无法连接到Kubernetes集群或报告身份验证错误。
解决方案:

  • 确保您的 kubeconfig 文件配置正确,并指向预期的集群。
  • 验证您的路径 kubeconfig 文件在中正确指定 mcpServers 配置(对于Docker,确保挂载路径正确;对于 uvx,确保 KUBECONFIG 环境变量设置正确)。
  • 检查您的凭据 kubeconfig 具有在群集上执行操作所需的权限。您可以通过以下方式进行测试 kubectl 直接(例如。, kubectl get pods).

问题: kubectl 或 helm 命令返回错误,如“找不到命令”或被禁用。
解决方案:

  • 如果通过运行 uvx,确保 kubectl 和 helm 已安装在您的系统上,并在PATH中可用。有关安装指南,请参阅“先决条件”部分。
  • 如果您看到“不允许写入操作”或“不允许删除操作”之类的消息,则服务器可能已启动,并带有以下标志 --disable-kubectl, --disable-helm, --disable-write,或 --disable-delete。有关这些标志的详细信息,请查看服务器的启动命令和README中的“MCP服务器选项”部分。

问题: 我如何查看我的AI客户端和 mcp-kubernetes-server?
解决方案:

  • 您可以使用 @modelcontextprotocol/inspector “开发”一节中提到的工具: npx @modelcontextprotocol/inspector uv run -m src.mcp_kubernetes_server.main。这将显示正在交换的MCP消息。

问题: 服务器启动,但AI客户端无法连接。
解决方案:

  • 如果使用 stdio 传输(默认为 uvx 直接执行),确保您的AI客户端已配置为启动 mcp-kubernetes-server 命令正确。
  • 如果使用 sse 或 streamable-http 传输,确保在 mcp-kubernetes-server (例如。, --host 0.0.0.0 --port 8000)可以从您的AI客户端运行的位置访问。检查防火墙规则或网络配置问题。此外,请验证AI客户端是否配置了服务器的正确URL。

贡献

这个项目是开源的,可以在GitHub上找到 feiskyer/mcp kubernetes服务器 并根据 Apache许可证.

如果您想为该项目做出贡献,请遵循以下准则:

  1. 分叉存储库并将其克隆到本地计算机。
  2. 为您的更改创建一个新分支。
  3. 进行更改,并使用描述性提交消息进行提交。
  4. 将您的更改推送到您的分叉存储库。
  5. 打开对主存储库的拉取请求。

许可证

该项目根据Apache License 2.0获得许可。请参阅 许可证 文件以获取更多详细信息。

常见问题

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

在客户端按下面的安装命令接入:uv run -m src.mcp_kubernetes_server.main。装完在客户端配置里引用同一个包或端点。

MCP Kubernetes Server 怎么在 Claude、Cursor 里配置?

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

MCP Kubernetes Server 收费吗?

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

MCP Kubernetes Server 需要 API Key 吗?

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

MCP Kubernetes Server 支持哪些客户端?

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

MCP Kubernetes Server 能提供哪些能力?

资料显示能力标签包括 Kubernetes管理、Python、Claude、自然语言处理。具体工具清单以官方文档为准。

MCP Kubernetes Server 需要什么运行环境?

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

MCP Kubernetes Server 是本地还是远程?

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

热门专题

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

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