什么是k8s-mcp?

k8s-mcp是一个Model Context Protocol (MCP)服务器，专门为Kubernetes集群设计。它允许用户通过简单的API查询获取集群状态、诊断问题，而无需直接操作kubectl命令行工具。

如何使用k8s-mcp?

通过Claude等AI助手直接提问关于集群的问题，或通过API查询特定资源信息。服务器会自动连接您的Kubernetes集群(本地或云上)。

适用场景

适用于需要快速了解Kubernetes集群状态、诊断问题或获取资源配置的开发者和运维人员，特别适合非命令行用户。

主要功能

集群监控实时获取节点状态、资源利用率等集群级信息

Pod检查查看Pod状态、重启次数、错误原因等详细信息

资源管理获取部署、服务等资源的YAML配置和状态

问题诊断自动识别常见问题如CrashLoopBackOff、Pending状态等

优势与局限性

优势

无需记忆复杂kubectl命令

提供集群状态的直观概览

自动诊断常见问题

支持自然语言查询

局限性

只读访问，不能修改集群状态

依赖AI助手或API查询

需要配置Claude桌面应用

如何使用

安装依赖

确保已安装Python 3.8+和uv工具

克隆仓库

获取k8s-mcp源代码

配置Claude

在Claude桌面应用中添加MCP服务器配置

使用案例

检查集群健康状态快速了解集群整体运行状况

诊断Pod问题找出失败或异常的Pod

获取资源配置查看特定资源的YAML配置

常见问题

需要什么权限访问集群？

支持哪些Kubernetes版本？

可以修改集群状态吗？

🚀 k8s-mcp

一个基于 Python 的只读 Kubernetes 集群模型上下文协议 (MCP) 服务器，它提供了全面的 API 来检索集群信息并诊断问题，为您的 Kubernetes 集群管理提供便利。

使用 Claude 的示例聊天

🚀 快速开始

安装

先决条件

Python 3.8+
对 Kubernetes 集群的访问权限（通过 kubeconfig 或 in-cluster 配置）
必要的 Python 包（请参见 pyproject.toml 中的 dependencies）

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆仓库
git clone git@github.com:vlttnv/k8s-mcp.git
cd k8s-mcp

# 安装依赖项
uv venv
source .venv/bin/activate
uv sync

如果使用 Claude，请配置您的桌面应用设置。在 ~/Library/Application Support/Claude/claude_desktop_config.json 中打开以文本编辑器查看：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "k8s-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/k8s-mcp",
                "run",
                "server.py"
            ]
        }
    }
}