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)
helm repo add mcp https://manusa.github.io/kubernetes-mcp-server/charts
helm repo update
helm install mcp-server mcp/kubernetes-mcp-server \
--namespace mcp-system --create-namespace
# 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

# Transform Augment Code into Your Kubernetes Operations Command Center

The **Kubernetes MCP Server** transforms Augment Code from a coding assistant into a powerful Kubernetes operations platform, enabling you to manage clusters, deploy applications, and troubleshoot issues directly from your development environment. This native Go implementation provides lightning-fast cluster interactions without requiring kubectl or helm dependencies.

## Seamless Code-to-Cluster Workflows with Augment

With this MCP server configured in Augment Code, you can maintain continuous flow between writing code and managing your Kubernetes infrastructure. Ask Augment to "check if my deployment is running" while reviewing your application code, or have it automatically deploy your freshly written microservice to your development cluster. The server's comprehensive toolset—from pod operations and resource management to Helm chart deployments—means Augment can handle complex orchestration tasks while you focus on code.

**Setup is effortless**: Add the server to your Augment Code configuration using `npx kubernetes-mcp-server@latest`, and suddenly Augment can list pods, stream logs, execute commands in containers, monitor resource usage, and even diagnose deployment issues autonomously. Whether you're debugging a failing pod, scaling a deployment, or exploring cluster events to understand system behavior, Augment becomes your intelligent Kubernetes companion that understands both your code and your infrastructure context.

## Real-World Scenarios Where This Combination Excels

**Development Workflow**: While coding a new feature, ask Augment to "deploy this service to our staging namespace and check if it's healthy" - it can create the deployment, monitor rollout status, and even tail logs if issues arise. 

**Debugging Sessions**: When investigating production issues, Augment can simultaneously examine your application code and cluster state, correlating code changes with pod restarts, resource consumption, or event patterns.

**Infrastructure as Code**: Have Augment generate Kubernetes manifests based on your application requirements, then immediately deploy and validate them using the same conversation thread.

The server's native Go implementation ensures these operations happen instantly without the overhead of shelling out to command-line tools, making Augment's Kubernetes capabilities feel as responsive as its code suggestions.
License: Apache License 2.0
Updated 7/15/2025

Table of Contents