mcp-server-kubernetes 4.1.7 → 4.1.8

package/dist/config/server-config.d.ts

@@ -1,6 +1,6 @@
 export declare const serverConfig: {
     readonly name: "kubernetes";
-    readonly version: "4.1.7";
+    readonly version: "4.1.8";
     readonly capabilities: {
         readonly resources: {};
         readonly tools: {};

package/dist/config/server-config.js

@@ -1,6 +1,6 @@
 export const serverConfig = {
     name: "kubernetes",
-    version: "4.1.7",
+    version: "4.1.8",
     capabilities: {
         resources: {},
         tools: {},

package/dist/utils/kubernetes-manager.d.ts

@@ -8,7 +8,19 @@ export declare class KubernetesManager {
     private k8sApi;
     private k8sAppsApi;
     private k8sBatchApi;
+    /** Set when API client construction fails (e.g. no active cluster/context). */
+    private clientInitError;
     constructor();
+    /**
+     * Attempt to build Kubernetes API clients. On failure, keep the process
+     * alive in a degraded state; getters and refresh will surface the error.
+     */
+    private tryInitApiClients;
+    /**
+     * Ensure API clients exist, retrying construction if we started degraded.
+     * Throws a clear configuration error if the kubeconfig still has no active cluster.
+     */
+    private ensureApiClients;
     /**
      * A very simple test to check if the application is running inside a Kubernetes cluster
      */
@@ -64,6 +76,11 @@ export declare class KubernetesManager {
     getCoreApi(): k8s.CoreV1Api;
     getAppsApi(): k8s.AppsV1Api;
     getBatchApi(): k8s.BatchV1Api;
+    /**
+     * True when API clients failed to initialize (e.g. empty current-context).
+     */
+    hasClientInitError(): boolean;
+    getClientInitError(): Error | undefined;
     /**
      * Get the default namespace for operations
      * Uses K8S_NAMESPACE environment variable if set, otherwise defaults to "default"

package/dist/utils/kubernetes-manager.js

@@ -10,6 +10,8 @@ export class KubernetesManager {
     k8sApi;
     k8sAppsApi;
     k8sBatchApi;
+    /** Set when API client construction fails (e.g. no active cluster/context). */
+    clientInitError;
     constructor() {
         this.kc = new k8s.KubeConfig();
         if (this.hasEnvKubeconfigYaml()) {
@@ -78,10 +80,45 @@ export class KubernetesManager {
                 console.warn(`Warning: Could not set context to ${process.env.K8S_CONTEXT}: ${error instanceof Error ? error.message : "Unknown error"}`);
             }
         }
-        // Initialize API clients
-        this.k8sApi = this.kc.makeApiClient(k8s.CoreV1Api);
-        this.k8sAppsApi = this.kc.makeApiClient(k8s.AppsV1Api);
-        this.k8sBatchApi = this.kc.makeApiClient(k8s.BatchV1Api);
+        // Initialize API clients in degraded mode on failure so MCP initialize
+        // can still succeed when kubeconfig has no usable current-context.
+        this.tryInitApiClients();
+    }
+    /**
+     * Attempt to build Kubernetes API clients. On failure, keep the process
+     * alive in a degraded state; getters and refresh will surface the error.
+     */
+    tryInitApiClients() {
+        try {
+            this.refreshApiClients();
+        }
+        catch (error) {
+            this.clientInitError =
+                error instanceof Error ? error : new Error(String(error));
+            this.k8sApi = undefined;
+            this.k8sAppsApi = undefined;
+            this.k8sBatchApi = undefined;
+            console.error(`Warning: Kubernetes API clients not initialized: ${this.clientInitError.message}`);
+        }
+    }
+    /**
+     * Ensure API clients exist, retrying construction if we started degraded.
+     * Throws a clear configuration error if the kubeconfig still has no active cluster.
+     */
+    ensureApiClients() {
+        if (this.k8sApi && this.k8sAppsApi && this.k8sBatchApi) {
+            return;
+        }
+        try {
+            this.refreshApiClients();
+        }
+        catch (error) {
+            const message = error instanceof Error
+                ? error.message
+                : this.clientInitError?.message || String(error);
+            throw new Error(`Kubernetes configuration error: ${message}. ` +
+                "Set a valid current-context in your kubeconfig (or via K8S_CONTEXT) and restart the server.");
+        }
     }
     /**
      * A very simple test to check if the application is running inside a Kubernetes cluster
@@ -190,6 +227,7 @@ export class KubernetesManager {
         this.k8sApi = this.kc.makeApiClient(k8s.CoreV1Api);
         this.k8sAppsApi = this.kc.makeApiClient(k8s.AppsV1Api);
         this.k8sBatchApi = this.kc.makeApiClient(k8s.BatchV1Api);
+        this.clientInitError = undefined;
     }
     setCurrentContext(contextName) {
         // Get all available contexts
@@ -199,11 +237,9 @@ export class KubernetesManager {
         if (!contextNames.includes(contextName)) {
             throw new Error(`Context '${contextName}' not found. Available contexts: ${contextNames.join(", ")}`);
         }
-        // Set the current context
+        // Set the current context and rebuild clients (recovers from degraded mode)
         this.kc.setCurrentContext(contextName);
-        this.k8sApi = this.kc.makeApiClient(k8s.CoreV1Api);
-        this.k8sAppsApi = this.kc.makeApiClient(k8s.AppsV1Api);
-        this.k8sBatchApi = this.kc.makeApiClient(k8s.BatchV1Api);
+        this.refreshApiClients();
     }
     async cleanup() {
         // Stop watches
@@ -224,18 +260,21 @@ export class KubernetesManager {
         this.resources.push({ kind, name, namespace, createdAt: new Date() });
     }
     async deleteResource(kind, name, namespace) {
+        const coreApi = this.getCoreApi();
+        const appsApi = this.getAppsApi();
+        const batchApi = this.getBatchApi();
         switch (kind.toLowerCase()) {
             case "pod":
-                await this.k8sApi.deleteNamespacedPod({ name, namespace });
+                await coreApi.deleteNamespacedPod({ name, namespace });
                 break;
             case "deployment":
-                await this.k8sAppsApi.deleteNamespacedDeployment({ name, namespace });
+                await appsApi.deleteNamespacedDeployment({ name, namespace });
                 break;
             case "service":
-                await this.k8sApi.deleteNamespacedService({ name, namespace });
+                await coreApi.deleteNamespacedService({ name, namespace });
                 break;
             case "cronjob":
-                await this.k8sBatchApi.deleteNamespacedCronJob({ name, namespace });
+                await batchApi.deleteNamespacedCronJob({ name, namespace });
                 break;
         }
         this.resources = this.resources.filter((r) => !(r.kind === kind && r.name === name && r.namespace === namespace));
@@ -256,14 +295,26 @@ export class KubernetesManager {
         return this.kc;
     }
     getCoreApi() {
+        this.ensureApiClients();
         return this.k8sApi;
     }
     getAppsApi() {
+        this.ensureApiClients();
         return this.k8sAppsApi;
     }
     getBatchApi() {
+        this.ensureApiClients();
         return this.k8sBatchApi;
     }
+    /**
+     * True when API clients failed to initialize (e.g. empty current-context).
+     */
+    hasClientInitError() {
+        return !!this.clientInitError || !this.k8sApi;
+    }
+    getClientInitError() {
+        return this.clientInitError;
+    }
     /**
      * Get the default namespace for operations
      * Uses K8S_NAMESPACE environment variable if set, otherwise defaults to "default"

package/package.json

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