mcp-server-kubernetes 0.1.4 → 0.2.3-pre.fdc2e0b

package/README.md

@@ -24,10 +24,11 @@ The server will automatically connect to your current kubectl context. Make sure
 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 asking Claude to list your pods or create a test deployment.
 
-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.
+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.
 
 ## Features
 
@@ -40,10 +41,16 @@ If you have errors, open up a standard terminal and run `kubectl get pods` to se
 - [x] Delete a pod
 - [x] Describe a pod
 - [x] List all namespaces
-- [x] Get logs from a pod for debugging (supports pods, deployments, jobs, and label selectors)
+- [x] Get logs from a pod for debugging (supports pods deployments jobs and label selectors)
+- [x] Support Helm v3 for installing charts
+  - Install charts with custom values
+  - Uninstall releases
+  - Upgrade existing releases
+  - Support for namespaces
+  - Support for version specification
+  - Support for custom repositories
 - [ ] Port forward to a pod
 - [ ] Choose namespace for next commands (memory)
-- [ ] Support Helm for installing charts
 
 ## Local Development
 
@@ -83,10 +90,31 @@ npx @modelcontextprotocol/inspector node build/index.js
 ### Project Structure
 
 ```
-src/
-├── index.ts     # Main server implementation
-├── types.ts     # TypeScript type definitions
-└── unit.test.ts # Unit tests
+├── src/
+│   ├── index.ts              # Main server implementation
+│   ├── types.ts              # Type re-exports
+│   ├── config/              # Configuration files
+│   │   ├── container-templates.ts  # Container configurations
+│   │   ├── server-config.ts       # Server settings
+│   │   ├── deployment-config.ts    # Deployment schemas
+│   │   └── ...
+│   ├── models/              # Data models and schemas
+│   │   ├── response-schemas.ts    # API response schemas
+│   │   ├── resource-models.ts     # Resource models
+│   │   └── tool-models.ts         # Tool schemas
+│   ├── utils/               # Utility classes
+│   │   └── kubernetes-manager.ts  # K8s management
+│   ├── resources/           # Resource handlers
+│   │   └── handlers.ts      # Resource implementation
+│   └── tools/              # Tool implementations
+│       ├── list_pods.ts
+│       ├── list_services.ts
+│       ├── list_deployments.ts
+│       └── ...
+├── tests/                  # Test files
+│   └── unit.test.ts        # Unit tests
+│   └── helm.test.ts        # Helm tests
+└── ...
 ```
 
 ### Contributing
@@ -98,7 +126,7 @@ src/
 5. Ensure all tests pass
 6. Submit a pull request
 
-For bigger changes, please open an issue first to discuss the proposed changes.
+For bigger changes please open an issue first to discuss the proposed changes.
 
 ## Architecture
 

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

@@ -0,0 +1,8 @@
+export declare const cleanupSchema: {
+    readonly name: "cleanup";
+    readonly description: "Cleanup all managed resources";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+};

package/dist/config/cleanup-config.js

@@ -0,0 +1,8 @@
+export const cleanupSchema = {
+    name: "cleanup",
+    description: "Cleanup all managed resources",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};

package/dist/config/container-templates.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import * as k8s from "@kubernetes/client-node";
+export declare const ContainerTemplate: z.ZodEnum<["ubuntu", "nginx", "busybox", "alpine"]>;
+export type ContainerTemplateName = z.infer<typeof ContainerTemplate>;
+export declare const containerTemplates: Record<string, k8s.V1Container>;

