mcp-server-kubernetes 2.9.0 → 2.9.1

package/README.md

@@ -10,6 +10,7 @@
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Flux159/mcp-server-kubernetes/pulls)
 [![Last Commit](https://img.shields.io/github/last-commit/Flux159/mcp-server-kubernetes)](https://github.com/Flux159/mcp-server-kubernetes/commits/main)
 [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/Flux159/mcp-server-kubernetes)](https://archestra.ai/mcp-catalog/flux159__mcp-server-kubernetes)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Flux159/mcp-server-kubernetes)
 
 MCP Server that can connect to a Kubernetes cluster and manage it. Supports loading kubeconfig from multiple sources in priority order.
 
@@ -17,7 +18,34 @@ https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed
 
 <a href="https://glama.ai/mcp/servers/w71ieamqrt"><img width="380" height="200" src="https://glama.ai/mcp/servers/w71ieamqrt/badge" /></a>
 
-## Usage with Claude Desktop
+## Installation & Usage
+
+### Prerequisites
+
+Before using this MCP server with any tool, make sure you have:
+
+1. kubectl installed and in your PATH
+2. A valid kubeconfig file with contexts configured
+3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)
+4. Helm v3 installed and in your PATH (no Tiller required). Optional if you don't plan to use Helm.
+
+You can verify your connection by running `kubectl get pods` in a terminal to ensure you can connect to your cluster without credential issues.
+
+By default, the server loads kubeconfig from `~/.kube/config`. For additional authentication options (environment variables, custom paths, etc.), see [ADVANCED_README.md](ADVANCED_README.md).
+
+### Claude Code
+
+Add the MCP server to Claude Code using the built-in command:
+
+```bash
+claude mcp add kubernetes -- npx mcp-server-kubernetes
+```
+
+This will automatically configure the server in your Claude Code MCP settings.
+
+### Claude Desktop
+
+Add the following configuration to your Claude Desktop config file:
 
 ```json
 {
@@ -30,18 +58,43 @@ https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed
 }
 ```
 
-By default, the server loads kubeconfig from `~/.kube/config`. For additional authentication options (environment variables, custom paths, etc.), see [ADVANCED_README.md](ADVANCED_README.md).
+### VS Code
 
-The server will automatically connect to your current kubectl context. Make sure you have:
+[![Install Kubernetes MCP in VS Code](https://img.shields.io/badge/Install%20Kubernetes%20MCP%20in%20VS%20Code-blue?logo=visualstudiocode)](vscode:mcp/install?%7B%22name%22%3A%20%22kubernetes%22%2C%20%22type%22%3A%20%22stdio%22%2C%20%22command%22%3A%20%22npx%22%2C%20%22args%22%3A%20%5B%22mcp-server-kubernetes%22%5D%7D)
 
-1. kubectl installed and in your PATH
-2. A valid kubeconfig file with contexts configured
-3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)
-4. Helm v3 installed and in your PATH (no Tiller required). Optional if you don't plan to use Helm.
+For VS Code integration, you can use the MCP server with extensions that support the Model Context Protocol:
+
+1. Install a compatible MCP extension (such as Claude Dev or similar MCP clients)
+2. Configure the extension to use this server:
+
+```json
+{
+  "mcpServers": {
+    "kubernetes": {
+      "command": "npx",
+      "args": ["mcp-server-kubernetes"],
+      "description": "Kubernetes cluster management and operations"
+    }
+  }
+}
+```
 
-You can verify your connection by asking Claude to list your pods or create a test deployment.
+### Cursor
 
-If you have errors open up a standard terminal and run `kubectl get pods` to see if you can connect to your cluster without credentials issues.
+Cursor supports MCP servers through its AI integration. Add the server to your Cursor MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "kubernetes": {
+      "command": "npx",
+      "args": ["mcp-server-kubernetes"]
+    }
+  }
+}
+```
+
+The server will automatically connect to your current kubectl context. You can verify the connection by asking the AI assistant to list your pods or create a test deployment.
 
 ## Usage with mcp-chat
 
@@ -105,7 +158,7 @@ npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"
 
 The MCP Kubernetes server includes specialized prompts to assist with common diagnostic operations.
 
-### k8s-diagnose Prompt
+### /k8s-diagnose Prompt
 
 This prompt provides a systematic troubleshooting flow for Kubernetes pods. It accepts a `keyword` to identify relevant pods and an optional `namespace` to narrow the search.
 The prompt's output will guide you through an autonomous troubleshooting flow, providing instructions for identifying issues, collecting evidence, and suggesting remediation steps.
@@ -248,6 +301,7 @@ Instead of using `helm install` directly, this tool:
 ```
 
 This is equivalent to running:
+
 ```bash
 helm template events-exporter . -f values.yaml > events-exporter.yaml
 kubectl create namespace kube-event-exporter
@@ -273,6 +327,7 @@ Pod cleanup can be achieved using the existing `kubectl_get` and `kubectl_delete
 Use `kubectl_get` with field selectors to identify pods in problematic states:
 
 **Get failed pods:**
