mcp-registry/kubernetes-mcp-server

    ==================
      
       /// MCP ///
      /// KUB ///
        
    ==================
        
    [server:online]
    [protocol:ready]

kubernetes-mcp-server

by manusa

Model Context Protocol (MCP) server for Kubernetes and OpenShift. Native Go binary that offers CRUD, pod-level, namespace, event, Helm and generic resource management operations with no kubectl/helm dependency.

377
61
Open Source
GitHubDocumentation

Installation

1. Prerequisites
• Access to a Kubernetes or OpenShift cluster (admin or a namespace with enough RBAC to create CRDs, Deployments, Services).
• kubectl (or oc) configured to target the cluster.
• Go 1.22+ if you plan to compile from source.
• Helm 3.12+ (optional – easiest way to install).
2. Clone the repository
git clone https://github.com/manusa/kubernetes-mcp-server.git cd kubernetes-mcp-server
3. Install via Helm (recommended)
--namespace mcp-system --create-namespace
helm repo add mcp https://manusa.github.io/kubernetes-mcp-server/charts helm repo update helm install mcp-server mcp/kubernetes-mcp-server \ # This command creates the CRDs, Deployment, Service and RBAC rules
4. Manual install from source (for development)
# Build the server binary go mod download go build -o bin/mcp-server ./cmd/mcp-server # Deploy CRDs kubectl apply -f config/crd/*.yaml # Run the server locally using your kube-config ./bin/mcp-server --kubeconfig=$HOME/.kube/config # Or containerise docker build -t mcp-server:dev . kubectl apply -f manifests/deployment.yaml # Edit image tag to mcp-server:dev
5. Configuration Flags (most common)
--listen-address=:8080 HTTP/GRPC listening port
--enable-leader-election=true High-availability mode
--namespace=<ns> Restrict reconciliation to a namespace
--log-level=info|debug Verbosity
6. Upgrade / Uninstall
helm upgrade mcp-server mcp/kubernetes-mcp-server [...flags] helm uninstall mcp-server -n mcp-system

Documentation

License: Apache License 2.0
Updated 7/15/2025