Kdebug MCP Server

TUI for Kubernetes Debug Containers

Local serverstdioPython

What is the Kdebug MCP Server?

TUI for Kubernetes Debug Containers

The short version

kdebug is a helper utility for launching ephemeral Kubernetes debug containers and backing up files. It provides interactive shell access, backup workflows, and a TUI for pod selection.

  • 🐚 Interactive Shell Access - Launch bash/sh sessions in debug containers directly to the directory of your choice
  • 💾 Backup Capabilities - Copy files/directories from pods with optional compression and configurable local paths
  • 🔍 Multiple Selection Modes - Direct pod, controller-based, or interactive TUI
  • 🎯 Smart Container Selection - Auto-select containers or choose specific targets
  • 📦 Backup Size Estimates - Understand how much data you backing up
  • ⚙️ Config File - Set defaults for debug image, shell command, and backup paths

What it needs from you

  • Python 3.9+ - rich is installed automatically with the Python package - kubectl configured with cluster access - Kubernetes cluster with ephemeral containers support (v1.23+)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Kdebug MCP Server

{
  "mcpServers": {
    "kdebug": {
      "command": "uvx",
      "args": ["kdebug"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.9+ - rich is installed automatically with the Python package - kubectl configured with cluster access - Kubernetes cluster with ephemeral containers support (v1.23+)

Example prompts to try

  • “Use Kdebug to Homebrew.”
  • “Use Kdebug to Bash.”
  • “Use Kdebug to Fish.”

Frequently asked questions

TUI for Kubernetes Debug Containers Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.