kaneg avatar

K8s MCP Server (Go)

kaneg/k8s-mcp-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 tools

Public 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.

GitHub release License Go MCP

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, or dangerous before 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-go for MCP Registry consumers and packaged clients.

Distribution


View the full README on GitHub

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

Related Cloud & Infrastructure MCP servers

View all
1ofershap avatarS3ofershap/mcp-server-s3AWS S3 MCP — list buckets, browse objects, upload/download, presigned URLs.0stars
2your-ko avatarMcp K8s Royour-ko/mcp-k8s-roRead-only Kubernetes MCP server: inspect resources, logs, events, and metrics. Secrets are masked.1stars
3oijusti avatarK8s Port Forward Mcpoijusti/k8s-port-forward-mcpKubernetes Port Forward — MCP Server: port-forward Kubernetes services with terminal integration0stars
4unbearabledev avatarKubernetes Manifest Auditunbearabledev/k8s-manifest-auditkube-linter audit for Kubernetes manifests — 63 checks: security, availability, RBAC, network.0stars
5yawlabs avatarYaw Labs AWS MCPyawlabs/aws-mcpAWS MCP server — call any AWS API from AI assistants, with first-class SSO re-login5stars
6delega avatardelega.ai for AWS Pricing Calculatorai.delega/aws-pricing-calculatorCreate AWS cost estimates and shareable AWS Pricing Calculator URLs.0stars