Skip to main content
Glama

Kube MCP

npm version License: MIT

A Model Context Protocol (MCP) server for Kubernetes cluster management. Enables AI assistants to interact with Kubernetes resources.

Quick Start

npx @icy-r/kube-mcp

MCP Configuration

Add to your MCP client (Claude Desktop, Cursor, etc.):

{ "mcpServers": { "kubernetes": { "command": "npx", "args": ["-y", "@icy-r/kube-mcp"], "env": { "KUBEMCP_DEFAULT_NAMESPACE": "default" } } } }

Custom kubeconfig:

{ "mcpServers": { "kubernetes": { "command": "npx", "args": ["-y", "@icy-r/kube-mcp"], "env": { "KUBEMCP_CONFIG_SOURCE": "custom", "KUBEMCP_KUBECONFIG_PATH": "/path/to/kubeconfig" } } } }

Environment Variables

Variable

Description

Default

KUBEMCP_CONFIG_SOURCE

local or custom

local

KUBEMCP_KUBECONFIG_PATH

Custom kubeconfig path

-

KUBEMCP_DEFAULT_NAMESPACE

Default namespace

default

KUBEMCP_RESPONSE_FORMAT

json, toon, auto

auto

Tools

Tool

Actions

k8s_deployments

list, get, scale, restart, get_status, get_metrics

k8s_pods

list, get, delete, get_logs, summarize_logs, get_status

k8s_services

list, get, get_endpoints

k8s_configmaps

list, get, create, update, delete

k8s_secrets

list, get, create, update, delete

k8s_namespaces

list, get, create, delete

k8s_metrics

get_pod_metrics, get_node_metrics

k8s_events

list, get_resource_events, get_recent_events

k8s_audit

get_config, configure, get_session_log, clear_session_log

Safety Features

Destructive actions require explicit confirmation:

{ "action": "delete", "name": "my-pod", "confirm": true }

Preview changes with dry-run:

{ "action": "scale", "name": "my-deployment", "replicas": 5, "dryRun": true }

Development

git clone https://github.com/icy-r/kubemcp.git cd kubemcp pnpm install pnpm build pnpm test

License

MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/icy-r/kubemcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server