mcp-k8s-manager

mcp-k8s-manager

一个用于管理 AKS（Azure Kubernetes Service）Kubernetes 集群的 MCP 服务，可通过 Claude Desktop 使用。它提供工具，可直接通过对话界面执行 kubectl 和 kubectx 命令。

---

要求

请确保已安装：

• Python ≥ 3.10
• kubectl
• kubectx
• Azure CLI
• Claude Desktop

---

本地安装

1. 克隆仓库：

git clone https://github.com/crtdaniele/mcp-k8s-manager
cd mcp-k8s-manager

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate

3. 安装依赖：

pip install -r requirements.txt

4. （可选）添加新库后更新 requirements.txt 文件：

pip freeze > requirements.txt

启动 MCP 服务

要在开发模式下运行 MCP 服务并启用热重载：

mcp dev main.py

要在正常模式下运行服务：

mcp run main.py

工具

可用工具：

• run_kubectx：

使用 kubectx 切换 Kubernetes 上下文。

• run_kubectl：

执行 kubectl 命令。可以先使用 kubectx 切换上下文。

在 Claude Desktop 上安装

mcp install main.py

或者手动配置 settings.json 文件（Claude Desktop > Settings > Advanced）：

{
  "mcpServers": {
    "mcp-k8s-manager": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "your-local-path/main.py"
      ]
    }
  }
}

许可证

MIT License。 © 2025 Daniele Carta

贡献

欢迎提交 Pull Request！

请通过创建 issue 报告 bug 或请求新功能。