MCP server for Kubernetes support bundles
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"troubleshoot-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 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 bundles. This server enables AI models to analyze and troubleshoot Kubernetes clusters by exploring support bundles generated by the [Troubleshoot](https://troubleshoot.sh/) 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**: ```bash 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 # Activity 1: Initialize bundle # Server starts → downloads bundle → exits initialize_bu…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.