Kustomize

Provides tools to render Kustomize configurations, compute dependencies, and generate diffs across overlays and checkpoints.

other

0

GitHub Stars

other

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mbrt-kustomize-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "$(pwd):/workspace",
        "ghcr.io/mbrt/kustomize-mcp:latest"
      ]
    }
  }
}

Kustomize MCP is an MCP server that helps you refactor Kubernetes configurations with Kustomize. It adds tooling to understand dependencies, render overlays, and compare changes across environments and checkpoints, making configuration management safer and more predictable.

How to use

You connect to the Kustomize MCP server from an MCP client (such as your code editor or CLI integration) and perform rendering, dependency analysis, and diffs against your Kustomize overlays. The server renders overlays, computes manifest dependencies, and lets you view full or summarized diffs between different checkpoints or between two Kustomize configurations rendered in the same checkpoint.

How to install

Prerequisites you need before starting: Docker if you want to run a pre-built container, or a local development setup with the MCP runtime to run the server directly.

Using Docker Run the server in a container (using the pre-built image):

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

The Docker image includes Python 3.13 with all project dependencies, kustomize (latest stable), helm (latest stable), and git. Mount your Kustomize configurations to the /workspace directory in the container to work with them.

If you want to rebuild the image from source and use that locally:

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

Then run using your locally built image instead of the remote one.

Using UV (Local Development) Start the MCP server:

uv run server.py

Additional notes

The server supports several workflow operations you can perform from your MCP client, such as creating a checkpoint, rendering configurations, and comparing rendered outputs across checkpoints or between two paths. These operations help you safely analyze how changes to a Kustomize overlay affect the final manifests across environments.

Available tools

create_checkpoint

Creates a checkpoint where rendered configuration will be stored.

clear_checkpoint

Clears all checkpoints or a specific checkpoint.

render

Renders Kustomize configuration and saves it in a checkpoint.

diff_checkpoints

Compares all rendered configuration across two checkpoints.

diff_paths

Compares two Kustomize configurations rendered in the same checkpoint.

dependencies

Returns dependencies for a Kustomization file.