Advertise
MCP.so
Sign In

MCP Kubernetes Server

@feiskyer

RepositoryHomepage

Basic information

Category

Cloud & Infrastructure

License

Apache-2.0

Transports

stdio

Author

feiskyer

About MCP Kubernetes Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Kubernetes clusters. It serves as a bridge between AI tools (like Claude, Cursor, and GitHub Copilot) and Kubernetes, translating natural language requests into Kubernetes operations and returning t

#kubernetes#mcp#claude#mcp-server

MCP Kubernetes Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount",
        "type=bind,src=/home/username/.kube/config,dst=/home/mcp/.kube/config",
        "ghcr.io/feiskyer/mcp-kubernetes-server"
      ]
    }
  }
}

MCP Kubernetes Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-kubernetes-server?

mcp-kubernetes-server is a Model Context Protocol (MCP) server that enables AI assistants to interact with Kubernetes clusters. It translates natural language requests from AI assistants into kubectl commands or direct Kubernetes API calls, executing them against the target cluster and returning structured responses.

How to use mcp-kubernetes-server?

Install via Docker or uvx. Configure in the mcpServers section of your AI client (Claude Desktop, Cursor, ChatGPT Copilot, GitHub Copilot). Provide a valid kubeconfig either via the KUBECONFIG environment variable (uvx) or by mounting the file into the container (Docker). Ensure kubectl, helm, and Python ≥3.11 (for uvx) are installed. Run with optional command-line flags to disable specific operations or change transport (stdio, sse, streamable-http).

Key features of mcp-kubernetes-server

  • Executes arbitrary kubectl and helm commands.
  • Provides read tools for resources, logs, events, APIs, and CRDs.
  • Offers write tools for create, apply, expose, scale, and rollout operations.
  • Supports disabling kubectl, helm, write, or delete operations.
  • Provides RBAC check tools (k8s_auth_can_i, k8s_auth_whoami).
  • Supports multiple transports: stdio, SSE, and streamable HTTP.

Use cases of mcp-kubernetes-server

  • Query cluster status and resource states via natural language.
  • Diagnose pod issues by inspecting logs, events, and resource descriptions.
  • Manage deployments (scale, rollout, set images, environment variables).
  • Perform administrative tasks like cordoning nodes or checking RBAC permissions.
  • Automate cluster operations through AI assistants in CI/CD pipelines.

Frequently asked questions

1

What prerequisites are needed to run mcp-kubernetes-server?

A working Kubernetes cluster, a valid kubeconfig file, kubectl and helm installed in the system PATH, and Python ≥3.11 if using uvx (not required for Docker).

2

How do I configure the kubeconfig?

Set the `KUBECONFIG` environment variable to the path of your kubeconfig file, or when using Docker mount the kubeconfig file to `/home/mcp/.kube/config`.

3

Can I disable write or delete operations?

Yes, use the `--disable-write` flag to block all write operations or `--disable-delete` to block deletions. Similarly, `--disable-kubectl` and `--disable-helm` disable those command executers.

4

What transport mechanisms are supported?

mcp-kubernetes-server supports three transports: `stdio` (default for uvx), `sse`, and `streamable-http`. Use the `--transport` flag to choose, and specify `--host`/`--port` for the server transports.

5

Which AI assistants are compatible?

The server works with any AI client that supports the Model Context Protocol, including Claude Desktop, Cursor, ChatGPT Copilot, and GitHub Copilot.

Comments

More Cloud & Infrastructure MCP servers

MCP Gateway

mcp-ecosystem

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

2.2K

Tessryx

Build and run websites, APIs, automations, and admin tools from chat. Your agent creates the data, logic, pages, and scheduled jobs; Tessryx hosts them on your own domain. No code generated, nothing to deploy.

MCP Server Kubernetes

Flux159

MCP Server for kubernetes management commands

1.5K

Webshare

Webshare

The official Webshare MCP server. Manage your proxies, usage, plans and billing from Claude, Cursor or any MCP client. Sign in with OAuth, no API key.

Nippy

Nippy

Nippy is drag-and-drop hosting (nippy.host) with an MCP server: connect it and your assistant can publish HTML, folders of photos, or file downloads to a live *.nippy.site URL — and keep editing the site in place at the

Advertise