acOS curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl" ```

Install helm

Install [helm](https://helm.sh/docs/intro/install/) if it's not installed yet and add it to your PATH, e.g. ```bash curl -sSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash ```

Config your MCP servers in [Claude Desktop](https://claude.ai/download), [Cursor](https://www.cursor.com/), [ChatGPT Copilot](https://marketplace.visualstudio.com/items?itemName=feiskyer.chatgpt-copilot), [Github Copilot](https://github.com/features/copilot) and other supported AI clients, e.g. ```json { "mcpServers": { "kubernetes": { "command": "uvx", "args": [ "mcp-kubernetes-server" ], "env": { "KUBECONFIG": "" } } } } ``` ### MCP Server Options

Environment Variables

**Environment variables:** - `KUBECONFIG`: Path to your kubeconfig file, e.g. `/home//.kube/config`.

Command line arguments

**Command-line Arguments:** ```sh usage: main.py [-h] [--disable-kubectl] [--disable-helm] [--disable-write] [--disable-delete] [--transport {stdio,sse,streamable-http}] [--host HOST] [--port PORT] MCP Kubernetes Server options: -h, --help show this help message and exit --disable-kubectl Disable kubectl command execution --disable-helm Disable helm command execution --disable-write Disable write operations --disable-delete Disable delete operations --transport {stdio,sse,streamable-http} Transport mechanism to use (stdio or sse or streamable-http) --host HOST Host to use for sse or streamable-http server --port PORT Port to use for sse or streamable-http server ```

## Usage Once the `mcp-kubernetes-server` is installed and configured in your AI client (using the JSON snippets provided in the 'How to install' section for Docker or UVX), you can start interacting with your Kubernetes cluster through natural language. For example, you can ask: ```txt What is the status of my Kubernetes cluster? What is wrong with my nginx pod? ``` **Verifying the server:** If you're running the server with `stdio` transport (common for `uvx` direct execution), the AI client will typically start and manage the server process. For `sse` or `streamable-http` transports, the server runs independently. You would have started it manually (e.g., `uvx mcp-kubernetes-server --transport sse`) and should see output in your terminal indicating it's running (e.g., `INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)`). You can also check for any error messages in the server terminal if the AI client fails to connect. ## Available Tools The mcp-kubernetes-server provides a comprehensive set of tools for interacting with Kubernetes clusters, categorized by operation type:

Command Tools

### Command Tools These tools provide general command execution capabilities: | Tool | Description | Parameters | |------|-------------|------------| | **kubectl** | Run any kubectl command and return the output | `command` (string) | | **helm** | Run any helm command and return the output | `command` (string) |

Read Tools

### Read Tools These tools provide read-only access to Kubernetes resources: | Tool | Description | Parameters | |------|-------------|------------| | **k8s_get** | Fetch any Kubernetes object (or list) as JSON string | `resource` (string), `name` (string), `namespace` (string) | | **k8s_describe** | Show detailed information about a specific resource or group of resources | `resource_type` (string), `name` (string, optional), `namespace` (string, optional), `selector` (string, optional), `all_namespaces` (boolean, optional) | | **k8s_logs** | Print the logs for

mcp-kubernetes-server

Comments