@zerry_jin/k8s-doctor-mcp 1.0.0

package/dist/utils/k8s-client.js

@@ -0,0 +1,74 @@
+/**
+ * Kubernetes client initialization
+ *
+ * @author zerry
+ */
+import * as k8s from '@kubernetes/client-node';
+/**
+ * Load K8s configuration
+ *
+ * Automatically finds and loads kubeconfig.
+ * Works in-cluster as well
+ */
+export function loadK8sConfig() {
+    // Try local kubeconfig first (most common case)
+    try {
+        const kc = new k8s.KubeConfig();
+        kc.loadFromDefault();
+        return kc;
+    }
+    catch (localError) {
+        // If local fails, try in-cluster config (when running inside pod)
+        try {
+            const kc = new k8s.KubeConfig();
+            kc.loadFromCluster();
+            return kc;
+        }
+        catch (clusterError) {
+            throw new Error('Cannot find kubeconfig. Please verify kubectl is configured.\n' +
+                'Hint: Check connection with "kubectl cluster-info"');
+        }
+    }
+}
+/**
+ * Create K8s API clients
+ *
+ * Creates frequently used API clients at once
+ */
+export function createK8sClients(kc) {
+    return {
+        core: kc.makeApiClient(k8s.CoreV1Api),
+        apps: kc.makeApiClient(k8s.AppsV1Api),
+        batch: kc.makeApiClient(k8s.BatchV1Api),
+        networking: kc.makeApiClient(k8s.NetworkingV1Api),
+        storage: kc.makeApiClient(k8s.StorageV1Api),
+        log: new k8s.Log(kc),
+        metrics: new k8s.Metrics(kc),
+    };
+}
+/**
+ * Validate namespace
+ *
+ * Check if namespace actually exists
+ */
+export async function validateNamespace(coreApi, namespace) {
+    try {
+        await coreApi.readNamespace({ name: namespace });
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}
+/**
+ * Check if pod exists
+ */
+export async function podExists(coreApi, namespace, podName) {
+    try {
+        await coreApi.readNamespacedPod({ name: podName, namespace });
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+}

package/dist/utils/retry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Retry utilities with exponential backoff
+ *
+ * @author zerry
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts */
+    maxAttempts?: number;
+    /** Initial delay in milliseconds */
+    initialDelay?: number;
+    /** Maximum delay in milliseconds */
+    maxDelay?: number;
+    /** Backoff multiplier */
+    backoffMultiplier?: number;
+    /** Should retry on this error? */
+    shouldRetry?: (error: any) => boolean;
+}
+/**
+ * Execute function with retry logic and exponential backoff
+ *
+ * @param fn Function to execute
+ * @param options Retry options
+ * @returns Result of the function
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;

package/dist/utils/retry.js

@@ -0,0 +1,70 @@
+/**
+ * Retry utilities with exponential backoff
+ *
+ * @author zerry
+ */
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    initialDelay: 1000,
+    maxDelay: 10000,
+    backoffMultiplier: 2,
+    shouldRetry: (error) => {
+        // Retry on network errors, timeouts, and 5xx errors
+        if (error.code === 'ECONNREFUSED')
+            return true;
+        if (error.code === 'ETIMEDOUT')
+            return true;
+        if (error.code === 'ENOTFOUND')
+            return true;
+        if (error.statusCode && error.statusCode >= 500)
+            return true;
+        // Don't retry on client errors (4xx)
+        if (error.statusCode && error.statusCode >= 400 && error.statusCode < 500)
+            return false;
+        // Retry on unknown errors
+        return true;
+    },
+};
+/**
+ * Execute function with retry logic and exponential backoff
+ *
+ * @param fn Function to execute
+ * @param options Retry options
+ * @returns Result of the function
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    let delay = opts.initialDelay;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry if it's the last attempt
+            if (attempt === opts.maxAttempts) {
+                break;
+            }
+            // Don't retry if error is not retryable
+            if (!opts.shouldRetry(error)) {
+                console.error(`[Retry] Non-retryable error on attempt ${attempt}:`, error.message);
+                throw error;
+            }
+            console.error(`[Retry] Attempt ${attempt}/${opts.maxAttempts} failed: ${error.message}. ` +
+                `Retrying in ${delay}ms...`);
+            // Wait before retrying
+            await sleep(delay);
+            // Calculate next delay with exponential backoff
+            delay = Math.min(delay * opts.backoffMultiplier, opts.maxDelay);
+        }
+    }
+    console.error(`[Retry] All ${opts.maxAttempts} attempts failed`);
+    throw lastError;
+}
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@zerry_jin/k8s-doctor-mcp",
+    "version": "1.0.0",
+    "description": "AI-powered Kubernetes cluster diagnostics MCP server - analyzes pod failures, logs, resource usage, and provides intelligent debugging recommendations",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "bin": {
+        "k8s-doctor-mcp": "dist/index.js"
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "dev": "tsx src/index.ts",
+        "demo": "tsx examples/demo.ts",
+        "prepublishOnly": "npm run build",
+        "test": "node --test"
+    },
+    "keywords": [
+        "mcp",
+        "model-context-protocol",
+        "kubernetes",
+        "k8s",
+        "debugging",
+        "diagnostics",
+        "devops",
+        "kubectl",
+        "pod",
+        "crashloop",
+        "logs",
+        "cluster",
+        "monitoring",
+        "claude",
+        "anthropic",
+        "ai"
+    ],
+    "author": "zerry",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ongjin/k8s-doctor-mcp.git"
+    },
+    "bugs": {
+        "url": "https://github.com/ongjin/k8s-doctor-mcp/issues"
+    },
+    "homepage": "https://github.com/ongjin/k8s-doctor-mcp#readme",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "@kubernetes/client-node": "^1.0.0",
+        "zod": "^3.23.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "tsx": "^4.0.0",
+        "typescript": "^5.0.0"
+    }
+}