fix: support list resource from all namespaces

Author: feiskyer

Dockerfile

@@ -13,6 +13,7 @@ FROM python:3.12-bullseye
 
 RUN curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" && \
   chmod +x kubectl && mv kubectl /usr/local/bin/kubectl && \
+  curl -sSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash && \
   useradd --create-home --shell /bin/bash mcp
 
 COPY --from=builder /app/dist/*.whl /tmp

README.md

@@ -1,6 +1,17 @@
 # mcp-kubernetes-server
 
-A Model Context Protocol (MCP) server to enable Claude, Cursor and other AI tools to interact with Kubernetes cluster via kubectl.
+The mcp-kubernetes-server is 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 the results in a format the AI tools can understand.
+
+It allows AI tools to:
+
+- Query Kubernetes resources
+- Execute kubectl commands
+- Manage Kubernetes clusters through natural language interactions
+- Diagnose and interpret the states of Kubernetes resources
+
+## How it works
+
+![](assets/mcp-kubernetes-server.png)
 
 ## How to install
 
@@ -27,14 +38,24 @@ Get your kubeconfig file for your Kubernetes cluster and setup in the mcpServers
 
 ### UVX
 
-1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/#installation-methods) and add it to your PATH, e.g. using curl:
+<details>
+
+<summary>Install uv</summary>
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/#installation-methods) if it's not installed yet and add it to your PATH, e.g. using curl:
 
 ```bash
 # For Linux and MacOS
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
-2. Install [kubectl](https://kubernetes.io/docs/tasks/tools/) and add it to your PATH, e.g.
+</details>
+
+<details>
+
+<summary>Install kubectl</summary>
+
+Install [kubectl](https://kubernetes.io/docs/tasks/tools/) if it's not installed yet and add it to your PATH, e.g.
 
 ```bash
 # For Linux
@@ -44,7 +65,22 @@ curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stabl
 curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"
 ```
 
-3. 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.
+</details>
+
+<details>
+<summary>Install helm</summary>
+
+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
+```
+
+</details>
+
+<br/>
+
+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
 {
@@ -62,6 +98,38 @@ curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stabl
 }
 ```
 
+### Options
+
+Environment variables:
+
+- `KUBECONFIG`: Path to your kubeconfig file, e.g. `/home/<username>/.kube/config`.
+
+Command line arguments:
+
+```sh
+usage: mcp-kubernetes-server [-h] [--disable-kubectl] [--disable-helm] [--transport {stdio,sse}] [--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
+  --transport {stdio,sse}
+                        Transport mechanism to use (stdio or sse)
+  --port PORT           Port to use for the server (only used with sse transport)
+```
+
+## Usage
+
+Ask any questions about Kubernetes cluster in your AI client, e.g.
+
+```txt
+What is the status of my Kubernetes cluster?
+
+What is wrong with my nginx pod?
+```
+
 ## Development
 
 How to run the project locally:

assets/mcp-kubernetes-server.png

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-kubernetes-server"
-version = "0.1.7"
+version = "0.1.8"
 description = "MCP server to manage Kubernetes clusters via kubectl"
 readme = "README.md"
 requires-python = ">=3.11"

pyproject.toml

@@ -124,13 +124,13 @@ def _get_group_versions(api_client):
             yield g["name"], v["version"]
 
 
-async def get(resource, name, namespace="default"):
+async def get(resource, name, namespace):
     """
-    Fetch any Kubernetes object (or list) as JSON string. Pass name="" to list the collection.
+    Fetch any Kubernetes object (or list) as JSON string. Pass name="" to list the collection and namespace="" to get the resource in all namespaces.
 
     :param resource: The resource type (e.g., pods, deployments).
     :param name: The name of the resource.
-    :param namespace: The namespace of the resource. Defaults to "default".
+    :param namespace: The namespace of the resource.
     :return: The JSON representation of the resource.
     """
     try:
@@ -163,11 +163,13 @@ async def get(resource, name, namespace="default"):
 
         # 3. GET the object or list
         if rc.namespaced:
-            fetched = (
-                rc.get(name=name, namespace=namespace)
-                if name
-                else rc.get(namespace=namespace)
-            )
+            if name:
+                fetched = rc.get(name=name, namespace=namespace or "default")
+            else:
+                if namespace == "" or namespace is None:
+                    fetched = rc.get(all_namespaces=True)
+                else:
+                    fetched = rc.get(namespace=namespace)
         else:
             fetched = rc.get(name=name) if name else rc.get()
 

src/mcp_kubernetes_server/kubeclient.py

@@ -1,6 +1,5 @@
 # -*- coding: utf-8 -*-
 import argparse
-import json
 from fastmcp import FastMCP
 from .kubeclient import setup_client, apis,crds, get
 from .command import kubectl, helm