MKP MCP

MCP运维云端

提供方 StacklokLabs

运维云端 HTTP · 远程 无需鉴权 社区 / 第三方

MKP是一个用于Kubernetes的模型上下文协议(MCP)服务器,允许LLM驱动的应用程序通过MCP协议与Kubernetes集群交互,提供资源列表、获取、应用和执行命令等功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

KubernetesGo本地部署模型上下文协议LLM集成集群管理资源操作

安装与配置

HTTP · 远程 无需鉴权
连远程 HTTPS 端点,通常为 Streamable HTTP
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

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

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

MKP-Kubernetes的Kontext协议服务器模型

MKP是Kubernetes的模型上下文协议(MCP)服务器,允许
LLM驱动的应用程序与Kubernetes集群交互。它提供工具
用于通过MCP协议列出和应用Kubernetes资源。

特性

  • 列出Kubernetes API服务器支持的资源
  • 列出群集资源
  • 列出命名空间资源
  • 获取资源及其子资源(包括状态、规模、日志等)
  • 应用(创建或更新)群集资源
  • 应用(创建或更新)命名空间资源
  • 在带有超时控制的Pod中执行命令
  • 使用API机械的非结构化客户端的通用和可插拔实现
  • 内置速率限制,可防止API调用过多

为什么选择MKP?

MKP作为模型上下文协议服务器提供了几个关键优势
库贝内特斯:

原生Go实现

  • 使用与Kubernetes本身相同的语言构建
  • 服务器应用程序的卓越性能特性
  • 强大的类型安全和并发支持
  • 与Kubernetes库无缝集成

API直接集成

  • 直接使用Kubernetes API机器,无需外部依赖
  • 不依赖kubectl、helm或其他CLI工具
  • 与Kubernetes API服务器直接通信
  • 减少开销,提高可靠性

通用资源支持

  • 通过非结构化客户端使用任何Kubernetes资源类型
  • 不需要硬编码的资源模式或专门的处理程序
  • 自动支持自定义资源定义(CRD)
  • 面向未来的新Kubernetes资源

极简设计

  • 专注于核心Kubernetes资源操作
  • 干净、可维护的代码库,关注点明确分离
  • 轻量级,依赖性最小
  • 易于理解、扩展和贡献

生产就绪架构

  • 专为生产环境中的可靠性和性能而设计
  • 正确的错误处理和资源管理
  • 内置速率限制,以防止过多的API调用
  • 具有全面单元测试的可测试设计
  • 遵循Kubernetes开发最佳实践

先决条件

  • 转到1.24或更高版本
  • Kubernetes集群和kubeconfig
  • 任务 用于运行任务

安装

  1. 克隆存储库:```bash
    git clone https://github.com/StacklokLabs/mkp.git
    cd mkp

1. 安装依赖项:```bash
task install
  1. 构建服务器:```bash
    task build

## 用法

### 运行服务器

要使用默认kubeconfig运行服务器:```bash
task run

要使用特定的kubeconfig运行服务器:```bash
KUBECONFIG=/path/to/kubeconfig task run-with-kubeconfig


要在特定端口上运行服务器,请执行以下操作:```bash
MCP_PORT=9091 task run

使用ToolHive运行

MKP可以作为模型上下文协议(MCP)服务器运行,使用
ToolHive,这简化了
MCP服务器的部署和管理。

请参阅
ToolHive文档 为了
关于如何使用ToolHive UI、CLI或
Kubernetes操作员。

MCP工具

MKP服务器提供以下MCP工具:

获取资源

获取Kubernetes资源或其子资源。

参数:

  • resource_type (必填):要获取的资源类型(集群或命名空间)
  • group:API组(例如,应用程序、网络.k8s.io)
  • version (必需):API版本(例如,v1、v1beta1)
  • resource (必填):资源名称(例如,部署、服务)
  • namespace:命名空间(命名空间资源所需)
  • name (必填):要获取的资源的名称
  • subresource:要获取的子资源(例如,状态、规模、日志)
  • parameters:请求的可选参数(见下面的示例)

例子:```json
{
"name": "get_resource",
"arguments": {
"resource_type": "namespaced",
"group": "apps",
"version": "v1",
"resource": "deployments",
"namespace": "default",
"name": "nginx-deployment",
"subresource": "status"
}
}


从具有参数的特定容器中获取日志的示例:```json
{
"name": "get_resource",
"arguments": {
"resource_type": "namespaced",
"group": "",
"version": "v1",
"resource": "pods",
"namespace": "default",
"name": "my-pod",
"subresource": "logs",
"parameters": {
"container": "my-container",
"sinceSeconds": "3600",
"timestamps": "true",
"limitBytes": "102400"
}
}
}

