Kubernetes Monitoring

🚀 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"
            ]
        }
    }
}

⚠️ 重要提示

如果需要，您可能需要在 command 字段中指定 uv 可執行文件的完整路徑。您可以通過運行 which uv（macOS/Linux）或 where uv（Windows）來獲取。

配置

應用程序自動嘗試兩種方法連接到您的 Kubernetes 集群：

1. Kubeconfig 文件：使用本地 kubeconfig 文件（通常位於 ~/.kube/config）
2. In-Cluster Configuration：如果在 Kubernetes pod 中運行，則使用服務賬戶令牌

如果您的 kubeconfig 設置正確或您在集群內部運行且具有適當的 RBAC 權限，則無需額外配置。

使用說明

安裝步驟

1. 克隆倉庫並進入目錄。
2. 使用 uv 工具創建虛擬環境並激活。
3. 同步依賴項後啟動服務。

示例查詢

# 基本命令示例
uv run server.py

📄 許可證

MIT License

✨ 貢獻

歡迎貢獻！請隨時提交 Pull Request。