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", "
:/workspace",
        "ghcr.io/mbrt/kustomize-mcp:latest"
      ]
    }
  }
}

替换 使用项目的根目录。

要与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