Kubectl MCP Tool

Kubectl MCP Tool

site icon
2025.04.17 358
PythonKubernetes 管理自然语言处理AI 助手集成开发效率
Kubectl MCP Tool 是一个基于 Model Context Protocol (MCP) 的 Kubernetes 服务,旨在通过自然语言处理技术,使 AI 助手(如 Claude、Cursor 等)能够与 Kubernetes 集群进行交互。该工具提供了丰富的 Kubernetes 操作功能,包括集群管理、资源操作、监控、安全审计等,并支持多种传输协议和 AI 助手集成。
View on GitHub

Overview

基本能力

产品定位

Kubectl MCP Tool 是一个 Kubernetes 集群管理工具,通过自然语言处理技术,使 AI 助手能够直接与 Kubernetes 集群交互,简化集群管理和操作流程。

核心功能

  1. Kubernetes 核心操作
  2. 连接 Kubernetes 集群
  3. 管理 Pods、Services、Deployments 和 Nodes
  4. 创建、删除和描述资源
  5. 获取 Pod 日志和 Kubernetes 事件
  6. 支持 Helm v3 操作
  7. 端口转发和部署扩展

  8. 自然语言处理

  9. 处理自然语言查询
  10. 上下文感知命令
  11. 智能命令构建
  12. 支持离线测试场景

  13. 监控与安全

  14. 集群健康监控
  15. 资源利用率跟踪
  16. RBAC 验证和安全审计
  17. 容器安全扫描

  18. 高级功能

  19. 多传输协议支持(stdio、SSE)
  20. 多 AI 助手集成
  21. 可扩展工具框架
  22. 自定义资源定义支持

适用场景

  • 通过自然语言快速管理 Kubernetes 集群
  • 自动化 Kubernetes 操作流程
  • 集群监控和故障诊断
  • 安全审计和合规检查

工具列表

  • kubectl-mcp-tool:核心工具,提供 Kubernetes 操作和 MCP 服务器功能
  • install.sh:自动安装脚本,配置 AI 助手集成
  • start_mcp_server.sh:启动 MCP 服务器的脚本

常见问题解答

  • JSON 解析问题:当前在 Claude、Cursor 和 Windsurf 中存在 JSON 解析问题,正在修复中。
  • 安装问题:确保 Python 3.9+ 和 kubectl 已安装并配置。

使用教程

使用依赖

  1. Python 3.9+bash python --version
  2. kubectl CLIbash kubectl version
  3. Kubernetes 集群访问权限bash kubectl cluster-info

安装教程

  1. 从 PyPI 安装bash pip install kubectl-mcp-tool
  2. 从 GitHub 安装开发版本bash pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
  3. 本地开发安装bash git clone https://github.com/rohitg00/kubectl-mcp-server.git cd kubectl-mcp-server pip install -e .

调试方式

  1. 验证安装bash kubectl-mcp --help
  2. 启动 MCP 服务器bash kubectl-mcp serve
  3. 测试 AI 助手集成
  4. 配置 Claude、Cursor 或 Windsurf 的 MCP 服务器设置
  5. 测试自然语言命令(如 "List all pods in the default namespace")

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。