helm

Author: alexeykazakov

README.md

@@ -17,6 +17,8 @@ A powerful and flexible Kubernetes [Model Context Protocol (MCP)](https://blog.m
 - **✅ Configuration**:
   - Automatically detect changes in the Kubernetes configuration and update the MCP server.
   - **View** and manage the current [Kubernetes `.kube/config`](https://blog.marcnuri.com/where-is-my-default-kubeconfig-file) or in-cluster configuration.
+  - **Multi-cluster support**: Switch between different Kubernetes contexts on the fly using the optional `context` parameter on any cluster-specific tool.
+  - **List available contexts**: Discover all available Kubernetes contexts in your kubeconfig with `contexts_list`.
 - **✅ Generic Kubernetes Resources**: Perform operations on **any** Kubernetes or OpenShift resource.
   - Any CRUD operation (Create or Update, Get, List, Delete).
 - **✅ Pods**: Perform Pod-specific operations.
@@ -196,11 +198,21 @@ Get the current Kubernetes configuration content as a kubeconfig YAML
   - If `true`, keeps only the current-context and relevant configuration pieces
   - If `false`, returns all contexts, clusters, auth-infos, and users
 
+### `contexts_list`
+
+List all available Kubernetes contexts from your kubeconfig with their cluster server URLs
+
+**Parameters:** None
+
+**Output format:** `[*] CONTEXT_NAME -> CLUSTER_SERVER_URL` where `*` indicates the current active context.
+
 ### `events_list`
 
 List all the Kubernetes events in the current cluster from all namespaces
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `namespace` (`string`, optional)
   - Namespace to retrieve the events from. If not provided, will list events from all namespaces
 
@@ -209,6 +221,8 @@ List all the Kubernetes events in the current cluster from all namespaces
 Install a Helm chart in the current or provided namespace with the provided name and chart
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `chart` (`string`, required)
   - Name of the Helm chart to install
   - Can be a local path or a remote URL
@@ -228,6 +242,8 @@ Install a Helm chart in the current or provided namespace with the provided name
 List all the Helm releases in the current or provided namespace (or in all namespaces if specified)
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `namespace` (`string`, optional)
   - Namespace to list the Helm releases from
   - If not provided, will use the configured namespace
@@ -240,6 +256,8 @@ List all the Helm releases in the current or provided namespace (or in all names
 Uninstall a Helm release in the current or provided namespace with the provided name
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `name` (`string`, required)
   - Name of the Helm release to uninstall
 - `namespace` (`string`, optional)
@@ -250,13 +268,17 @@ Uninstall a Helm release in the current or provided namespace with the provided
 
 List all the Kubernetes namespaces in the current cluster
 
-**Parameters:** None
+**Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 
 ### `pods_delete`
 
 Delete a Kubernetes Pod in the current or provided namespace with the provided name
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `name` (`string`, required)
   - Name of the Pod to delete
 - `namespace` (`string`, required)
@@ -267,6 +289,8 @@ Delete a Kubernetes Pod in the current or provided namespace with the provided n
 Execute a command in a Kubernetes Pod in the current or provided namespace with the provided name and command
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `command` (`string[]`, required)
   - Command to execute in the Pod container
   - First item is the command, rest are arguments
@@ -283,6 +307,8 @@ Execute a command in a Kubernetes Pod in the current or provided namespace with
 Get a Kubernetes Pod in the current or provided namespace with the provided name
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `name` (`string`, required)
   - Name of the Pod
 - `namespace` (`string`, required)
@@ -293,6 +319,8 @@ Get a Kubernetes Pod in the current or provided namespace with the provided name
 List all the Kubernetes pods in the current cluster from all namespaces
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `labelSelector` (`string`, optional)
   - Kubernetes label selector (e.g., 'app=myapp,env=prod' or 'app in (myapp,yourapp)'). Use this option to filter the pods by label
 
@@ -301,6 +329,8 @@ List all the Kubernetes pods in the current cluster from all namespaces
 List all the Kubernetes pods in the specified namespace in the current cluster
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `namespace` (`string`, required)
   - Namespace to list pods from
 - `labelSelector` (`string`, optional)
@@ -311,6 +341,8 @@ List all the Kubernetes pods in the specified namespace in the current cluster
 Get the logs of a Kubernetes Pod in the current or provided namespace with the provided name
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `name` (`string`, required)
   - Name of the Pod to get logs from
 - `namespace` (`string`, required)
@@ -325,6 +357,8 @@ Get the logs of a Kubernetes Pod in the current or provided namespace with the p
 Run a Kubernetes Pod in the current or provided namespace with the provided container image and optional name
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `image` (`string`, required)
   - Container Image to run in the Pod
 - `namespace` (`string`, required)
@@ -340,6 +374,8 @@ Run a Kubernetes Pod in the current or provided namespace with the provided cont
 Lists the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified Kubernetes Pods in the all namespaces, the provided namespace, or the current namespace
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `all_namespaces` (`boolean`, optional, default: `true`)
   - If `true`, lists resource consumption for Pods in all namespaces
   - If `false`, lists resource consumption for Pods in the configured or provided namespace
@@ -356,11 +392,17 @@ Lists the resource consumption (CPU and memory) as recorded by the Kubernetes Me
 
 List all the OpenShift projects in the current cluster
 
+**Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
+
 ### `resources_create_or_update`
 
 Create or update a Kubernetes resource in the current cluster by providing a YAML or JSON representation of the resource
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `resource` (`string`, required)
   - A JSON or YAML containing a representation of the Kubernetes resource
   - Should include top-level fields such as apiVersion, kind, metadata, and spec
@@ -377,6 +419,8 @@ Create or update a Kubernetes resource in the current cluster by providing a YAM
 Delete a Kubernetes resource in the current cluster
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `apiVersion` (`string`, required)
   - apiVersion of the resource (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`)
 - `kind` (`string`, required)
@@ -393,6 +437,8 @@ Delete a Kubernetes resource in the current cluster
 Get a Kubernetes resource in the current cluster
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `apiVersion` (`string`, required)
   - apiVersion of the resource (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`)
 - `kind` (`string`, required)
@@ -409,6 +455,8 @@ Get a Kubernetes resource in the current cluster
 List Kubernetes resources and objects in the current cluster
 
 **Parameters:**
+- `context` (`string`, optional)
+  - Kubernetes context to use for this operation. If not provided, uses the current context
 - `apiVersion` (`string`, required)
   - apiVersion of the resources (e.g., `v1`, `apps/v1`, `networking.k8s.io/v1`)
 - `kind` (`string`, required)

pkg/mcp/testdata/toolsets-full-tools-openshift.json

@@ -73,6 +73,10 @@
           "description": "Chart reference to install (for example: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)",
           "type": "string"
         },
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "name": {
           "description": "Name of the Helm release (Optional, random name if not provided)",
           "type": "string"
@@ -108,6 +112,10 @@
           "description": "If true, lists all Helm releases in all namespaces ignoring the namespace argument (Optional)",
           "type": "boolean"
         },
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "namespace": {
           "description": "Namespace to list Helm releases from (Optional, all namespaces if not provided)",
           "type": "string"
@@ -128,6 +136,10 @@
     "inputSchema": {
       "type": "object",
       "properties": {
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "name": {
           "description": "Name of the Helm release to uninstall",
           "type": "string"

pkg/mcp/testdata/toolsets-full-tools.json

@@ -73,6 +73,10 @@
           "description": "Chart reference to install (for example: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)",
           "type": "string"
         },
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "name": {
           "description": "Name of the Helm release (Optional, random name if not provided)",
           "type": "string"
@@ -108,6 +112,10 @@
           "description": "If true, lists all Helm releases in all namespaces ignoring the namespace argument (Optional)",
           "type": "boolean"
         },
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "namespace": {
           "description": "Namespace to list Helm releases from (Optional, all namespaces if not provided)",
           "type": "string"
@@ -128,6 +136,10 @@
     "inputSchema": {
       "type": "object",
       "properties": {
+        "context": {
+          "description": "Optional Kubernetes context to use for this operation (if not provided, uses the current context)",
+          "type": "string"
+        },
         "name": {
           "description": "Name of the Helm release to uninstall",
           "type": "string"

pkg/toolsets/full/helm.go

@@ -17,6 +17,7 @@ func initHelm() []api.ServerTool {
 			InputSchema: &jsonschema.Schema{
 				Type: "object",
 				Properties: map[string]*jsonschema.Schema{
+					"context": api.ContextParameterSchema,
 					"chart": {
 						Type:        "string",
 						Description: "Chart reference to install (for example: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)",
@@ -51,6 +52,7 @@ func initHelm() []api.ServerTool {
 			InputSchema: &jsonschema.Schema{
 				Type: "object",
 				Properties: map[string]*jsonschema.Schema{
+					"context": api.ContextParameterSchema,
 					"namespace": {
 						Type:        "string",
 						Description: "Namespace to list Helm releases from (Optional, all namespaces if not provided)",
@@ -75,6 +77,7 @@ func initHelm() []api.ServerTool {
 			InputSchema: &jsonschema.Schema{
 				Type: "object",
 				Properties: map[string]*jsonschema.Schema{
+					"context": api.ContextParameterSchema,
 					"name": {
 						Type:        "string",
 						Description: "Name of the Helm release to uninstall",
@@ -98,6 +101,11 @@ func initHelm() []api.ServerTool {
 }
 
 func helmInstall(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
+	k8sClient, err := api.GetKubernetesWithContext(params)
+	if err != nil {
+		return api.NewToolCallResult("", err), nil
+	}
+
 	var chart string
 	ok := false
 	if chart, ok = params.GetArguments()["chart"].(string); !ok {
@@ -115,14 +123,19 @@ func helmInstall(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 	if v, ok := params.GetArguments()["namespace"].(string); ok {
 		namespace = v
 	}
-	ret, err := params.NewHelm().Install(params, chart, values, name, namespace)
+	ret, err := k8sClient.NewHelm().Install(params, chart, values, name, namespace)
 	if err != nil {
 		return api.NewToolCallResult("", fmt.Errorf("failed to install helm chart '%s': %w", chart, err)), nil
 	}
 	return api.NewToolCallResult(ret, err), nil
 }
 
 func helmList(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
+	k8sClient, err := api.GetKubernetesWithContext(params)
+	if err != nil {
+		return api.NewToolCallResult("", err), nil
+	}
+
 	allNamespaces := false
 	if v, ok := params.GetArguments()["all_namespaces"].(bool); ok {
 		allNamespaces = v
@@ -131,14 +144,19 @@ func helmList(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 	if v, ok := params.GetArguments()["namespace"].(string); ok {
 		namespace = v
 	}
-	ret, err := params.NewHelm().List(namespace, allNamespaces)
+	ret, err := k8sClient.NewHelm().List(namespace, allNamespaces)
 	if err != nil {
 		return api.NewToolCallResult("", fmt.Errorf("failed to list helm releases in namespace '%s': %w", namespace, err)), nil
 	}
 	return api.NewToolCallResult(ret, err), nil
 }
 
 func helmUninstall(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
+	k8sClient, err := api.GetKubernetesWithContext(params)
+	if err != nil {
+		return api.NewToolCallResult("", err), nil
+	}
+
 	var name string
 	ok := false
 	if name, ok = params.GetArguments()["name"].(string); !ok {
@@ -148,7 +166,7 @@ func helmUninstall(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 	if v, ok := params.GetArguments()["namespace"].(string); ok {
 		namespace = v
 	}
-	ret, err := params.NewHelm().Uninstall(name, namespace)
+	ret, err := k8sClient.NewHelm().Uninstall(name, namespace)
 	if err != nil {
 		return api.NewToolCallResult("", fmt.Errorf("failed to uninstall helm chart '%s': %w", name, err)), nil
 	}

pkg/toolsets/full/namespaces.go

@@ -8,7 +8,6 @@ import (
 	"k8s.io/utils/ptr"
 
 	"github.com/containers/kubernetes-mcp-server/pkg/api"
-	"github.com/containers/kubernetes-mcp-server/pkg/kubernetes"
 	internalk8s "github.com/containers/kubernetes-mcp-server/pkg/kubernetes"
 )
 
@@ -64,7 +63,7 @@ func namespacesList(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 		return api.NewToolCallResult("", err), nil
 	}
 
-	ret, err := k8sClient.NamespacesList(params.Context, kubernetes.ResourceListOptions{AsTable: params.ListOutput.AsTable()})
+	ret, err := k8sClient.NamespacesList(params.Context, internalk8s.ResourceListOptions{AsTable: params.ListOutput.AsTable()})
 	if err != nil {
 		return api.NewToolCallResult("", fmt.Errorf("failed to list namespaces: %v", err)), nil
 	}
@@ -78,7 +77,7 @@ func projectsList(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 		return api.NewToolCallResult("", err), nil
 	}
 
-	ret, err := k8sClient.ProjectsList(params.Context, kubernetes.ResourceListOptions{AsTable: params.ListOutput.AsTable()})
+	ret, err := k8sClient.ProjectsList(params.Context, internalk8s.ResourceListOptions{AsTable: params.ListOutput.AsTable()})
 	if err != nil {
 		return api.NewToolCallResult("", fmt.Errorf("failed to list projects: %v", err)), nil
 	}

pkg/toolsets/full/resources.go

@@ -10,7 +10,6 @@ import (
 	"k8s.io/utils/ptr"
 
 	"github.com/containers/kubernetes-mcp-server/pkg/api"
-	"github.com/containers/kubernetes-mcp-server/pkg/kubernetes"
 	internalk8s "github.com/containers/kubernetes-mcp-server/pkg/kubernetes"
 	"github.com/containers/kubernetes-mcp-server/pkg/output"
 )
@@ -162,7 +161,7 @@ func resourcesList(params api.ToolHandlerParams) (*api.ToolCallResult, error) {
 		namespace = ""
 	}
 	labelSelector := params.GetArguments()["labelSelector"]
-	resourceListOptions := kubernetes.ResourceListOptions{
+	resourceListOptions := internalk8s.ResourceListOptions{
 		AsTable: params.ListOutput.AsTable(),
 	}