
K8s MCP Server (Go)
Gives Claude read-only access to your Kubernetes cluster through 33 tools covering pods, deployments, services, ConfigMaps, secrets, and node metrics. Ships with three permission modes: readonly (default) blocks all mutations, readwrite adds scaling and restarts, and dangerous enables deletes and arbitrary YAML applies. Each tool checks permissions at runtime and returns explicit denials rather than failing silently. Uses your local kubeconfig and runs as a stdio transport. Useful when you want AI to diagnose cluster issues or explain resource states without risking accidental deletions in production. Available as MCPB bundles for direct installation in Claude Desktop and Cursor.
- GitHub stars
- 2
- tools
- 38
- transport
- STDIO
- last updated
- Jun 21, 2026
Tools
38 toolsPublic tool metadata for what this MCP can expose to an agent.
get_server_infoShow server version, mode, Kubernetes config source, and runtime details
Show server version, mode, Kubernetes config source, and runtime details
No parameter schema in public metadata yet.
resolve_workloadResolve an app/workload name to matching resources and suggested next tools
Resolve an app/workload name to matching resources and suggested next tools
No parameter schema in public metadata yet.
list_podsList pods; supports all_namespaces=true
List pods; supports all_namespaces=true
No parameter schema in public metadata yet.
get_podGet pod details
Get pod details
No parameter schema in public metadata yet.
get_pod_logsGet pod logs
Get pod logs
No parameter schema in public metadata yet.
list_deploymentsList deployments; supports all_namespaces=true
List deployments; supports all_namespaces=true
No parameter schema in public metadata yet.
get_deploymentGet deployment details
Get deployment details
No parameter schema in public metadata yet.
list_statefulsetsList StatefulSets; supports all_namespaces=true
List StatefulSets; supports all_namespaces=true
No parameter schema in public metadata yet.
get_statefulsetGet StatefulSet details
Get StatefulSet details
No parameter schema in public metadata yet.
list_servicesList services; supports all_namespaces=true
List services; supports all_namespaces=true
No parameter schema in public metadata yet.
get_serviceGet service details
Get service details
No parameter schema in public metadata yet.
list_configmapsList ConfigMaps; supports all_namespaces=true
List ConfigMaps; supports all_namespaces=true
No parameter schema in public metadata yet.
get_configmapGet ConfigMap data
Get ConfigMap data
No parameter schema in public metadata yet.
list_secretsList Secrets (keys only); supports all_namespaces=true
List Secrets (keys only); supports all_namespaces=true
No parameter schema in public metadata yet.
get_secretGet Secret metadata and keys
Get Secret metadata and keys
No parameter schema in public metadata yet.
list_pvcList PersistentVolumeClaims; supports all_namespaces=true
List PersistentVolumeClaims; supports all_namespaces=true
No parameter schema in public metadata yet.
list_ingressList Ingress resources; supports all_namespaces=true
List Ingress resources; supports all_namespaces=true
No parameter schema in public metadata yet.
list_jobsList Jobs; supports all_namespaces=true
List Jobs; supports all_namespaces=true
No parameter schema in public metadata yet.
top_nodesCurrent node CPU and memory usage
Current node CPU and memory usage
No parameter schema in public metadata yet.
top_podsCurrent pod CPU and memory usage
Current pod CPU and memory usage
No parameter schema in public metadata yet.
list_nodesList cluster nodes
List cluster nodes
No parameter schema in public metadata yet.
list_namespacesList namespaces
List namespaces
No parameter schema in public metadata yet.
get_cluster_overviewCluster health summary
Cluster health summary
No parameter schema in public metadata yet.
list_eventsList events
List events
No parameter schema in public metadata yet.
scale_deploymentScale deployment replicas
Scale deployment replicas
No parameter schema in public metadata yet.
restart_deploymentRolling restart a deployment
Rolling restart a deployment
No parameter schema in public metadata yet.
restart_statefulsetRolling restart a statefulset
Rolling restart a statefulset
No parameter schema in public metadata yet.
set_imageUpdate container image
Update container image
No parameter schema in public metadata yet.
get_rollout_statusCheck rollout progress
Check rollout progress
No parameter schema in public metadata yet.
create_namespaceCreate a new namespace
Create a new namespace
No parameter schema in public metadata yet.
patch_deploymentApply strategic merge patch
Apply strategic merge patch
No parameter schema in public metadata yet.
delete_podDelete a pod
Delete a pod
No parameter schema in public metadata yet.
delete_deploymentDelete a deployment
Delete a deployment
No parameter schema in public metadata yet.
delete_statefulsetDelete a StatefulSet and its pods
Delete a StatefulSet and its pods
No parameter schema in public metadata yet.
delete_daemonsetDelete a DaemonSet and its pods
Delete a DaemonSet and its pods
No parameter schema in public metadata yet.
delete_resourceDelete a resource without a dedicated delete tool
Delete a resource without a dedicated delete tool
No parameter schema in public metadata yet.
delete_namespaceDelete a namespace and all resources
Delete a namespace and all resources
No parameter schema in public metadata yet.
apply_yamlApply arbitrary YAML manifest
Apply arbitrary YAML manifest
No parameter schema in public metadata yet.
Sponsors
Readme
k8s-mcp-go
Safe, read-only-by-default Kubernetes access for AI agents.
A Kubernetes MCP server that lets AI assistants inspect your cluster safely — without giving them unrestricted kubectl.
What makes it different
- Read-only by default: useful for diagnosis without giving AI permission to mutate the cluster.
- Explicit permission modes: choose
readonly,readwrite, ordangerousbefore the assistant starts. - No Docker required: install via MCPB bundles or a single native binary.
- Kubernetes-native visibility: inspect pods, deployments, services, logs, events, nodes, and live CPU/memory usage.
- Registry-ready distribution: published as
io.github.kaneg/k8s-mcp-gofor MCP Registry consumers and packaged clients.
Distribution
Details
- Repository
- github.com/kaneg/k8s-mcp-go
- Website
- github.com/kaneg/k8s-mcp-go
- Category
- Cloud & Infrastructure
- Package
https://github.com/kaneg/k8s-mcp-go/releases/download/v0.4.6/k8s-mcp-go_0.4.6_darwin_amd64.mcpb- Transport
- STDIO
- Registry
- MCP registry, active