MCP Server for Kubernetes Support Bundles
About
# MCP Server for Kubernetes Support Bundles [](LICENSE) [](https://www.python.org/downloads/) A Model Context Protocol (MCP) server for AI models to interact with Kubernetes support…
Details
- License
- Apache-2.0
Explore
- 🚀 Bundle Management: Initialize and manage Kubernetes support bundles
- 🎮 Command Execution: Run kubectl commands against bundle's API server
- 📁 File Explorer: Navigate and search files within the bundle
- 🔐 Secure Authentication: Token-based authentication for bundle access
- 🐳 Container Support: Run as a containerized application
- ⚡ Single Bundle Mode: Stateless operation for ephemeral/serverless deployments
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Server for Kubernetes Support BundlesCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
For development, install the package in editable mode with development dependencies:
| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| MCP_SINGLE_BUNDLE_MODE | false | Enable single bundle mode |
| PRESERVE_BUNDLES | false | Keep bundle files on disk after cleanup |
| MCP_BUNDLE_STORAGE | temp dir | Directory for persistent bundle storage |
Note: PRESERVE_BUNDLES=true must be set with single bundle mode to ensure bundles persist across server restarts.
1. Ensure you have Python 3.13 installed
2. Set up environment with UV (recommended):
./scripts/setup_env.sh
AI models can interact with the server using the MCP protocol:
// Request to list files
{
"name": "list_files",
"input": {
"path": "/kubernetes/pods",
"recursive": false
}
}
// Response (simplified)
{
"content": "Listed files in /kubernetes/pods non-recursively:\n``json\n[\n {\n \"name\": \"kube-system\",\n \"path\": \"/kubernetes/pods/kube-system\",\n \"type\": \"directory\",\n \"size\": null,\n \"modified\": \"2025-04-10T12:30:45Z\"\n },\n {\n \"name\": \"pod-definition.yaml\",\n \"path\": \"/kubernetes/pods/pod-definition.yaml\",\n \"type\": \"file\",\n \"size\": 1254,\n \"modified\": \"2025-04-10T12:30:45Z\"\n }\n]\n`\nDirectory metadata:\n`json\n{\n \"path\": \"/kubernetes/pods\",\n \"recursive\": false,\n \"total_files\": 1,\n \"total_dirs\": 1\n}\n`"``
}
./scripts/setup_env.sh
The MCP server provides the following tools for AI models:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server for kubernetes support bundles": {
"troubleshoot-mcp-server": {
"command": "uv",
"args": [
"venv",
"-p",
"python3.13",
".venv"
]
}
}
}
}McpServers
{
"troubleshoot-mcp-server": {
"command": "uv",
"args": [
"venv",
"-p",
"python3.13",
".venv"
]
}
}
A Model Context Protocol (MCP) server for AI models to interact with Kubernetes support bundles. This server enables AI models to analyze and troubleshoot Kubernetes clusters by exploring support bundles generated by the Troubleshoot tool.
Features
- 🚀 Bundle Management: Initialize and manage Kubernetes support bundles
- 🎮 Command Execution: Run kubectl commands against bundle's API server
- 📁 File Explorer: Navigate and search files within the bundle
- 🔐 Secure Authentication: Token-based authentication for bundle access
- 🐳 Container Support: Run as a containerized application
- ⚡ Single Bundle Mode: Stateless operation for ephemeral/serverless deployments
Single Bundle Mode (Stateless Operation)
For stateless/ephemeral deployments (Temporal workflows, serverless functions, container-per-request architectures), enable Single Bundle Mode:
export MCP_SINGLE_BUNDLE_MODE=true
export PRESERVE_BUNDLES=true
export MCP_BUNDLE_STORAGE=/persistent-storage/bundles
What is Single Bundle Mode?
Single Bundle Mode eliminates in-memory bundle state tracking by treating the presence of a bundle on disk as the source of truth. This enables:
- Automatic Bundle Restoration: When the server starts, it auto-activates the bundle persisted on disk
- Stateless Server Restarts: Each server restart automatically uses the persisted bundle without re-initialization
- Single Bundle Invariant: Only one bundle can exist at a time, preventing state confusion
- Seamless Temporal/Serverless Integration: Works perfectly with short-lived server instances
Usage Pattern
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