package/dist/config/container-templates.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+// Container template types
+export const ContainerTemplate = z.enum([
+    "ubuntu",
+    "nginx",
+    "busybox",
+    "alpine",
+]);
+// Container template configurations with resource limits and settings
+export const containerTemplates = {
+    ubuntu: {
+        name: "main",
+        image: "ubuntu:latest",
+        command: ["/bin/bash"],
+        args: ["-c", "sleep infinity"],
+        resources: {
+            limits: {
+                cpu: "200m",
+                memory: "256Mi",
+            },
+            requests: {
+                cpu: "100m",
+                memory: "128Mi",
+            },
+        },
+        livenessProbe: {
+            exec: {
+                command: ["cat", "/proc/1/status"],
+            },
+            initialDelaySeconds: 5,
+            periodSeconds: 10,
+        },
+    },
+    nginx: {
+        name: "main",
+        image: "nginx:latest",
+        ports: [{ containerPort: 80 }],
+        resources: {
+            limits: {
+                cpu: "200m",
+                memory: "256Mi",
+            },
+            requests: {
+                cpu: "100m",
+                memory: "128Mi",
+            },
+        },
+        livenessProbe: {
+            httpGet: {
+                path: "/",
+                port: 80,
+            },
+            initialDelaySeconds: 5,
+            periodSeconds: 10,
+        },
+        readinessProbe: {
+            httpGet: {
+                path: "/",
+                port: 80,
+            },
+            initialDelaySeconds: 2,
+            periodSeconds: 5,
+        },
+    },
+    busybox: {
+        name: "main",
+        image: "busybox:latest",
+        command: ["sh"],
+        args: ["-c", "sleep infinity"],
+        resources: {
+            limits: {
+                cpu: "100m",
+                memory: "64Mi",
+            },
+            requests: {
+                cpu: "50m",
+                memory: "32Mi",
+            },
+        },
+        livenessProbe: {
+            exec: {
+                command: ["true"],
+            },
+            periodSeconds: 10,
+        },
+    },
+    alpine: {
+        name: "main",
+        image: "alpine:latest",
+        command: ["sh"],
+        args: ["-c", "sleep infinity"],
+        resources: {
+            limits: {
+                cpu: "100m",
+                memory: "64Mi",
+            },
+            requests: {
+                cpu: "50m",
+                memory: "32Mi",
+            },
+        },
+        livenessProbe: {
+            exec: {
+                command: ["true"],
+            },
+            periodSeconds: 10,
+        },
+    },
+};

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

@@ -0,0 +1,31 @@
+export declare const createDeploymentSchema: {
+    readonly name: "create_deployment";
+    readonly description: "Create a new Kubernetes deployment";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly namespace: {
+                readonly type: "string";
+            };
+            readonly template: {
+                readonly type: "string";
+                readonly enum: ["ubuntu", "nginx", "busybox", "alpine"];
+            };
+            readonly replicas: {
+                readonly type: "number";
+                readonly default: 1;
+            };
+            readonly ports: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                };
+                readonly optional: true;
+            };
+        };
+        readonly required: readonly ["name", "namespace", "template"];
+    };
+};

package/dist/config/deployment-config.js

@@ -0,0 +1,23 @@
+import { ContainerTemplate } from "./container-templates.js";
+export const createDeploymentSchema = {
+    name: "create_deployment",
+    description: "Create a new Kubernetes deployment",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string" },
+            namespace: { type: "string" },
+            template: {
+                type: "string",
+                enum: ContainerTemplate.options,
+            },
+            replicas: { type: "number", default: 1 },
+            ports: {
+                type: "array",
+                items: { type: "number" },
+                optional: true,
+            },
+        },
+        required: ["name", "namespace", "template"],
+    },
+};

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

@@ -0,0 +1,8 @@
+export declare const listNamespacesSchema: {
+    readonly name: "list_namespaces";
+    readonly description: "List all namespaces";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+};

package/dist/config/namespace-config.js

@@ -0,0 +1,8 @@
+export const listNamespacesSchema = {
+    name: "list_namespaces",
+    description: "List all namespaces",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};

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

@@ -0,0 +1,8 @@
+export declare const serverConfig: {
+    readonly name: "kubernetes";
+    readonly version: "0.1.0";
+    readonly capabilities: {
+        readonly resources: {};
+        readonly tools: {};
+    };
+};

package/dist/config/server-config.js

@@ -0,0 +1,8 @@
+export const serverConfig = {
+    name: "kubernetes",
+    version: "0.1.0",
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+};