Skip to main content
Glama

MCP Remote Server for Kubernetes

by huchunlinnk
GitHub
TypeScript
MIT License
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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 客户端支持

  • 🔧 自定义客户端: 提供多语言 SDK 和示例

  • 🌐 Web 应用: 支持浏览器直接访问

📋 系统要求

  • Node.js >= 18.0.0

  • Kubernetes 集群访问权限

  • Docker (可选，用于容器化部署)

🛠️ 安装和配置

1. 克隆项目

git clone <repository-url> cd mcp-remote-server-kubernetes

2. 安装依赖

npm install

3. 配置环境变量

复制环境变量模板并根据需要修改：

cp .env.example .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. 构建项目

npm run build

5. 启动服务

# 开发模式 npm run dev # 生产模式 npm start

🐳 Docker 部署

使用 Docker Compose

# 启动服务 docker-compose up -d # 查看日志 docker-compose logs -f # 停止服务 docker-compose down

手动 Docker 部署

# 构建镜像 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 部署

# 应用部署配置 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 服务器：

{ "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：

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 配置中：

{ "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. 自定义客户端集成

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 使用

认证

首先获取访问令牌：

curl -X POST http://localhost:3000/auth/login \ -H "Content-Type: application/json" \ -d '{ "username": "admin", "password": "admin123" }'

MCP 协议调用

使用获取的令牌调用 MCP 接口：

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

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "kubectl_get", "arguments": { "resource": "pods", "namespace": "default" } } }

示例：应用部署

{ "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 # 应用入口

开发命令

# 开发模式（热重载） 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. 日志审计: 启用详细的访问日志记录

📊 监控和日志

健康检查

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 环境变量

    • 检查端口是否被占用

调试模式

启用详细日志：

LOG_LEVEL=debug npm run dev

📞 支持

如有问题或建议，请：

  1. 查看 Issues 页面

  2. 创建新的 Issue

  3. 联系维护者

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides Kubernetes cluster management capabilities through natural language via MCP protocol over HTTP/SSE. Supports Pod, Service, Deployment operations, log retrieval, and resource management with JWT authentication and RBAC permissions.

  1. 🌟 核心优势
    1. 🚀 主要特性
      1. MCP 协议支持
      2. Kubernetes 集成
      3. 安全和认证
      4. 多平台支持
    2. 📋 系统要求
      1. 🛠️ 安装和配置
        1. 1. 克隆项目
        2. 2. 安装依赖
        3. 3. 配置环境变量
        4. 4. 构建项目
        5. 5. 启动服务
      2. 🐳 Docker 部署
        1. 使用 Docker Compose
        2. 手动 Docker 部署
      3. ☸️ Kubernetes 部署
        1. 🔌 多平台集成
          1. 支持的客户端平台
          2. 快速集成示例
        2. 📡 API 接口
          1. 支持的 MCP 方法
          2. 可用工具
          3. API 端点
        3. 📡 API 使用
          1. 认证
          2. MCP 协议调用
          3. 支持的工具
        4. 🔧 开发
          1. 项目结构
          2. 开发命令
        5. 🔒 安全考虑
          1. 📊 监控和日志
            1. 健康检查
            2. 日志配置
          2. 🤝 贡献
            1. 📄 许可证
              1. 🆘 故障排除
                1. 常见问题
                2. 调试模式
              2. 📞 支持

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/huchunlinnk/mcp-remote-server-kubernetes'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server