Kubernetes MCP Server

Kubernetes MCP Server

这是一个 Model Context Protocol（MCP）服务，通过 MCP Python SDK 提供全面的 Kubernetes 功能。它允许你通过 MCP 客户端使用自然语言与 Kubernetes 集群交互。

功能

该服务提供了丰富的 Kubernetes 操作，并将其组织为逻辑模块：

Pod 操作

• 获取 Pod，支持筛选和输出格式选项
• 描述特定 Pod
• 获取 Pod 日志，支持多种选项
• 在 Pod 中执行命令
• 获取 Pod 指标

Deployment 操作

• 获取 Deployment，支持筛选和输出格式选项
• 描述特定 Deployment
• 扩缩 Deployment
• 管理 Deployment 发布（状态、历史记录、重启、回滚）
• 获取 Deployment 指标

Service 操作

• 获取 Service，支持筛选和输出格式选项
• 描述特定 Service
• 将 Deployment 暴露为 Service
• 为 Service 设置端口转发

Namespace 操作

• 获取 Namespace，支持筛选
• 描述特定 Namespace
• 创建和删除 Namespace
• 获取 Namespace 资源配额

集群操作

• 获取集群信息
• 获取并描述节点
• 管理节点调度（cordon/uncordon）
• 为维护排空节点
• 获取集群指标

先决条件

• Python 3.7+
• 已安装并配置 kubectl
• 可访问 Kubernetes 集群
• MCP 客户端（例如 Claude Desktop）

安装

1. 克隆此仓库
2. 安装依赖项：

   pip install -r requirements.txt
   

用法

运行服务

1. 使用 MCP Inspector 进入开发模式：

   python -m mcp.inspector src/k8s_mcp_server.py
   

2. 安装到 Claude Desktop：

   python -m mcp.install src/k8s_mcp_server.py
   

3. 直接运行：

   python src/k8s_mcp_server.py
   

使用工具

通过 MCP 客户端连接后，你可以使用自然语言与 Kubernetes 集群交互。例如：

• “获取 default 命名空间中的所有 Pod”
• “描述 web 命名空间中名为 ‘nginx’ 的 Deployment”
• “获取 production 命名空间中 ‘frontend’ Pod 的日志”
• “将 ‘backend’ Deployment 扩缩至 3 个副本”
• “创建名为 ‘staging’ 的新命名空间，并设置标签 environment=staging”

项目结构

src/
├── k8s_mcp_server.py      # Main server entry point
├── k8s_tools/            # Tool modules
│   ├── __init__.py
│   ├── pod_tools.py      # Pod-related tools
│   ├── deployment_tools.py # Deployment-related tools
│   ├── service_tools.py  # Service-related tools
│   ├── namespace_tools.py # Namespace-related tools
│   └── cluster_tools.py  # Cluster-related tools
└── requirements.txt      # Project dependencies

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。