Kdebug (Kubernetes)

🚀 KDebug - Kubernetes 調試 MCP 服務器

KDebug 是一款 Kubernetes 調試工具，藉助 Claude AI 實現與 Kubernetes 集群的交互。它運用模型控制協議（MCP），讓 Claude 能夠執行 Kubernetes 命令。

🚀 快速開始

KDebug 能讓你通過對話式 AI 與 Kubernetes 集群交互，實現檢查資源、查看日誌等功能。下面將詳細介紹安裝、配置和使用方法。

✨ 主要特性

• 檢查 Kubernetes 資源（如 pod、服務、部署等）。
• 查看 pod 日誌。
• 檢查節點狀態。
• 監控事件。
• 支持通過對話式 AI 完成上述及更多功能。

📦 安裝指南

先決條件

• Go 1.18+（若從源碼構建）。
• 配置好的 Kubernetes 集群訪問（~/.kube/config）。
• 帶有 MCP 支持的 Claude 客戶端。

選項 1：下載預構建二進制文件

1. 訪問 GitHub 發佈頁面：

https://github.com/soub4i/kdebug-mcp/releases

2. 下載對應您操作系統的最新版本（macOS、Linux、Windows）。
3. 設置二進制文件可執行：

chmod +x kdebug-mcp

4. 將二進制文件移動到 PATH 中的位置：

mv kdebug-mcp /usr/local/bin/kdebug-mcp
# 或 
mv kdebug-mcp ~/bin/kdebug-mcp  # 如果您將 ~/bin 添加到了 PATH 環境變量中

選項 2：從源碼構建

1. 克隆倉庫：

git clone https://github.com/soub4i/kdebug-mcp.git
cd kdebug-mcp

2. 構建二進制文件：

go build -o bin/server ./cmd/server/main.go

📚 詳細文檔

配置

配置 Claude 使用 KDebug

創建或編輯位於以下位置的 Claude MCP 配置文件：

• macOS: ~/Library/Application Support/com.anthropic.claude/config.json
• Linux: ~/.config/com.anthropic.claude/config.json
• Windows: %APPDATA%\com.anthropic.claude\config.json

添加以下配置：

{
    "mcpServers": {
        "kdebug": {
            "command": "/path/to/kdebug-mcp/bin/server"
        }
    }
}

將 /path/to/kdebug-mcp/bin/server 替換為您實際的 KDebug 二進制文件路徑。

Kubernetes 上下文

KDebug 使用您當前的 Kubernetes 上下文從 ~/.kube/config。請確保您的 Kubernetes 配置已正確設置。 要切換上下文，請使用：

kubectl config use-context <context-name>

使用方法

1. 啟動 Claude 並確保它連接到您的 KDebug MCP 服務器。
2. 在與 Claude 的對話中詢問有關您的 Kubernetes 資源的問題。

示例提示：

• "我的集群有什麼問題？上下文: minikube。命名空間: default"
• "列出所有節點。"
• "顯示 pods 列表。"

故障排除

無法連接到 Kubernetes 集群

檢查以下幾點：

1. 確保 ~/.kube/config 文件存在且配置正確。
2. 使用 kubectl config view --output=yaml 命令驗證上下文是否設置為正確的環境。
3. 如果使用的是 Minikube，請運行 minikube status 檢查其狀態。

無法啟動 KDebug 服務

1. 確保已正確構建 KDebug 可執行文件。
2. 在終端中運行 KDebug 服務並查看輸出以獲取更多信息：

./bin/server

安全注意事項

• 避免在生產環境中暴露 KDebug 服務，除非有適當的安全措施保護。
• 確保 ~/.kube/config 文件只有您和 root 用戶可讀，防止未經授權的訪問。

KDebug 提供了一個強大的工具來簡化 Kubernetes 調試過程，結合 Claude AI 的力量，讓您的集群管理更加高效和便捷。