Kubernetes MCP Remote Server

MCP运维云端

提供方 huchunlinnk

运维云端 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

基于 MCP 协议的 Kubernetes 管理服务器,提供远程访问和自然语言管理能力,适用于 AI 平台和应用程序。

一句话选型结论

按资料字段整理

Kubernetes MCP Remote Server 属于运维云端类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

Kubernetes管理TypeScript本地部署MCP协议远程访问自然语言处理AI集成

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -d \

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

部署与发布

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

监控与告警

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

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

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

服务器档案

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

详细介绍

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

MCP Remote Server for Kubernetes

🚀 通用远程 MCP 服务器 - 基于 MCP (Model Context Protocol) 协议的 Kubernetes 管理服务器,支持通过 HTTP/SSE 协议远程访问,为各种 AI 平台和应用程序提供 Kubernetes 集群的自然语言管理能力。

🌟 核心优势

  • 🔌 通用兼容性: 支持所有遵循 MCP 协议的客户端(Dify、Claude Desktop、自定义客户端等)
  • 🌐 远程访问: 通过 HTTP/SSE 协议提供远程 MCP 服务,无需本地部署
  • 🔒 企业级安全: JWT 认证、RBAC 权限控制、速率限制等安全机制
  • ☸️ 完整 K8s 支持: 涵盖 Pod、Service、Deployment 等资源的完整生命周期管理
  • 📊 生产就绪: 健康检查、结构化日志、错误处理、监控告警等企业特性

🚀 主要特性

MCP 协议支持

  • 标准协议: 完整实现 MCP 2024-11-05 协议规范
  • 多传输方式: 支持 HTTP POST 和 SSE (Server-Sent Events)
  • 实时通信: 支持双向通信和事件推送

Kubernetes 集成

  • API 代理: 通过代理模式提供完整的 Kubernetes API 访问
  • 资源管理: 支持 Pod、Service、Deployment、ConfigMap 等资源操作
  • 日志查看: 实时获取容器日志
  • 多集群: 支持集群内和集群外两种部署模式

安全和认证

  • JWT 认证: 基于 JSON Web Token 的安全认证
  • RBAC 权限: 细粒度的角色权限控制
  • 速率限制: 防止 API 滥用和 DDoS 攻击
  • 安全传输: 支持 HTTPS 和安全头部配置

多平台支持

  • 🤖 Dify: 完整的 Dify 平台集成支持
  • 💬 Claude Desktop: 原生 MCP 客户端支持
  • 🌐 Web 应用: 支持浏览器直接访问

📋 系统要求

  • Node.js >= 18.0.0
  • Kubernetes 集群访问权限
  • Docker (可选,用于容器化部署)

🛠️ 安装和配置

1. 克隆项目```bash

git clone
cd mcp-remote-server-kubernetes


### 2. 安装依赖```bash
npm install

3. 配置环境变量

复制环境变量模板并根据需要修改:```bash
cp .env.example .env


主要配置项:```env
# 服务器配置
PORT=3000
HOST=0.0.0.0

# Kubernetes 配置
KUBECONFIG=/path/to/your/kubeconfig
K8S_IN_CLUSTER=false
K8S_NAMESPACE=default

# 认证配置
AUTH_ENABLED=true
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=24h

# 日志配置
LOG_LEVEL=info
LOG_CONSOLE=true

4. 构建项目```bash

npm run build


### 5. 启动服务```bash
# 开发模式
npm run dev

# 生产模式
npm start

🐳 Docker 部署

使用 Docker Compose```bash

启动服务

docker-compose up -d

查看日志

docker-compose logs -f

停止服务

docker-compose down


### 手动 Docker 部署```bash
# 构建镜像
docker build -t mcp-kubernetes-server .

# 运行容器
docker run -d \
--name mcp-kubernetes-server \
-p 3000:3000 \
-v ~/.kube/config:/app/.kube/config:ro \
-e AUTH_ENABLED=true \
-e JWT_SECRET=your-secret-key \
mcp-kubernetes-server