pod日志的可用参数:

  • container:指定从哪个容器获取日志
  • previous:从上一个容器实例获取日志(true/false)
  • sinceSeconds:仅返回比相对持续时间(秒)新的日志
  • sinceTime:仅在特定时间后返回日志(RFC3339格式)
  • timestamps:每行包含时间戳(真/假)
  • limitBytes:要返回的最大字节数
  • tailLines:从日志末尾返回的行数

默认情况下,pod日志限制为最后100行和32KB,以避免
淹没了LLM的上下文窗口。这些默认值可以使用以下命令覆盖
上面的参数。

经常资源的可用参数:

  • resourceVersion:指定时,显示该特定位置的资源
    版本

列表_资源

列出特定类型的Kubernetes资源。

参数:

  • resource_type (必填):要列出的资源类型(集群或命名空间)
  • group:API组(例如,应用程序、网络.k8s.io)
  • version (必需):API版本(例如,v1、v1beta1)
  • resource (必填):资源名称(例如,部署、服务)
  • namespace:命名空间(命名空间资源所需)
  • label_selector:用于过滤资源的Kubernetes标签选择器(可选)
  • include_annotations:是否在输出中包含注释(默认值:
    真的)
  • exclude_annotation_keys:要从输出中排除的注释键列表
    (支持带*的通配符)
  • include_annotation_keys:输出中要包含的注释键列表(如果
    指定,仅包括这些)
注释筛选

这 list_resources 该工具提供了强大的注释过滤功能
控制元数据输出大小,防止大数据截断问题
注释(如GPU节点注释)。

基本用法:```json
{
"name": "list_resources",
"arguments": {
"resource_type": "namespaced",
"group": "apps",
"version": "v1",
"resource": "deployments",
"namespace": "default"
}
}


**排除特定注释(对GPU节点有用):**```json
{
"name": "list_resources",
"arguments": {
"resource_type": "clustered",
"group": "",
"version": "v1",
"resource": "nodes",
"exclude_annotation_keys": [
"nvidia.com/*",
"kubectl.kubernetes.io/last-applied-configuration"
]
}
}

仅包括特定注释:```json
{
"name": "list_resources",
"arguments": {
"resource_type": "namespaced",
"group": "",
"version": "v1",
"resource": "pods",
"namespace": "default",
"include_annotation_keys": ["app", "version", "prometheus.io/scrape"]
}
}


**完全禁用注释以获得最佳性能:**```json
{
"name": "list_resources",
"arguments": {
"resource_type": "namespaced",
"group": "",
"version": "v1",
"resource": "pods",
"namespace": "default",
"include_annotations": false
}
}

