MCP Server Kubernetes

MCP Server for a Kubernetes cluster written in Python.

Usage with Claude Desktop

{
  "mcpServers": {
    "kubernetes": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/mcp-kubernetes/",
        "run",
        "server.py"
      ]
    }
  }
}

The server uses the official Kubernetes Python client. This will automatically try and load your kubeconfig via the KUBECONFIG environment variable and default to ~/.kube/config if no environment variable is set.

Local Development

This project uses uv for package management.

Create the virtual environment and activate it:

uv venv

source .venv/bin/activate

Install dependencies:

uv sync

Start MCP inspector:

uv run mcp dev server.py