KOM

v1.0.0โ€ขCloud Servicesโ€ขstable

๐ŸŽ๏ธ โ˜๏ธ/๐Ÿ  - Provides MCP multi-cluster Kubernetes management and operations. It can be integrated as an SDK into your own project and includes nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD res

client-goclustercrdk8skom
Share:
147
Stars
0
Downloads
0
Weekly
0/5

What is KOM?

KOM is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ŸŽ๏ธ โ˜๏ธ/๐Ÿ  - provides mcp multi-cluster kubernetes management and operations. it can be integrated as an sdk into your own project and includes nearly 50 built-in tools covering common devops and devel...

๐ŸŽ๏ธ โ˜๏ธ/๐Ÿ  - Provides MCP multi-cluster Kubernetes management and operations. It can be integrated as an SDK into your own project and includes nearly 50 built-in tools covering common DevOps and development scenarios. Supports both standard and CRD res

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐ŸŽ๏ธ โ˜๏ธ/๐Ÿ  - Provides MCP multi-cluster Kubernetes management a

Use Cases

Manage Kubernetes clusters and resources
Handle CRDs and multi-cluster operations
Perform DevOps tasks via 50+ built-in tools
weibaohui

Maintainer

LicenseMIT License
Languagego
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx kom

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use KOM

KOM (Kubernetes Operations Manager) is a Go library and MCP server that provides multi-cluster Kubernetes management through nearly 50 built-in tools, covering pods, deployments, services, namespaces, nodes, CRDs, and more. It supports SQL-style queries over Kubernetes resources (e.g., `select * from pod where metadata.namespace='kube-system'`), real-time log streaming, pod file operations, port forwarding, Prometheus metrics queries, and deployment lifecycle management. AI assistants connected to KOM via its MCP server (stdio or SSE) can perform full DevOps workflows across multiple registered clusters through natural language.

Prerequisites

  • Go 1.21+ if using KOM as a library, or download the k8m binary for the GUI/MCP server mode
  • A valid kubeconfig file (default: ~/.kube/config) with access to at least one Kubernetes cluster
  • Docker or cloud provider credentials if the target cluster is remote (EKS, GKE, etc.)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf for the MCP server integration
1

Download k8m (the KOM MCP server binary)

KOM's MCP server is shipped as part of k8m, the lightweight Kubernetes management tool. Download the binary for your platform from the k8m GitHub releases page.

# macOS example
curl -LO https://github.com/weibaohui/k8m/releases/latest/download/k8m-darwin-amd64
chmod +x k8m-darwin-amd64 && mv k8m-darwin-amd64 /usr/local/bin/k8m
2

Verify kubeconfig access

Ensure your KUBECONFIG is set and you can reach your cluster. KOM defaults to ~/.kube/config and can register multiple clusters at startup.

export KUBECONFIG=~/.kube/config
kubectl cluster-info
3

Start k8m in MCP stdio mode

Run k8m with the MCP stdio transport. This is the mode used by most MCP clients including Claude Desktop.

k8m --mcp-server --transport stdio
4

Configure your MCP client

Add k8m as an MCP server in your client configuration. Set KUBECONFIG in the env block if it differs from the default path.

{
  "mcpServers": {
    "kom": {
      "command": "k8m",
      "args": ["--mcp-server", "--transport", "stdio"],
      "env": {
        "KUBECONFIG": "/Users/yourname/.kube/config"
      }
    }
  }
}
5

Restart your MCP client

Restart Claude Desktop or your chosen client. KOM's 50+ tools will be available, covering resource CRUD, log streaming, pod exec, port forwarding, Prometheus queries, and more.

KOM Examples

Client configuration

claude_desktop_config.json for KOM's k8m MCP server in stdio mode. Update KUBECONFIG to match your system.

{
  "mcpServers": {
    "kom": {
      "command": "k8m",
      "args": ["--mcp-server", "--transport", "stdio"],
      "env": {
        "KUBECONFIG": "/Users/yourname/.kube/config"
      }
    }
  }
}

Prompts to try

Natural-language prompts for Kubernetes operations through an AI assistant connected to KOM.

- "List all pods in the kube-system namespace and show their status"
- "Show me the logs from the nginx pod in the default namespace"
- "Scale the deployment 'api-server' in namespace 'production' to 5 replicas"
- "Run `df -h` inside the pod 'my-app-xyz' and show disk usage"
- "List all CRDs in the cluster and their API versions"
- "Query Prometheus for CPU usage of all pods in the monitoring namespace over the last 5 minutes"
- "Drain node worker-2 safely before maintenance"

Troubleshooting KOM

k8m cannot connect to cluster: kubeconfig not found

Set the KUBECONFIG environment variable explicitly in the MCP server's env block, pointing to your kubeconfig file's absolute path. Tilde expansion (~) may not work in JSON config โ€” use the full path like /home/yourname/.kube/config.

Multi-cluster commands target the wrong cluster

KOM supports multiple registered clusters identified by cluster ID. Use the cluster selection syntax in your prompt: 'On cluster prod-east, list all deployments.' Confirm registered clusters by asking 'List all registered clusters and their IDs.'

Prometheus queries return empty results

Prometheus integration requires a Prometheus instance accessible from the k8m server process. Confirm Prometheus is running and its URL is reachable. You may need to configure the Prometheus endpoint in k8m's settings or pass it as a flag.

Frequently Asked Questions about KOM

What is KOM?

KOM is a Model Context Protocol (MCP) server that ๐ŸŽ๏ธ โ˜๏ธ/๐Ÿ  - provides mcp multi-cluster kubernetes management and operations. it can be integrated as an sdk into your own project and includes nearly 50 built-in tools covering common devops and development scenarios. supports both standard and crd res It connects AI assistants to external tools and data sources through a standardized interface.

How do I install KOM?

Follow the installation instructions on the KOM GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with KOM?

KOM works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is KOM free to use?

Yes, KOM is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "kom": { "command": "npx", "args": ["-y", "kom"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use KOM?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides