什麼是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"
            ]
        }
    }
}