☸️ Kubernetes 部署```bash

应用部署配置

kubectl apply -f k8s/deployment.yaml

检查部署状态

kubectl get pods -l app=mcp-kubernetes-server

查看服务

kubectl get svc mcp-kubernetes-server


## 🔌 多平台集成

### 支持的客户端平台

| 平台 | 状态 | 集成方式 | 文档链接 |
|------|------|----------|----------|
| 🤖 **Dify** | ✅ 完全支持 | HTTP MCP | Dify 集成指南 |
| 💬 **Claude Desktop** | ✅ 完全支持 | 标准 MCP | MCP 客户端集成 |
| 🔧 **自定义客户端** | ✅ 完全支持 | HTTP/SSE API | API 文档 |
| 🌐 **Web 应用** | ✅ 完全支持 | REST API | 使用示例 |

### 快速集成示例

#### 1. Dify 平台集成

在 Dify 中配置 MCP 服务器:```json
{
"name": "Kubernetes MCP Server",
"endpoint": "http://your-server:3000/mcp",
"auth": {
"type": "bearer",
"token": "YOUR_JWT_TOKEN"
},
"capabilities": ["tools"]
}

自然语言使用示例:
- "显示默认命名空间中的所有 Pod"
- "部署一个 nginx 应用,使用 3 个副本"
- "获取 nginx Pod 的最近 100 行日志"
- "删除名为 test-pod 的 Pod"

2. Claude Desktop 集成

创建 MCP 客户端代理脚本 mcp-client-proxy.js:```javascript
const axios = require('axios');

const serverUrl = process.env.MCP_SERVER_URL;
const token = process.env.MCP_AUTH_TOKEN;

process.stdin.on('data', async (data) => {
try {
const message = JSON.parse(data.toString());
const response = await axios.post(serverUrl, message, {
headers: {
'Content-Type': 'application/json',
'Authorization': Bearer ${token}
}
});
console.log(JSON.stringify(response.data));
} catch (error) {
console.log(JSON.stringify({
jsonrpc: '2.0',
id: message?.id || null,
error: { code: -32603, message: error.message }
}));
}
});


然后在 Claude Desktop 配置中:```json
{
"mcpServers": {
"kubernetes": {
"command": "node",
"args": ["mcp-client-proxy.js"],
"env": {
"MCP_SERVER_URL": "http://your-server:3000/mcp",
"MCP_AUTH_TOKEN": "YOUR_JWT_TOKEN"
}
}
}
}

3. 自定义客户端集成```javascript

class MCPKubernetesClient {
constructor(serverUrl, token) {
this.serverUrl = serverUrl;
this.token = token;
this.requestId = 1;
}

async callTool(name, arguments) {
const message = {
jsonrpc: '2.0',
id: this.requestId++,
method: 'tools/call',
params: { name, arguments }
};

const response = await fetch(this.serverUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': Bearer ${this.token}
},
body: JSON.stringify(message)
});

return response.json();
}

async getPods(namespace = 'default') {
return this.callTool('kubectl_get', {
resource: 'pods',
namespace
});
}
}

// 使用示例
const client = new MCPKubernetesClient(
'http://your-server:3000/mcp',
'YOUR_JWT_TOKEN'
);

const pods = await client.getPods();
console.log(pods.result);


## 📡 API 接口

### 支持的 MCP 方法

| 方法 | 描述 | 参数 |
|------|------|------|
| `initialize` | 初始化连接 | 协议版本、客户端信息 |
| `tools/list` | 获取工具列表 | 无 |
| `tools/call` | 调用工具 | 工具名称、参数 |
| `resources/list` | 获取资源列表 | 无 |
| `prompts/list` | 获取提示列表 | 无 |

### 可用工具

| 工具名称 | 功能描述 | 必需参数 | 可选参数 |
|----------|----------|----------|----------|
| `kubectl_get` | 获取 K8s 资源 | `resource` | `namespace`, `name` |
| `kubectl_apply` | 应用配置 | `yaml` | `namespace` |
| `kubectl_delete` | 删除资源 | `resource`, `name` | `namespace` |
| `kubectl_logs` | 获取日志 | `pod` | `namespace`, `container`, `lines` |

### API 端点

- **认证**: `POST /auth/login`
- **MCP 协议**: `POST /mcp`
- **SSE 实时**: `GET /mcp/sse`
- **健康检查**: `GET /health`

## 📡 API 使用

### 认证

首先获取访问令牌:```bash
curl -X POST http://localhost:3000/auth/login \
-H "Content-Type: application/json" \
-d '{
"username": "admin",
"password": "admin123"
}'