+
 ```json
 {
   "name": "kubectl_get",
@@ -285,6 +340,7 @@ Use `kubectl_get` with field selectors to identify pods in problematic states:
 ```
 
 **Get completed pods:**
+
 ```json
 {
   "name": "kubectl_get",
@@ -297,6 +353,7 @@ Use `kubectl_get` with field selectors to identify pods in problematic states:
 ```
 
 **Get pods with specific conditions:**
+
 ```json
 {
   "name": "kubectl_get",
@@ -313,6 +370,7 @@ Use `kubectl_get` with field selectors to identify pods in problematic states:
 Use `kubectl_delete` with field selectors to delete pods in problematic states:
 
 **Delete failed pods:**
+
 ```json
 {
   "name": "kubectl_delete",
@@ -327,6 +385,7 @@ Use `kubectl_delete` with field selectors to delete pods in problematic states:
 ```
 
 **Delete completed pods:**
+
 ```json
 {
   "name": "kubectl_delete",
@@ -374,6 +433,7 @@ The `node_management` tool provides comprehensive node management capabilities f
 #### Usage Examples
 
 **1. List all nodes:**
+
 ```json
 {
   "name": "node_management",
@@ -384,6 +444,7 @@ The `node_management` tool provides comprehensive node management capabilities f
 ```
 
 **2. Cordon a node (mark as unschedulable):**
+
 ```json
 {
   "name": "node_management",
@@ -395,6 +456,7 @@ The `node_management` tool provides comprehensive node management capabilities f
 ```
 
 **3. Drain a node (dry run first):**
+
 ```json
 {
   "name": "node_management",
@@ -407,6 +469,7 @@ The `node_management` tool provides comprehensive node management capabilities f
 ```
 
 **4. Drain a node (with confirmation):**
+
 ```json
 {
   "name": "node_management",
@@ -423,6 +486,7 @@ The `node_management` tool provides comprehensive node management capabilities f
 ```
 
 **5. Uncordon a node:**
+
 ```json
 {
   "name": "node_management",

package/dist/tools/kubectl-context.js

@@ -60,21 +60,36 @@ export async function kubectlContext(k8sManager, input) {
                     });
                     // Parse the tabular output from kubectl
                     const lines = rawResult.trim().split("\n");
-                    const headers = lines[0].trim().split(/\s+/);
-                    const currentIndex = headers.indexOf("CURRENT");
-                    const nameIndex = headers.indexOf("NAME");
-                    const clusterIndex = headers.indexOf("CLUSTER");
-                    const authInfoIndex = headers.indexOf("AUTHINFO");
-                    const namespaceIndex = headers.indexOf("NAMESPACE");
+                    const headerLine = lines[0];
+                    // Find column positions based on header positions
+                    const currentPos = headerLine.indexOf("CURRENT");
+                    const namePos = headerLine.indexOf("NAME");
+                    const clusterPos = headerLine.indexOf("CLUSTER");
+                    const authInfoPos = headerLine.indexOf("AUTHINFO");
+                    const namespacePos = headerLine.indexOf("NAMESPACE");
+                    if (currentPos === -1 || namePos === -1 || clusterPos === -1 || authInfoPos === -1 || namespacePos === -1) {
+                        throw new McpError(ErrorCode.InvalidParams, "Invalid kubectl output format");
+                    }
                     const contexts = [];
                     for (let i = 1; i < lines.length; i++) {
-                        const columns = lines[i].trim().split(/\s+/);
-                        const isCurrent = columns[currentIndex]?.trim() === "*";
+                        const line = lines[i];
+                        if (line.trim() === "")
+                            continue; // Skip empty lines
+                        // Extract fields based on column positions
+                        const isCurrent = line.substring(currentPos, namePos).trim() === "*";
+                        const name = line.substring(namePos, clusterPos).trim();
+                        const cluster = line.substring(clusterPos, authInfoPos).trim();
+                        const authInfo = namespacePos > 0
+                            ? line.substring(authInfoPos, namespacePos).trim()
+                            : line.substring(authInfoPos).trim();
+                        const namespace = namespacePos > 0
+                            ? line.substring(namespacePos).trim() || "default"
+                            : "default";
                         contexts.push({
-                            name: columns[nameIndex]?.trim(),
-                            cluster: columns[clusterIndex]?.trim(),
-                            user: columns[authInfoIndex]?.trim(),
-                            namespace: columns[namespaceIndex]?.trim() || "default",
+                            name: name,
+                            cluster: cluster,
+                            user: authInfo,
+                            namespace: namespace,
                             isCurrent: isCurrent,
                         });
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-server-kubernetes",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "MCP server for interacting with Kubernetes clusters via kubectl",
   "license": "MIT",
   "type": "module",