mcp-registry/k8s-mcp-server

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

k8s-mcp-server

by reza-gholizade

A Go-based Model Context Protocol (MCP) server that exposes Kubernetes and Helm operations through stdio, SSE or streamable-HTTP transports.

54
7
Open Source
GitHubDocumentation

Installation

1. Install Go 1.20 or newer and ensure $GOPATH/bin is on your PATH.
2. Fetch the source:
git clone https://github.com/reza-gholizade/k8s-mcp-server.git cd k8s-mcp-server
3. Build the server binary:
go build -o bin/mcp-server ./cmd/server # or install directly to your GOPATH/bin go install github.com/reza-gholizade/k8s-mcp-server/cmd/server@latest
4. (Optional) Use the provided container image if a Dockerfile exists:
docker build -t your-registry/mcp-server:local . docker run --network host -e KUBECONFIG=$HOME/.kube/config your-registry/mcp-server:local
5. Kubernetes deployment:
kubectl apply -f deploy/manifests/ # if manifests are provided in the repo
6. Configuration (typical):
• Provide a kube-config file with cluster-admin permissions via KUBECONFIG env var or /root/.kube/config inside the container.
• Set MCP_SERVER_PORT (default 8080) and optional TLS cert/key paths if you expose externally.
7. Verify:
curl http://localhost:8080/healthz # should return 200 OK

Documentation

License: MIT License
Updated 7/30/2025