io.github.containers/kubernetes-mcp-server

A Model Context Protocol (MCP) server for Kubernetes and OpenShift

io.github.containers/kubernetes-mcp-server · Repository · version 0.1.0 · 2.2k stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

npx kubernetes-mcp-server

Results by platform

Linux

MCP handshake failed2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Error: unable to create kubernetes target provider: no current-context is set and no contexts are defined in kubeconfig.
Configure a context with 'kubectl config set-context <name>' and 'kubectl config use-context <name>'
Usage:
  kubernetes-mcp-server [flags]

Examples:
  # show this help
  kubernetes-mcp-server -h
  
  # shows version information
  kubernetes-mcp-server --version
  
  # start STDIO server
  kubernetes-mcp-server
  
  # start a Streamable HTTP server using a TOML config file
  kubernetes-mcp-server --config /path/to/config.toml
  
  # start using only a drop-in directory
  kubernetes-mcp-server --config-dir /path/to/conf.d
  
  # start a Streamable HTTP server reading the TOML config from stdin
  echo 'port = "8080"' | kubernetes-mcp-server --config -

Flags:
      --config string       Path of the config file, or - to read it from stdin (HTTP mode only).
      --config-dir string   Directory of lexical .toml files. Usable alone or with --config. Omitted means no drop-ins. Relative paths are resolved against the working directory.
  -h, --help                help for kubernetes-mcp-server
      --version             Print version information and quit

macOS

MCP handshake failed2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Error: unable to create kubernetes target provider: no current-context is set and no contexts are defined in kubeconfig.
Configure a context with 'kubectl config set-context <name>' and 'kubectl config use-context <name>'
Usage:
  kubernetes-mcp-server [flags]

Examples:
  # show this help
  kubernetes-mcp-server -h
  
  # shows version information
  kubernetes-mcp-server --version
  
  # start STDIO server
  kubernetes-mcp-server
  
  # start a Streamable HTTP server using a TOML config file
  kubernetes-mcp-server --config /path/to/config.toml
  
  # start using only a drop-in directory
  kubernetes-mcp-server --config-dir /path/to/conf.d
  
  # start a Streamable HTTP server reading the TOML config from stdin
  echo 'port = "8080"' | kubernetes-mcp-server --config -

Flags:
      --config string       Path of the config file, or - to read it from stdin (HTTP mode only).
      --config-dir string   Directory of lexical .toml files. Usable alone or with --config. Omitted means no drop-ins. Relative paths are resolved against the working directory.
  -h, --help                help for kubernetes-mcp-server
      --version             Print version information and quit

Windows

MCP handshake failed2026-11-09 · probed over npm

5 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Error: unable to create kubernetes target provider: no current-context is set and no contexts are defined in kubeconfig.
Configure a context with 'kubectl config set-context <name>' and 'kubectl config use-context <name>'
Usage:
  kubernetes-mcp-server [flags]

Examples:
  # show this help
  kubernetes-mcp-server -h
  
  # shows version information
  kubernetes-mcp-server --version
  
  # start STDIO server
  kubernetes-mcp-server
  
  # start a Streamable HTTP server using a TOML config file
  kubernetes-mcp-server --config /path/to/config.toml
  
  # start using only a drop-in directory
  kubernetes-mcp-server --config-dir /path/to/conf.d
  
  # start a Streamable HTTP server reading the TOML config from stdin
  echo 'port = "8080"' | kubernetes-mcp-server --config -

Flags:
      --config string       Path of the config file, or - to read it from stdin (HTTP mode only).
      --config-dir string   Directory of lexical .toml files. Usable alone or with --config. Omitted means no drop-ins. Relative paths are resolved against the working directory.
  -h, --help                help for kubernetes-mcp-server
      --version             Print version information and quit

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.containers__kubernetes-mcp-server.json)](https://doesitinstall.com/s/io.github.containers__kubernetes-mcp-server.html)