Kubernetes MCP Server

基本能力

产品定位

mcp-kubernetes-server 是一个专为 Kubernetes 集群管理设计的轻量级 MCP 服务器，通过自然语言处理和 API 提供便捷的集群操作。

核心功能

• 自然语言接口：将普通英语查询转换为 kubectl 命令
• 列出所有命名空间中的 pod 和 deployment
• 对于不支持的查询，回退到一般资源列表
• 完整的 CRUD 操作：
• 创建/删除命名空间、pod 和 deployment
• 检查集群资源
• 修改标签、注释和部署配置
• 优雅删除
• 扩展部署
• 双执行模式：
• kubectl 命令集成
• Kubernetes Python 客户端（官方 SDK）
• 高级功能：
• 命名空间验证（DNS-1123 兼容）
• 标签过滤
• 优雅期控制
• 自动命令回退
• 资源管理（CPU、内存）
• 环境变量配置

适用场景

• 通过自然语言快速查询 Kubernetes 集群状态
• 自动化 Kubernetes 资源管理
• 与 AI 助手（如 Claude Desktop）集成，提供更智能的集群管理

工具列表

• kubectl：用于执行 Kubernetes 命令
• Kubernetes Python 客户端：提供编程接口访问 Kubernetes 集群
• UV：用于创建虚拟环境和安装依赖

常见问题解答

• 如何配置 AI 助手（如 Claude Desktop）使用此服务？
• 编辑 claude_desktop_config.json 文件，指定 UV 路径和项目目录

使用教程

使用依赖

• Python 3.11+
• Kubernetes 集群访问权限
• 本地配置的 kubectl
• 安装 UV

# Clone repository
git clone https://github.com/ductnn/mcp-kubernetes-server.git 
cd mcp-kubernetes-server

# Create virtual environment
uv venv .venv

# Activate (Unix)
source .venv/bin/activate

# Install dependencies
uv pip install -r requirements.txt

安装教程

1. 克隆仓库
2. 创建虚拟环境
3. 激活虚拟环境
4. 安装依赖

调试方式

# Run all tests
pytest

# Run specific test file
pytest tests/unit/test_pod_service.py

# Run with coverage
pytest --cov=.

许可证

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