注释筛选规则:

  • 默认情况下, kubectl.kubernetes.io/last-applied-configuration 被排除在外
    防止大配置数据
  • exclude_annotation_keys 支持使用通配符模式 * (例如。,
    nvidia.com/* 排除所有NVIDIA注释)
  • 当 include_annotation_keys 如果已指定,则优先且仅
    包括这些注释
  • 设置 include_annotations: false 从中完全删除所有注释
    输出
  • 通配符模式仅支持 * 在密钥的末尾(例如。,
    nvidia.com/*)

应用程序_资源

应用(创建或更新)Kubernetes资源。

参数:

  • resource_type (必填):要应用的资源类型(群集或
    命名空间)
  • group:API组(例如,应用程序、网络.k8s.io)
  • version (必需):API版本(例如,v1、v1beta1)
  • resource (必填):资源名称(例如,部署、服务)
  • namespace:命名空间(命名空间资源所需)
  • manifest (必需):资源清单

例子:```json
{
"name": "apply_resource",
"arguments": {
"resource_type": "namespaced",
"group": "apps",
"version": "v1",
"resource": "deployments",
"namespace": "default",
"manifest": {
"apiVersion": "apps/v1",
"kind": "Deployment",
"metadata": {
"name": "nginx-deployment",
"namespace": "default"
},
"spec": {
"replicas": 3,
"selector": {
"matchLabels": {
"app": "nginx"
}
},
"template": {
"metadata": {
"labels": {
"app": "nginx"
}
},
"spec": {
"containers": [
{
"name": "nginx",
"image": "nginx:latest",
"ports": [
{
"containerPort": 80
}
]
}
]
}
}
}
}
}
}


#### post_resource

发布到Kubernetes资源或其子资源的帖子,特别适用于
在Pod中执行命令。

参数:

- `resource_type` (必填):要发布的资源类型(集群或
命名空间)
- `group`:API组(例如,应用程序、网络.k8s.io)
- `version` (必需):API版本(例如,v1、v1beta1)
- `resource` (必填):资源名称(例如,部署、服务)
- `namespace`:命名空间(命名空间资源所需)
- `name` (必填):要发布的资源名称
- `subresource`:要发布的子资源(例如exec)
- `body` (必填):将正文发布到资源
- `parameters`:请求的可选参数

在pod中执行命令的示例:```json
{
"name": "post_resource",
"arguments": {
"resource_type": "namespaced",
"group": "",
"version": "v1",
"resource": "pods",
"namespace": "default",
"name": "my-pod",
"subresource": "exec",
"body": {
"command": ["ls", "-la", "/"],
"container": "my-container",
"timeout": 30
}
}
}

这 body for pod exec支持以下字段:

  • command (必填):要执行的命令,可以是字符串或数组
    字符串
  • container (可选):在其中执行命令的容器名称(默认为
    第一个容器)
  • timeout (可选):超时时间(秒)(默认为15秒,最多60秒
    秒)

关于超时的注意事项:

  • 默认超时:如果未指定,则为15秒
  • 最长超时时间:60秒(任何较大的值都将被限制)
  • 超过超时的命令将被终止并返回超时错误

响应包括stdout、stderr和任何错误消息:```json
{
"apiVersion": "v1",
"kind": "Pod",
"metadata": {
"name": "my-pod",
"namespace": "default"
},
"spec": {
"command": ["ls", "-la", "/"]
},
"status": {
"stdout": "total 48\ndrwxr-xr-x 1 root root 4096 May 5 14:30 .\ndrwxr-xr-x 1 root root 4096 May 5 14:30 ..\n...",
"stderr": "",
"error": ""
}
}


### MCP资源

MKP服务器通过MCP资源提供对Kubernetes资源的访问。
资源URI遵循以下格式:

- 集群资源: `k8s://clustered/{group}/{version}/{resource}/{name}`
- 命名空间资源:
`k8s://namespaced/{namespace}/{group}/{version}/{resource}/{name}`

### 配置

#### 传输协议

MKP支持MCP服务器的两种传输协议:

- **流式HTTP**:默认传输协议,适用于大多数用例
- **SSE(服务器发送事件)**:传统传输协议,主要用于与旧客户端的兼容性

您可以使用CLI标志或
环境变量:```bash
# Using CLI flag
./build/mkp-server --transport=sse

# Using environment variable
MCP_TRANSPORT=sse ./build/mkp-server

# Default (Streamable HTTP)
./build/mkp-server

这 MCP_TRANSPORT 环境变量在以下情况下由ToolHive自动设置
在该环境中运行MKP。

控制资源发现

默认情况下,MKP将所有Kubernetes资源作为MCP资源提供,这提供了
LLM的有用上下文。然而,在拥有许多资源的大型集群中
可能会占用LLM中的大量上下文空间。

您可以使用以下命令禁用此行为 --serve-resources 标志:```bash

Run without serving cluster resources

./build/mkp-server --serve-resources=false

Run with a specific kubeconfig without serving cluster resources

./build/mkp-server --kubeconfig=/path/to/kubeconfig --serve-resources=false


即使禁用了资源发现,MCP工具(`get_resource`,
`list_resources`, `apply_resource`, `delete_resource`,以及 `post_resource`)
保持完全功能,允许您与Kubernetes集群交互。

#### 启用写入操作

默认情况下,MKP以只读模式运行,这意味着它不允许写入
集群上的操作,即 `apply_resource`, `delete_resource`,以及
`post_resource` 工具将不可用。您可以通过以下方式启用写入操作
使用 `--read-write` 标志:```bash
# Run with write operations enabled
./build/mkp-server --read-write=true

# Run with a specific kubeconfig and write operations enabled
./build/mkp-server --kubeconfig=/path/to/kubeconfig --read-write=true

速率限制

MKP包括一个内置的速率限制机制,以保护服务器免受
过多的API调用,这在与AI代理一起使用时尤为重要。
速率限制器使用令牌桶算法并应用不同的限制
根据操作类型:

  • 读取操作(list_resources,get_source):每分钟120个请求
  • 写入操作(apply_resource、delete_resource):每分钟30个请求
  • 其他操作的默认值:每分钟60个请求

每个客户端会话都应用速率限制,确保公平的资源分配
跨多个客户。可以启用或禁用速率限制功能
通过命令行标志:```bash

Run with rate limiting enabled (default)

./build/mkp-server

Run with rate limiting disabled

./build/mkp-server --enable-rate-limiting=false


## 发展

### 运行测试```bash
task test

格式化代码```bash

task fmt


### Linting代码```bash
task lint

更新依赖项```bash

task deps
```

贡献

我们欢迎对MCP服务器的贡献!如果你想捐款,请
审查 贡献指南 有关如何获取的详细信息
起动。

如果您遇到错误或有功能请求,请
打开一个问题 在存储库中或
加入我们 #mcp-servers 我们的频道
社区Discord服务器.

许可证

此项目在Apache v2许可证下获得许可-请参阅License文件
细节。

常见问题

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

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

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

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

MKP MCP 收费吗?

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

MKP MCP 需要 API Key 吗?

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

MKP MCP 能提供哪些能力?

资料显示能力标签包括 集群管理、Kubernetes、模型集成、资源管理。具体工具清单以官方文档为准。

MKP MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

MKP MCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

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

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