mcp-server-kubernetes 2.6.0 → 2.8.0

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

@@ -14,9 +14,9 @@ export declare const kubectlDeleteSchema: {
                 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";
@@ -44,6 +44,11 @@ export declare const kubectlDeleteSchema: {
                 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"];
     };
@@ -58,6 +63,7 @@ export declare function kubectlDelete(k8sManager: KubernetesManager, input: {
     allNamespaces?: boolean;
     force?: boolean;
     gracePeriodSeconds?: number;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-delete.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 } from "../models/common-parameters.js";
 export const kubectlDeleteSchema = {
     name: "kubectl_delete",
     description: "Delete Kubernetes resources by resource type, name, labels, or from a manifest file",
@@ -18,11 +19,7 @@ export const kubectlDeleteSchema = {
                 type: "string",
                 description: "Name of the resource to delete",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             labelSelector: {
                 type: "string",
                 description: "Delete resources matching this label selector (e.g. 'app=nginx')",
@@ -49,6 +46,7 @@ export const kubectlDeleteSchema = {
                 type: "number",
                 description: "Period of time in seconds given to the resource to terminate gracefully",
             },
+            context: contextParameter,
         },
         required: ["resourceType", "name", "namespace"],
     },
@@ -66,6 +64,7 @@ export async function kubectlDelete(k8sManager, input) {
         const namespace = input.namespace || "default";
         const allNamespaces = input.allNamespaces || false;
         const force = input.force || false;
+        const context = input.context || "";
         const command = "kubectl";
         const args = ["delete"];
         let tempFile = null;
@@ -107,6 +106,10 @@ export async function kubectlDelete(k8sManager, input) {
         if (input.gracePeriodSeconds !== undefined) {
             args.push(`--grace-period=${input.gracePeriodSeconds}`);
         }
+        // Add context if provided
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             const result = execFileSync(command, args, {

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

@@ -14,9 +14,14 @@ export declare const kubectlDescribeSchema: {
                 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";
@@ -32,6 +37,7 @@ export declare function kubectlDescribe(k8sManager: KubernetesManager, input: {
     name: string;
     namespace?: string;
     allNamespaces?: boolean;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-describe.js

@@ -1,6 +1,7 @@
 import { execFileSync } from "child_process";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { namespaceParameter, contextParameter } from "../models/common-parameters.js";
 export const kubectlDescribeSchema = {
     name: "kubectl_describe",
     description: "Describe Kubernetes resources by resource type, name, and optionally namespace",
@@ -15,11 +16,8 @@ export const kubectlDescribeSchema = {
                 type: "string",
                 description: "Name of the resource to describe",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)",
-                default: "default",
-            },
+            namespace: namespaceParameter,
+            context: contextParameter,
             allNamespaces: {
                 type: "boolean",
                 description: "If true, describe resources across all namespaces",
@@ -35,6 +33,7 @@ export async function kubectlDescribe(k8sManager, input) {
         const name = input.name;
         const namespace = input.namespace || "default";
         const allNamespaces = input.allNamespaces || false;
+        const context = input.context || "";
         // Build the kubectl command
         const command = "kubectl";
         const args = ["describe", resourceType, name];
@@ -45,6 +44,9 @@ export async function kubectlDescribe(k8sManager, input) {
         else if (namespace && !isNonNamespacedResource(resourceType)) {
             args.push("-n", namespace);
         }
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             const result = execFileSync(command, args, {

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

@@ -22,7 +22,7 @@ export declare const kubectlGenericSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
                 default: string;
             };
@@ -43,6 +43,11 @@ export declare const kubectlGenericSchema: {
                 };
                 description: string;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         required: string[];
     };
@@ -56,6 +61,7 @@ export declare function kubectlGeneric(k8sManager: KubernetesManager, input: {
     outputFormat?: string;
     flags?: Record<string, any>;
     args?: string[];
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-generic.js

@@ -1,6 +1,7 @@
 import { execFileSync } from "child_process";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 export const kubectlGenericSchema = {
     name: "kubectl_generic",
     description: "Execute any kubectl command with the provided arguments and flags",
@@ -23,11 +24,7 @@ export const kubectlGenericSchema = {
                 type: "string",
                 description: "Resource name",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             outputFormat: {
                 type: "string",
                 description: "Output format (e.g. json, yaml, wide)",
@@ -43,6 +40,7 @@ export const kubectlGenericSchema = {
                 items: { type: "string" },
                 description: "Additional command arguments",
             },
+            context: contextParameter,
         },
         required: ["command"],
     },
@@ -89,6 +87,10 @@ export async function kubectlGeneric(k8sManager, input) {
         if (input.args && input.args.length > 0) {
             cmdArgs.push(...input.args);
         }
+        // Add context if provided
+        if (input.context) {
+            cmdArgs.push("--context", input.context);
+        }
         // Execute the command
         try {
             console.error(`Executing: kubectl ${cmdArgs.join(" ")}`);

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

@@ -14,9 +14,9 @@ export declare const kubectlGetSchema: {
                 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";
@@ -41,6 +41,11 @@ export declare const kubectlGetSchema: {
                 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"];
     };
@@ -54,6 +59,7 @@ export declare function kubectlGet(k8sManager: KubernetesManager, input: {
     labelSelector?: string;
     fieldSelector?: string;
     sortBy?: string;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-get.js

@@ -2,6 +2,7 @@ import { execFileSync } from "child_process";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
 import * as yaml from "js-yaml";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 export const kubectlGetSchema = {
     name: "kubectl_get",
     description: "Get or list Kubernetes resources by resource type, name, and optionally namespace",
@@ -16,11 +17,7 @@ export const kubectlGetSchema = {
                 type: "string",
                 description: "Name of the resource (optional - if not provided, lists all resources of the specified type)",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource (optional - defaults to 'default' for namespaced resources)",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             output: {
                 type: "string",
                 enum: ["json", "yaml", "wide", "name", "custom"],
@@ -44,6 +41,7 @@ export const kubectlGetSchema = {
                 type: "string",
                 description: "Sort events by a field (default: lastTimestamp). Only applicable for events.",
             },
+            context: contextParameter
         },
         required: ["resourceType", "name", "namespace"],
     },
@@ -58,6 +56,7 @@ export async function kubectlGet(k8sManager, input) {
         const labelSelector = input.labelSelector || "";
         const fieldSelector = input.fieldSelector || "";
         const sortBy = input.sortBy;
+        const context = input.context || "";
         // Build the kubectl command
         const command = "kubectl";
         const args = ["get", resourceType];
@@ -78,6 +77,9 @@ export async function kubectlGet(k8sManager, input) {
         else if (namespace && !isNonNamespacedResource(resourceType)) {
             args.push("-n", namespace);
         }
+        if (context) {
+            args.push("--context", context);
+        }
         // Add label selector if provided
         if (labelSelector) {
             args.push("-l", labelSelector);

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

@@ -15,9 +15,9 @@ export declare const kubectlLogsSchema: {
                 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";
@@ -54,6 +54,11 @@ export declare const kubectlLogsSchema: {
                 readonly type: "string";
                 readonly description: "Filter resources by label selector";
             };
+            readonly context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         readonly required: readonly ["resourceType", "name", "namespace"];
     };
@@ -70,6 +75,7 @@ export declare function kubectlLogs(k8sManager: KubernetesManager, input: {
     previous?: boolean;
     follow?: boolean;
     labelSelector?: string;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-logs.js

@@ -1,6 +1,7 @@
 import { execFileSync } from "child_process";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 export const kubectlLogsSchema = {
     name: "kubectl_logs",
     description: "Get logs from Kubernetes resources like pods, deployments, or jobs",
@@ -16,11 +17,7 @@ export const kubectlLogsSchema = {
                 type: "string",
                 description: "Name of the resource",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             container: {
                 type: "string",
                 description: "Container name (required when pod has multiple containers)",
@@ -56,6 +53,7 @@ export const kubectlLogsSchema = {
                 type: "string",
                 description: "Filter resources by label selector",
             },
+            context: contextParameter,
         },
         required: ["resourceType", "name", "namespace"],
     },
@@ -65,6 +63,7 @@ export async function kubectlLogs(k8sManager, input) {
         const resourceType = input.resourceType.toLowerCase();
         const name = input.name;
         const namespace = input.namespace || "default";
+        const context = input.context || "";
         const command = "kubectl";
         // Handle different resource types
         if (resourceType === "pod") {
@@ -76,6 +75,10 @@ export async function kubectlLogs(k8sManager, input) {
             }
             // Add options
             args = addLogOptions(args, input);
+            // Add context if provided
+            if (context) {
+                args.push("--context", context);
+            }
             // Execute the command
             try {
                 const result = execFileSync(command, args, {
@@ -235,6 +238,9 @@ function addLogOptions(args, input) {
     if (input.follow) {
         args.push(`--follow`);
     }
+    if (input.context) {
+        args.push("--context", input.context);
+    }
     return args;
 }
 // Helper function to get logs for resources selected by labels

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

@@ -18,6 +18,11 @@ export declare const explainResourceSchema: {
                 description: string;
                 default: boolean;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
             output: {
                 type: string;
                 description: string;
@@ -42,6 +47,11 @@ export declare const listApiResourcesSchema: {
                 type: string;
                 description: string;
             };
+            context: {
+                type: string;
+                description: string;
+                default: string;
+            };
             verbs: {
                 type: string;
                 items: {

package/dist/tools/kubectl-operations.js

@@ -1,5 +1,6 @@
 import { execFileSync } from "child_process";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter } from "../models/common-parameters.js";
 export const explainResourceSchema = {
     name: "explain_resource",
     description: "Get documentation for a Kubernetes resource or field",
@@ -19,6 +20,7 @@ export const explainResourceSchema = {
                 description: "Print the fields of fields recursively",
                 default: false,
             },
+            context: contextParameter,
             output: {
                 type: "string",
                 description: "Output format (plaintext or plaintext-openapiv2)",
@@ -43,6 +45,11 @@ export const listApiResourcesSchema = {
                 type: "boolean",
                 description: "If true, only show namespaced resources",
             },
+            context: {
+                type: "string",
+                description: "Kubeconfig Context to use for the command (optional - defaults to null)",
+                default: "",
+            },
             verbs: {
                 type: "array",
                 items: {
@@ -81,6 +88,9 @@ export async function explainResource(params) {
         if (params.recursive) {
             args.push("--recursive");
         }
+        if (params.context) {
+            args.push("--context", params.context);
+        }
         if (params.output) {
             args.push(`--output=${params.output}`);
         }
@@ -115,6 +125,9 @@ export async function listApiResources(params) {
         if (params.output) {
             args.push(`-o`, params.output);
         }
+        if (params.context) {
+            args.push("--context", params.context);
+        }
         const result = executeKubectlCommand(command, args);
         return {
             content: [

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

@@ -14,7 +14,7 @@ export declare const kubectlPatchSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
                 default: string;
             };
@@ -33,10 +33,15 @@ export declare const kubectlPatchSchema: {
                 description: string;
             };
             dryRun: {
-                type: string;
+                type: "boolean";
                 description: string;
                 default: boolean;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         required: string[];
     };
@@ -49,6 +54,7 @@ export declare function kubectlPatch(k8sManager: KubernetesManager, input: {
     patchData?: object;
     patchFile?: string;
     dryRun?: boolean;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-patch.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, dryRunParameter, namespaceParameter } from "../models/common-parameters.js";
 export const kubectlPatchSchema = {
     name: "kubectl_patch",
     description: "Update field(s) of a resource using strategic merge patch, JSON merge patch, or JSON patch",
@@ -18,11 +19,7 @@ export const kubectlPatchSchema = {
                 type: "string",
                 description: "Name of the resource to patch",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             patchType: {
                 type: "string",
                 description: "Type of patch to apply",
@@ -37,11 +34,8 @@ export const kubectlPatchSchema = {
                 type: "string",
                 description: "Path to a file containing the patch data (alternative to patchData)",
             },
-            dryRun: {
-                type: "boolean",
-                description: "If true, only print the object that would be sent, without sending it",
-                default: false,
-            },
+            dryRun: dryRunParameter,
+            context: contextParameter,
         },
         required: ["resourceType", "name"],
     },
@@ -54,6 +48,7 @@ export async function kubectlPatch(k8sManager, input) {
         const namespace = input.namespace || "default";
         const patchType = input.patchType || "strategic";
         const dryRun = input.dryRun || false;
+        const context = input.context || "";
         let tempFile = null;
         const command = "kubectl";
         const args = ["patch", input.resourceType, input.name, "-n", namespace];
@@ -86,6 +81,10 @@ export async function kubectlPatch(k8sManager, input) {
         if (dryRun) {
             args.push("--dry-run=client");
         }
+        // Add context if provided
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             const result = execFileSync(command, args, {

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

@@ -22,7 +22,7 @@ export declare const kubectlRolloutSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
                 default: string;
             };
@@ -43,6 +43,11 @@ export declare const kubectlRolloutSchema: {
                 description: string;
                 default: boolean;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         required: string[];
     };
@@ -56,6 +61,7 @@ export declare function kubectlRollout(k8sManager: KubernetesManager, input: {
     toRevision?: number;
     timeout?: string;
     watch?: boolean;
+    context?: string;
 }): Promise<{
     content: {
         type: string;

package/dist/tools/kubectl-rollout.js

@@ -1,6 +1,7 @@
 import { execFileSync } from "child_process";
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
 import { getSpawnMaxBuffer } from "../config/max-buffer.js";
+import { contextParameter, namespaceParameter } from "../models/common-parameters.js";
 export const kubectlRolloutSchema = {
     name: "kubectl_rollout",
     description: "Manage the rollout of a resource (e.g., deployment, daemonset, statefulset)",
@@ -23,11 +24,7 @@ export const kubectlRolloutSchema = {
                 type: "string",
                 description: "Name of the resource",
             },
-            namespace: {
-                type: "string",
-                description: "Namespace of the resource",
-                default: "default",
-            },
+            namespace: namespaceParameter,
             revision: {
                 type: "number",
                 description: "Revision to rollback to (for undo subcommand)",
@@ -45,6 +42,7 @@ export const kubectlRolloutSchema = {
                 description: "Watch the rollout status in real-time until completion",
                 default: false,
             },
+            context: contextParameter,
         },
         required: ["subCommand", "resourceType", "name", "namespace"],
     },
@@ -53,6 +51,7 @@ export async function kubectlRollout(k8sManager, input) {
     try {
         const namespace = input.namespace || "default";
         const watch = input.watch || false;
+        const context = input.context || "";
         const command = "kubectl";
         const args = [
             "rollout",
@@ -73,6 +72,10 @@ export async function kubectlRollout(k8sManager, input) {
         if (input.timeout) {
             args.push(`--timeout=${input.timeout}`);
         }
+        // Add context if provided
+        if (context) {
+            args.push("--context", context);
+        }
         // Execute the command
         try {
             // For status command with watch flag, we need to handle it differently

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

@@ -10,7 +10,7 @@ export declare const kubectlScaleSchema: {
                 description: string;
             };
             namespace: {
-                type: string;
+                type: "string";
                 description: string;
                 default: string;
             };
@@ -23,6 +23,11 @@ export declare const kubectlScaleSchema: {
                 description: string;
                 default: string;
             };
+            context: {
+                type: "string";
+                description: string;
+                default: string;
+            };
         };
         required: string[];
     };
@@ -32,6 +37,7 @@ export declare function kubectlScale(k8sManager: KubernetesManager, input: {
     namespace?: string;
     replicas: number;
     resourceType?: string;
+    context?: string;
 }): Promise<{
     content: {
         success: boolean;