MCP 协议调用

使用获取的令牌调用 MCP 接口:```bash
curl -X POST http://localhost:3000/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}'


### 支持的工具

- `kubectl_get`: 获取 Kubernetes 资源
- `kubectl_apply`: 应用资源配置
- `kubectl_delete`: 删除资源
- `kubectl_logs`: 获取 Pod 日志

#### 示例:获取 Pods```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kubectl_get",
"arguments": {
"resource": "pods",
"namespace": "default"
}
}
}

示例:应用部署```json

{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "kubectl_apply",
"arguments": {
"yaml": "apiVersion: v1\nkind: Pod\nmetadata:\n name: test-pod\nspec:\n containers:\n - name: nginx\n image: nginx:latest",
"namespace": "default"
}
}
}


## 🔧 开发

### 项目结构```
src/
├── auth/              # 认证相关
├── config/            # 配置管理
├── kubernetes/        # Kubernetes API 代理
├── middleware/        # 中间件
├── server/           # MCP 服务器实现
├── utils/            # 工具类
└── index.ts          # 应用入口

开发命令```bash

开发模式(热重载)

npm run watch

代码检查

npm run lint

修复代码格式

npm run lint:fix

运行测试

npm test

构建项目

npm run build


## 🔒 安全考虑

1. **更改默认密钥**: 生产环境中务必更改 `JWT_SECRET`
2. **RBAC 权限**: 根据需要调整 Kubernetes RBAC 权限
3. **网络安全**: 使用 HTTPS 和适当的网络策略
4. **速率限制**: 根据需要调整请求频率限制
5. **日志审计**: 启用详细的访问日志记录

## 📊 监控和日志

### 健康检查```bash
curl http://localhost:3000/health

日志配置

支持多种日志级别和输出格式:

  • LOG_LEVEL: error, warn, info, debug, verbose
  • LOG_FORMAT: combined, json, simple
  • LOG_FILE: 日志文件路径(可选)
  • LOG_CONSOLE: 控制台输出开关

🤝 贡献

  1. Fork 项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🆘 故障排除

常见问题

  1. Kubernetes 连接失败
    - 检查 KUBECONFIG 路径是否正确
    - 验证集群访问权限
    - 确认网络连接

  2. 认证失败
    - 检查 JWT 密钥配置
    - 验证令牌是否过期
    - 确认用户权限

  3. 端口冲突
    - 修改 PORT 环境变量
    - 检查端口是否被占用

调试模式

启用详细日志:bash LOG_LEVEL=debug npm run dev

📞 支持

如有问题或建议,请:

  1. 查看 Issues 页面
  2. 创建新的 Issue
  3. 联系维护者

注意: 这是一个开发版本,请在生产环境使用前进行充分测试。

常见问题

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

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

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

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

Kubernetes MCP Remote Server 收费吗?

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

Kubernetes MCP Remote Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Kubernetes MCP Remote Server 支持哪些客户端?

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

Kubernetes MCP Remote Server 能提供哪些能力?

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

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

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

Kubernetes MCP Remote Server 是本地还是远程?

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

热门专题

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

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