Kubeli Kubernetes MCP服务器

关键词

Kubernetes管理IDE集成集群资源管理AI辅助运维跨平台桌面应用

项目简介

Kubeli是一款现代化的跨平台桌面Kubernetes管理工具，支持多集群实时监控、资源浏览、日志流、终端访问等功能。其内置的MCP服务器模块基于Model Context Protocol，实现了通过标准化JSON-RPC协议向IDE客户端提供Kubernetes集群的上下文信息和操作工具，支持多种传输方式（如stdio），方便集成与扩展。

主要功能点

  • 支持通过MCP协议对外暴露Kubernetes集群相关资源的读取和操作接口
  • 提供丰富的Kubernetes资源访问能力（Pods、Deployments、Services、Events等）
  • 支持工具调用，如获取Pod日志、执行命令等Kubernetes操作
  • 实现了上下文管理，支持多集群切换和连接状态管理
  • 集成AI助手支持（如Claude Code CLI和OpenAI Codex CLI）
  • 支持主流IDE的MCP客户端配置，包括VS Code、Claude Code、Codex和Cursor
  • 会话管理和权限控制，确保操作安全
  • 提供完善的日志管理和实时流功能
  • 使用Rust和TypeScript编写，保证稳定性和现代化开发体验

安装步骤

  1. 克隆仓库并进入项目目录： 
    git clone https://github.com/atilladeniz/Kubeli.git
cd Kubeli
  2. 安装依赖：
    • 需要 Node.js 18+、Rust 1.70+和pnpm或npm
    • 运行 'make install' 安装项目依赖
  3. 构建：
    • 开发模式：运行 'make dev' 启动开发服务器，可快速热重载
    • 生产构建：
      • macOS：运行 'make build'
      • Windows（macOS交叉编译）：运行 'make install-windows-build-deps'（一次性），然后 'make build-windows'
      • 同时构建所有平台：'make build-all'

MCP服务器配置

MCP服务器启动方式为执行Kubeli可执行文件并带上'--mcp'参数，示例如下：

{
  "name": "kubeli",
  "command": "/path/to/kubeli",
  "args": ["--mcp"]
}
  • name：MCP服务器名称，建议为"kubeli"
  • command：Kubeli可执行文件的完整路径。开发模式下可使用当前执行路径，生产环境常见路径如macOS的'/Applications/Kubeli.app/Contents/MacOS/Kubeli'，Windows的安装目录路径
  • args：启动参数，必须包含'--mcp'，告诉Kubeli以MCP服务器模式运行

基本使用方法

  1. 启动Kubeli MCP服务器：
    • 使用上述配置在对应IDE中添加MCP服务器，启动Kubeli进程
  2. 连接Kubernetes集群：
    • MCP服务器自动读取本地kubeconfig，支持多源配置与合并模式
    • IDE客户端可以通过MCP协议调用资源读取和操作工具
  3. 使用工具：
    • IDE客户端通过调用定义的工具接口获取Pods列表、日志、部署状态等
    • 可执行操作如获取资源YAML、流式日志、启动交互式终端等
  4. 管理会话和权限：
    • 支持会话管理及权限审批，提升操作安全性
  5. AI集成功能（可选）：
    • 搭配Claude Code或OpenAI Codex CLI，实现AI辅助的Kubernetes管理

更多详细说明和功能请参考项目README及源码文档。

服务器信息

访问项目