Kustomize配置重构工具

一个基于Kustomize的MCP服务器,用于重构Kubernetes配置,提供依赖分析、配置渲染和差异比较功能。

  • by mbrt
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mbrt/kustomize-mcp

使用说明

Kustomize MCP

有助于重构的MCP服务器 Kubernetes 配置基于 客户,.

为什么? 因为Kustomize清单以不明显的方式相互依赖, 模型很难理解配置更改如何影响多个 环境。此MCP服务器为他们提供了额外的工具,使其更安全:

  • 计算清单的依赖关系
  • 渲染Kustomize覆盖的最终结果
  • 提供跨目录和跨目录覆盖之间的完整和汇总差异 检查站。

可用工具

  • create_checkpoint:创建一个检查点,在该检查点将呈现配置 存储。
  • clear_checkpoint:清除所有检查点或特定检查点
  • render:渲染Kustomize配置并将其保存在 检查点
  • diff_checkpoints:比较两个检查点上的所有渲染配置
  • diff_paths:比较在中呈现的两个Kustomize配置 同一检查点
  • dependencies:返回Kustomization文件的依赖关系

运行服务器

[!注意] 这需要访问您的本地文件系统,类似于 文件系统 MCP服务器工作。

使用Docker

在容器中运行服务器(使用预构建的映像):

docker run -i --rm -v "$(pwd):/workspace" ghcr.io/mbrt/kustomize-mcp:latest

Docker镜像包括:

  • Python 3.13与所有项目依赖
  • kustomize(最新稳定版)
  • helm(最新稳定)
  • 版本控制系统

将Kustomize配置安装到 /workspace 目录中 容器与它们一起工作。

如果要从源重建映像:

docker build -t my-kustomize-mcp:latest .

并使用该图像代替 ghcr.io/mbrt/kustomize-mcp.

使用UV(地方发展)

启动MCP服务器:

uv run server.py

服务器将使用STDIO传输启动。

与MCP客户端一起使用

要与VS Code集成,请将配置添加到用户级MCP中 配置文件。打开命令选项板(Ctrl + Shift + P)然后跑 MCP: Open User Configuration。这将打开您的用户 mcp.json 文件,你可以 添加服务器配置。

{
  "servers": {
    "kustomize": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=${workspaceFolder},dst=/workspace",
        "ghcr.io/mbrt/kustomize-mcp:latest"
      ]
    }
  }
}

要与Claude Code集成,请将此添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "kustomize": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-a", "stdin",
        "-a", "stdout",
        "-v", "<PROJECT_DIR>:/workspace",
        "ghcr.io/mbrt/kustomize-mcp:latest"
      ]
    }
  }
}

替换 <PROJECT_DIR> 使用项目的根目录。

要与Gemini CLI集成,请编辑 .gemini/settings.json:

{
  "mcpServers": {
    "kustomize": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-a", "stdin",
        "-a", "stdout",
        "-v", "${PWD}:/workspace",
        "ghcr.io/mbrt/kustomize-mcp:latest"
      ]
    }
  }
}

测试服务器

运行单元测试:

pytest

在一个shell上运行服务器后,使用开发工具验证服务器是否 工作:

uv run mcp dev ./server.py