🚀 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 的力量，让您的集群管理更加高效和便捷。