How manusa/kubernetes-mcp-server works
Kubernetes MCP Server is a Go service that exposes Kubernetes and OpenShift operations to MCP clients. The principal workflow is an MCP request handled by the server, dispatched to enabled toolsets, and fulfilled through a cluster provider against Kubernetes APIs. Configuration, cluster targeting, HTTP/OAuth, and observability support that workflow. The README also documents Helm, Tekton, Kiali, KubeVirt, and network-observability capabilities; their paths are included from the tree, but unsampled internals are not assumed. Edges reflect excerpts or README statements; dashed links mark optional or unverified integrations.
Main entry points: mcp.go MCP server · root.go Server command · manager.go Cluster provider · toolset.go Kiali tools and prompts
Components 19
Server runtime
- CLI entry
cmd/kubernetes-mcp-server/main.go - Server command
pkg/kubernetes-mcp-server/cmd/root.go - MCP server
pkg/mcp/mcp.go - Telemetry
pkg/telemetry/telemetry.go
Cluster access
- Cluster provider
pkg/kubernetes/manager.go - KCP targets
pkg/kcp/provider.go
Kubernetes operations
- Core operations
pkg/toolsets/core/toolset.go - Helm operations
pkg/toolsets/helm/helm.go
Domain extensions
- Tekton pipelines
pkg/toolsets/tekton/pipeline.go - PipelineRun actions
pkg/toolsets/tekton/pipelinerun.go - Pipeline troubleshooting
pkg/toolsets/tekton/pipeline_troubleshoot.go - Kiali tools and prompts
pkg/toolsets/kiali/toolset.go - Service diagnosis
pkg/toolsets/kiali/prompts/service_troubleshoot.go - KubeVirt operations
pkg/toolsets/kubevirt/toolset.go - Network observability
pkg/toolsets/netobserv/toolset.go
Configuration and security
- Configuration
pkg/config/config.go - HTTP and OAuth
pkg/http/authorization.go
Other components
- MCP client
- Kubernetes API
Connections 21
- MCP client → CLI entry: starts requests
- CLI entry → Server command: executes
cmd/kubernetes-mcp-server/main.go - Server command → Configuration: validates
pkg/kubernetes-mcp-server/cmd/root.go - Server command → MCP server: starts
pkg/kubernetes-mcp-server/cmd/root.go - Server command → Cluster provider: configures
pkg/kubernetes-mcp-server/cmd/root.go - Server command → HTTP and OAuth: serves HTTP
pkg/kubernetes-mcp-server/cmd/root.go - Server command → Telemetry: initializes
pkg/kubernetes-mcp-server/cmd/root.go - MCP server → Core operations: dispatches tools
pkg/mcp/mcp.go - MCP server → Helm operations: dispatches tools
- MCP server → Tekton pipelines: dispatches tools
- MCP server → Kiali tools and prompts: dispatches tools
- MCP server → KubeVirt operations: dispatches tools
- MCP server → Network observability: dispatches tools
- MCP server → Cluster provider: uses targets
pkg/mcp/mcp.go - KCP targets → Cluster provider: builds managers
pkg/kcp/provider.go - Cluster provider → Kubernetes API: connects to
- Tekton pipelines → Kubernetes API: creates PipelineRuns
pkg/toolsets/tekton/pipeline.go - PipelineRun actions → Kubernetes API: reads and patches
pkg/toolsets/tekton/pipelinerun.go - Pipeline troubleshooting → Kubernetes API: fetches run data
pkg/toolsets/tekton/pipeline_troubleshoot.go - Service diagnosis → Kiali tools and prompts: requests diagnostics
pkg/toolsets/kiali/prompts/service_troubleshoot.go - Kiali tools and prompts → MCP client: returns results