mcp-server-kubernetes 2.6.0 → 2.8.0

package/dist/index.d.ts

@@ -10,8 +10,14 @@ declare const destructiveTools: ({
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
+                default: string;
+            };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
             };
         };
         required: string[];
@@ -38,9 +44,9 @@ declare const destructiveTools: ({
                 readonly description: "Name of the resource to delete";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly labelSelector: {
                 readonly type: "string";
@@ -68,6 +74,11 @@ declare const destructiveTools: ({
                 readonly type: "number";
                 readonly description: "Period of time in seconds given to the resource to terminate gracefully";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly ["resourceType", "name", "namespace"];
     };
@@ -83,8 +94,14 @@ declare const allTools: ({
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
+                description: string;
+                default: string;
+            };
+            context: {
+                type: "string";
                 description: string;
+                default: string;
             };
         };
         required: string[];
@@ -108,6 +125,11 @@ declare const allTools: ({
                 description: string;
                 default: boolean;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
             output: {
                 type: string;
                 description: string;
@@ -131,6 +153,11 @@ declare const allTools: ({
                 type: string;
                 description: string;
             };
+            context: {
+                type: string;
+                description: string;
+                default: string;
+            };
             verbs: {
                 type: string;
                 items: {
@@ -239,9 +266,9 @@ declare const allTools: ({
                 readonly description: "Name of the resource (optional - if not provided, lists all resources of the specified type)";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly output: {
                 readonly type: "string";
@@ -266,6 +293,11 @@ declare const allTools: ({
                 readonly type: "string";
                 readonly description: "Sort events by a field (default: lastTimestamp). Only applicable for events.";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly ["resourceType", "name", "namespace"];
     };
@@ -284,9 +316,14 @@ declare const allTools: ({
                 readonly description: "Name of the resource to describe";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
+            };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly allNamespaces: {
                 readonly type: "boolean";
@@ -311,20 +348,25 @@ declare const allTools: ({
                 readonly description: "Path to a YAML file to apply (optional - use either manifest or filename)";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace to apply the resource to (optional)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly dryRun: {
-                readonly type: "boolean";
-                readonly description: "If true, only validate the resource, don't apply it";
-                readonly default: false;
+                type: "boolean";
+                description: string;
+                default: boolean;
             };
             readonly force: {
                 readonly type: "boolean";
                 readonly description: "If true, immediately remove resources from API and bypass graceful deletion";
                 readonly default: false;
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly [];
     };
@@ -343,9 +385,9 @@ declare const allTools: ({
                 readonly description: "Name of the resource to delete";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly labelSelector: {
                 readonly type: "string";
@@ -373,6 +415,11 @@ declare const allTools: ({
                 readonly type: "number";
                 readonly description: "Period of time in seconds given to the resource to terminate gracefully";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly ["resourceType", "name", "namespace"];
     };
@@ -383,9 +430,9 @@ declare const allTools: ({
         readonly type: "object";
         readonly properties: {
             readonly dryRun: {
-                readonly type: "boolean";
-                readonly description: "If true, only validate the resource, don't actually create it";
-                readonly default: false;
+                type: "boolean";
+                description: string;
+                default: boolean;
             };
             readonly output: {
                 readonly type: "string";
@@ -415,9 +462,9 @@ declare const allTools: ({
                 readonly description: "Name of the resource to create";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace to create the resource in";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly fromLiteral: {
                 readonly type: "array";
@@ -493,6 +540,11 @@ declare const allTools: ({
                 };
                 readonly description: "Annotations to apply to the resource (e.g. [\"key1=value1\", \"key2=value2\"])";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly [];
     };
@@ -512,9 +564,9 @@ declare const allTools: ({
                 readonly description: "Name of the resource";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace of the resource";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly container: {
                 readonly type: "string";
@@ -551,6 +603,11 @@ declare const allTools: ({
                 readonly type: "string";
                 readonly description: "Filter resources by label selector";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly ["resourceType", "name", "namespace"];
     };

package/dist/index.js

@@ -24,6 +24,7 @@ import { kubectlPatch, kubectlPatchSchema } from "./tools/kubectl-patch.js";
 import { kubectlRollout, kubectlRolloutSchema, } from "./tools/kubectl-rollout.js";
 import { registerPromptHandlers } from "./prompts/index.js";
 import { ping, pingSchema } from "./tools/ping.js";
+import { startStreamableHTTPServer } from "./utils/streamable-http.js";
 // Check environment variables for tool filtering
 const allowOnlyReadonlyTools = process.env.ALLOW_ONLY_READONLY_TOOLS === "true";
 const allowedToolsEnv = process.env.ALLOWED_TOOLS;
@@ -155,6 +156,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 labelSelector: input.labelSelector,
                 sortBy: input.sortBy,
                 output: input.output,
+                context: input.context,
             });
         }
         // Handle specific non-kubectl operations
@@ -217,6 +219,10 @@ if (process.env.ENABLE_UNSAFE_SSE_TRANSPORT) {
     startSSEServer(server);
     console.log(`SSE server started`);
 }
+else if (process.env.ENABLE_UNSAFE_STREAMABLE_HTTP_TRANSPORT) {
+    startStreamableHTTPServer(server);
+    console.log(`Streamable HTTP server started`);
+}
 else {
     const transport = new StdioServerTransport();
     console.error(`Starting Kubernetes MCP server v${serverConfig.version}, handling commands...`);

package/dist/models/common-parameters.d.ts

@@ -0,0 +1,15 @@
+export declare const contextParameter: {
+    type: "string";
+    description: string;
+    default: string;
+};
+export declare const namespaceParameter: {
+    type: "string";
+    description: string;
+    default: string;
+};
+export declare const dryRunParameter: {
+    type: "boolean";
+    description: string;
+    default: boolean;
+};

package/dist/models/common-parameters.js

@@ -0,0 +1,15 @@
+export const contextParameter = {
+    type: "string",
+    description: "Kubeconfig Context to use for the command (optional - defaults to null)",
+    default: "",
+};
+export const namespaceParameter = {
+    type: "string",
+    description: "Kubernetes namespace",
+    default: "default",
+};
+export const dryRunParameter = {
+    type: "boolean",
+    description: "If true, only validate the resource, don't actually execute the operation",
+    default: false,
+};

package/dist/models/kubectl-models.d.ts

@@ -26,10 +26,12 @@ export interface ExplainResourceParams {
     apiVersion?: string;
     recursive?: boolean;
     output?: "plaintext" | "plaintext-openapiv2";
+    context?: string;
 }
 export interface ListApiResourcesParams {
     apiGroup?: string;
     namespaced?: boolean;
     verbs?: string[];
     output?: "wide" | "name" | "no-headers";
+    context?: string;
 }

package/dist/tools/exec_in_pod.d.ts

@@ -23,7 +23,7 @@ export declare const execInPodSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
                 default: string;
             };
@@ -51,6 +51,11 @@ export declare const execInPodSchema: {
                 type: string;
                 description: string;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         required: string[];
     };
@@ -67,6 +72,7 @@ export declare function execInPod(k8sManager: KubernetesManager, input: {
     container?: string;
     shell?: string;
     timeout?: number;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/exec_in_pod.js

@@ -7,6 +7,7 @@
 import * as k8s from "@kubernetes/client-node";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { Writable } from "stream";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 /**
  * Schema for exec_in_pod tool.
  * - name: Pod name
@@ -24,11 +25,7 @@ export const execInPodSchema = {
                 type: "string",
                 description: "Name of the pod to execute the command in",
             },
-            namespace: {
-                type: "string",
-                description: "Kubernetes namespace where the pod is located",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             command: {
                 anyOf: [
                     { type: "string" },
@@ -48,6 +45,7 @@ export const execInPodSchema = {
                 type: "number",
                 description: "Timeout for command - 60000 milliseconds if not specified",
             },
+            context: contextParameter,
         },
         required: ["name", "command"],
     },
@@ -93,6 +91,10 @@ export async function execInPod(k8sManager, input) {
         }
     });
     try {
+        // Set context if provided
+        if (input.context) {
+            k8sManager.setCurrentContext(input.context);
+        }
         // Use the Kubernetes client-node Exec API for native exec
         const kc = k8sManager.getKubeConfig();
         const exec = new k8s.Exec(kc);

package/dist/tools/helm-operations.d.ts

@@ -18,8 +18,14 @@ export declare const installHelmChartSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
+                description: string;
+                default: string;
+            };
+            context: {
+                type: "string";
                 description: string;
+                default: string;
             };
             values: {
                 type: string;
@@ -50,8 +56,14 @@ export declare const upgradeHelmChartSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
+                default: string;
+            };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
             };
             values: {
                 type: string;
@@ -74,8 +86,14 @@ export declare const uninstallHelmChartSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
+                description: string;
+                default: string;
+            };
+            context: {
+                type: "string";
                 description: string;
+                default: string;
             };
         };
         required: string[];

package/dist/tools/helm-operations.js

@@ -2,6 +2,7 @@ import { execFileSync } from "child_process";
 import { writeFileSync, unlinkSync } from "fs";
 import yaml from "yaml";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 export const installHelmChartSchema = {
     name: "install_helm_chart",
     description: "Install a Helm chart",
@@ -20,10 +21,8 @@ export const installHelmChartSchema = {
                 type: "string",
                 description: "Chart repository URL",
             },
-            namespace: {
-                type: "string",
-                description: "Kubernetes namespace",
-            },
+            namespace: namespaceParameter,
+            context: contextParameter,
             values: {
                 type: "object",
                 description: "Chart values",
@@ -52,10 +51,8 @@ export const upgradeHelmChartSchema = {
                 type: "string",
                 description: "Chart repository URL",
             },
-            namespace: {
-                type: "string",
-                description: "Kubernetes namespace",
-            },
+            namespace: namespaceParameter,
+            context: contextParameter,
             values: {
                 type: "object",
                 description: "Chart values",
@@ -76,10 +73,8 @@ export const uninstallHelmChartSchema = {
                 type: "string",
                 description: "Release name",
             },
-            namespace: {
-                type: "string",
-                description: "Kubernetes namespace",
-            },
+            namespace: namespaceParameter,
+            context: contextParameter,
         },
         required: ["name", "namespace"],
     },

package/dist/tools/kubectl-apply.d.ts

@@ -14,20 +14,25 @@ export declare const kubectlApplySchema: {
                 readonly description: "Path to a YAML file to apply (optional - use either manifest or filename)";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace to apply the resource to (optional)";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly dryRun: {
-                readonly type: "boolean";
-                readonly description: "If true, only validate the resource, don't apply it";
-                readonly default: false;
+                type: "boolean";
+                description: string;
+                default: boolean;
             };
             readonly force: {
                 readonly type: "boolean";
                 readonly description: "If true, immediately remove resources from API and bypass graceful deletion";
                 readonly default: false;
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly [];
     };
@@ -38,6 +43,7 @@ export declare function kubectlApply(k8sManager: KubernetesManager, input: {
     namespace?: string;
     dryRun?: boolean;
     force?: boolean;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-apply.js

@@ -4,6 +4,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter, dryRunParameter } from "../models/common-parameters.js";
 export const kubectlApplySchema = {
     name: "kubectl_apply",
     description: "Apply a Kubernetes YAML manifest from a string or file",
@@ -18,21 +19,14 @@ export const kubectlApplySchema = {
                 type: "string",
                 description: "Path to a YAML file to apply (optional - use either manifest or filename)",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace to apply the resource to (optional)",
-                default: "default",
-            },
-            dryRun: {
-                type: "boolean",
-                description: "If true, only validate the resource, don't apply it",
-                default: false,
-            },
+            namespace: namespaceParameter,
+            dryRun: dryRunParameter,
             force: {
                 type: "boolean",
                 description: "If true, immediately remove resources from API and bypass graceful deletion",
                 default: false,
             },
+            context: contextParameter,
         },
         required: [],
     },
@@ -45,6 +39,7 @@ export async function kubectlApply(k8sManager, input) {
         const namespace = input.namespace || "default";
         const dryRun = input.dryRun || false;
         const force = input.force || false;
+        const context = input.context || "";
         let command = "kubectl";
         let args = ["apply"];
         let tempFile = null;
@@ -69,6 +64,10 @@ export async function kubectlApply(k8sManager, input) {
         if (force) {
             args.push("--force");
         }
+        // Add context if provided
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             const result = execFileSync(command, args, {

package/dist/tools/kubectl-create.d.ts

@@ -6,9 +6,9 @@ export declare const kubectlCreateSchema: {
         readonly type: "object";
         readonly properties: {
             readonly dryRun: {
-                readonly type: "boolean";
-                readonly description: "If true, only validate the resource, don't actually create it";
-                readonly default: false;
+                type: "boolean";
+                description: string;
+                default: boolean;
             };
             readonly output: {
                 readonly type: "string";
@@ -38,9 +38,9 @@ export declare const kubectlCreateSchema: {
                 readonly description: "Name of the resource to create";
             };
             readonly namespace: {
-                readonly type: "string";
-                readonly description: "Namespace to create the resource in";
-                readonly default: "default";
+                type: "string";
+                description: string;
+                default: string;
             };
             readonly fromLiteral: {
                 readonly type: "array";
@@ -116,6 +116,11 @@ export declare const kubectlCreateSchema: {
                 };
                 readonly description: "Annotations to apply to the resource (e.g. [\"key1=value1\", \"key2=value2\"])";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly [];
     };
@@ -142,6 +147,7 @@ export declare function kubectlCreate(k8sManager: KubernetesManager, input: {
     annotations?: string[];
     schedule?: string;
     suspend?: boolean;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-create.js

@@ -4,6 +4,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter, dryRunParameter } from "../models/common-parameters.js";
 export const kubectlCreateSchema = {
     name: "kubectl_create",
     description: "Create Kubernetes resources using various methods (from file or using subcommands)",
@@ -11,11 +12,7 @@ export const kubectlCreateSchema = {
         type: "object",
         properties: {
             // General options
-            dryRun: {
-                type: "boolean",
-                description: "If true, only validate the resource, don't actually create it",
-                default: false,
-            },
+            dryRun: dryRunParameter,
             output: {
                 type: "string",
                 enum: [
@@ -57,11 +54,7 @@ export const kubectlCreateSchema = {
                 type: "string",
                 description: "Name of the resource to create",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace to create the resource in",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             // ConfigMap specific parameters
             fromLiteral: {
                 type: "array",
@@ -133,6 +126,7 @@ export const kubectlCreateSchema = {
                 items: { type: "string" },
                 description: 'Annotations to apply to the resource (e.g. ["key1=value1", "key2=value2"])',
             },
+            context: contextParameter,
         },
         required: [],
     },
@@ -154,6 +148,7 @@ export async function kubectlCreate(k8sManager, input) {
         const dryRun = input.dryRun || false;
         const validate = input.validate ?? true;
         const output = input.output || "yaml";
+        const context = input.context || "";
         const command = "kubectl";
         const args = ["create"];
         let tempFile = null;
@@ -293,6 +288,10 @@ export async function kubectlCreate(k8sManager, input) {
         }
         // Add output format
         args.push("-o", output);
+        // Add context if provided
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             const result = execFileSync(command, args, {