@prodisco/k8s-mcp 0.1.2 → 0.1.4

package/dist/tools/api/apiTools.js

@@ -0,0 +1,132 @@
+/**
+ * Universal API Tools for openapi-fetch clients
+ */
+import { z } from 'zod';
+import { getApiClientConfig, getPaths } from '../../util/apiClient.js';
+export function registerApiTools(server) {
+    const config = getApiClientConfig();
+    if (!config) {
+        server.tool('api_setup', 'How to set up an API client', {}, async () => ({
+            content: [{
+                    type: 'text',
+                    text: `# API Client Setup
+
+1. Generate a client:
+\`\`\`bash
+./scripts/generate-openapi-client.sh --url <openapi-spec-url> --name <name>
+\`\`\`
+
+2. Set env var:
+\`\`\`bash
+export PRODISCO_API_CLIENT="~/.prodisco/generated/<name>-client"
+export <NAME>_TOKEN="your-token"
+\`\`\`
+
+3. Restart the MCP server
+`,
+                }],
+        }));
+        return;
+    }
+    // api_info
+    server.tool('api_info', `Show info about the configured API client (${config.name})`, {}, async () => ({
+        content: [{
+                type: 'text',
+                text: `# API Client: ${config.name}
+
+**Path:** ${config.clientPath}
+**Base URL:** ${config.metadata.baseUrl || '(not set)'}
+**Auth Env Var:** ${config.metadata.envVar || `${config.name.toUpperCase()}_TOKEN`}
+`,
+            }],
+    }));
+    // api_discover
+    server.tool('api_discover', `Discover available API paths for ${config.name}. Use filter to narrow results.`, {
+        filter: z.string().optional().describe('Filter paths (case-insensitive)'),
+        limit: z.number().optional().default(50).describe('Max results'),
+    }, async ({ filter, limit }) => {
+        const paths = getPaths();
+        const filtered = paths
+            .filter((p) => !filter || p.path.toLowerCase().includes(filter.toLowerCase()))
+            .slice(0, limit || 50);
+        if (filtered.length === 0) {
+            return { content: [{ type: 'text', text: `No paths found${filter ? ` matching "${filter}"` : ''}.` }] };
+        }
+        const formatted = filtered.map((p) => `- **${p.methods.join(', ').toUpperCase()}** \`${p.path}\``).join('\n');
+        return {
+            content: [{
+                    type: 'text',
+                    text: `# API Paths${filter ? ` (matching "${filter}")` : ''}
+
+${formatted}
+
+Use \`api_call\` to call an endpoint:
+\`\`\`
+method: "GET"
+path: "/repos/{owner}/{repo}"
+params: { "path": { "owner": "kubernetes", "repo": "kubernetes" } }
+\`\`\`
+`,
+                }],
+        };
+    });
+    // api_call
+    server.tool('api_call', `Call an API endpoint on ${config.name}`, {
+        method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).describe('HTTP method'),
+        path: z.string().describe('API path (e.g., "/repos/{owner}/{repo}")'),
+        params: z.record(z.any()).optional().describe('{ path: {...}, query: {...}, body: {...} }'),
+    }, async ({ method, path, params }) => {
+        try {
+            const clientPath = `file://${config.distPath}/index.js`;
+            const { client } = await import(clientPath);
+            const fn = client[method];
+            if (typeof fn !== 'function') {
+                return { content: [{ type: 'text', text: `Method ${method} not supported.` }] };
+            }
+            const { data, error, response } = await fn(path, params || {});
+            if (error) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `# Error: ${method} ${path}
+
+**Status:** ${response?.status || 'unknown'}
+\`\`\`json
+${JSON.stringify(error, null, 2)}
+\`\`\`
+`,
+                        }],
+                };
+            }
+            let resultText = JSON.stringify(data, null, 2);
+            if (resultText.length > 50000) {
+                resultText = resultText.substring(0, 50000) + '\n... (truncated)';
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# ${method} ${path}
+
+\`\`\`json
+${resultText}
+\`\`\`
+`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `# Error: ${method} ${path}
+
+${err.message}
+
+**Hint:** Make sure ${config.metadata.envVar || `${config.name.toUpperCase()}_TOKEN`} is set.
+`,
+                    }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=apiTools.js.map

package/dist/tools/api/apiTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiTools.js","sourceRoot":"","sources":["../../../src/tools/api/apiTools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IAEpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,6BAA6B,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;CAcb;iBACM,CAAC;SACH,CAAC,CAAC,CAAC;QACJ,OAAO;IACT,CAAC;IAED,WAAW;IACX,MAAM,CAAC,IAAI,CACT,UAAU,EACV,8CAA8C,MAAM,CAAC,IAAI,GAAG,EAC5D,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,iBAAiB,MAAM,CAAC,IAAI;;YAE9B,MAAM,CAAC,UAAU;gBACb,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,WAAW;oBAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ;CACjF;aACM,CAAC;KACH,CAAC,CACH,CAAC;IAEF,eAAe;IACf,MAAM,CAAC,IAAI,CACT,cAAc,EACd,oCAAoC,MAAM,CAAC,IAAI,iCAAiC,EAChF;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;KACjE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;aAC7E,KAAK,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAEzB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,MAAM,CAAC,CAAC,CAAC,cAAc,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QAC1G,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9G,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE;;EAEnE,SAAS;;;;;;;;CAQV;iBACQ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,WAAW;IACX,MAAM,CAAC,IAAI,CACT,UAAU,EACV,2BAA2B,MAAM,CAAC,IAAI,EAAE,EACxC;QACE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACjF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KAC5F,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,UAAU,MAAM,CAAC,QAAQ,WAAW,CAAC;YACxD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YAE5C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM,iBAAiB,EAAE,CAAC,EAAE,CAAC;YAClF,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;YAE/D,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,YAAY,MAAM,IAAI,IAAI;;cAEhC,QAAQ,EAAE,MAAM,IAAI,SAAS;;EAEzC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;;CAE/B;yBACY,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,IAAI,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/C,IAAI,UAAU,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBAC9B,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,mBAAmB,CAAC;YACpE,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,KAAK,MAAM,IAAI,IAAI;;;EAGnC,UAAU;;CAEX;qBACU,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY,MAAM,IAAI,IAAI;;EAE1C,GAAG,CAAC,OAAO;;sBAES,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ;CACnF;qBACU,CAAC;aACH,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/kubernetes/metadata.d.ts

@@ -1,11 +1,12 @@
 /**
  * Kubernetes tool metadata
  *
- * Exports searchTools for discovering API methods and getTypeDefinition
- * for getting TypeScript type definitions.
+ * Exports searchTools which provides both API method discovery (mode: 'methods')
+ * and TypeScript type definitions (mode: 'types').
  */
-export declare const kubernetesToolMetadata: ({
+export declare const kubernetesToolMetadata: {
     tool: import("../types.js").ToolDefinition<{
+        mode: "methods";
         summary: string;
         tools: {
             apiClass: string;
@@ -50,8 +51,149 @@ export declare const kubernetesToolMetadata: ({
             scriptsDirectory: string;
         };
         cachedScripts: string[];
+        relevantScripts: {
+            filename: string;
+            filePath: string;
+            description: string;
+            apiClasses: string[];
+        }[];
+        facets?: {
+            apiClass: Record<string, number>;
+            action: Record<string, number>;
+            scope: Record<string, number>;
+        };
+        searchTime?: number;
+        pagination: {
+            offset: number;
+            limit: number;
+            hasMore: boolean;
+        };
+    } | {
+        mode: "types";
+        summary: string;
+        types: Record<string, {
+            name: string;
+            definition: string;
+            file: string;
+            nestedTypes: string[];
+        }>;
+    } | {
+        mode: "scripts";
+        summary: string;
+        scripts: {
+            filename: string;
+            filePath: string;
+            description: string;
+            apiClasses: string[];
+        }[];
+        totalMatches: number;
+        paths: {
+            scriptsDirectory: string;
+        };
+        pagination: {
+            offset: number;
+            limit: number;
+            hasMore: boolean;
+        };
+    } | {
+        mode: "prometheus";
+        summary: string;
+        methods: {
+            library: "prometheus-query";
+            className?: string;
+            methodName: string;
+            category: "query" | "metadata" | "alerts";
+            description: string;
+            parameters: Array<{
+                name: string;
+                type: string;
+                optional: boolean;
+                description?: string;
+            }>;
+            returnType: string;
+            example: string;
+        }[];
+        totalMatches: number;
+        libraries: {
+            "prometheus-query": {
+                installed: boolean;
+                version: string;
+            };
+        };
+        usage: string;
+        paths: {
+            scriptsDirectory: string;
+        };
+        facets: {
+            library: Record<string, number>;
+            category: Record<string, number>;
+        };
+        pagination: {
+            offset: number;
+            limit: number;
+            hasMore: boolean;
+        };
+    } | {
+        mode: "prometheus";
+        error: string;
+        message: string;
+        example: string;
+        methods: {
+            library: "prometheus-query";
+            className?: string;
+            methodName: string;
+            category: "query" | "metadata" | "alerts";
+            description: string;
+            parameters: Array<{
+                name: string;
+                type: string;
+                optional: boolean;
+                description?: string;
+            }>;
+            returnType: string;
+            example: string;
+        }[];
+        totalMatches: number;
+        libraries: {
+            "prometheus-query": {
+                installed: boolean;
+                version: string;
+            };
+        };
+        paths: {
+            scriptsDirectory: string;
+        };
+        facets: {
+            library: Record<string, number>;
+            category: Record<string, number>;
+        };
+        pagination: {
+            offset: number;
+            limit: number;
+            hasMore: boolean;
+        };
+    } | {
+        mode: "prometheus";
+        category: "metrics";
+        summary: string;
+        metrics: Array<{
+            name: string;
+            type: string;
+            description: string;
+        }>;
+        totalMatches: number;
+        indexingStatus: "ready" | "in_progress" | "unavailable";
+        paths: {
+            scriptsDirectory: string;
+        };
+        pagination: {
+            offset: number;
+            limit: number;
+            hasMore: boolean;
+        };
     }, import("zod").ZodObject<{
-        resourceType: import("zod").ZodString;
+        mode: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodEnum<["methods", "types", "scripts", "prometheus"]>>>;
+        resourceType: import("zod").ZodOptional<import("zod").ZodString>;
         action: import("zod").ZodOptional<import("zod").ZodString>;
         scope: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<["namespaced", "cluster", "all"]>>>;
         exclude: import("zod").ZodOptional<import("zod").ZodObject<{
@@ -64,46 +206,46 @@ export declare const kubernetesToolMetadata: ({
             actions?: string[] | undefined;
             apiClasses?: string[] | undefined;
         }>>;
+        types: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        depth: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodNumber>>;
+        searchTerm: import("zod").ZodOptional<import("zod").ZodString>;
+        category: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<["query", "metadata", "alerts", "metrics", "all"]>>>;
+        methodPattern: import("zod").ZodOptional<import("zod").ZodString>;
         limit: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodNumber>>;
+        offset: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodNumber>>;
     }, "strip", import("zod").ZodTypeAny, {
-        resourceType: string;
         scope: "namespaced" | "cluster" | "all";
+        category: "all" | "query" | "metadata" | "alerts" | "metrics";
+        types?: string[] | undefined;
+        mode?: "methods" | "types" | "scripts" | "prometheus" | undefined;
+        resourceType?: string | undefined;
         action?: string | undefined;
         exclude?: {
             actions?: string[] | undefined;
             apiClasses?: string[] | undefined;
         } | undefined;
+        depth?: number | undefined;
+        searchTerm?: string | undefined;
+        methodPattern?: string | undefined;
         limit?: number | undefined;
+        offset?: number | undefined;
     }, {
-        resourceType: string;
+        types?: string[] | undefined;
+        mode?: "methods" | "types" | "scripts" | "prometheus" | undefined;
+        resourceType?: string | undefined;
         action?: string | undefined;
         scope?: "namespaced" | "cluster" | "all" | undefined;
         exclude?: {
             actions?: string[] | undefined;
             apiClasses?: string[] | undefined;
         } | undefined;
-        limit?: number | undefined;
-    }>>;
-    sourceModulePath: string;
-} | {
-    tool: import("../types.js").ToolDefinition<{
-        summary: string;
-        types: Record<string, {
-            name: string;
-            definition: string;
-            file: string;
-            nestedTypes: string[];
-        }>;
-    }, import("zod").ZodObject<{
-        types: import("zod").ZodArray<import("zod").ZodString, "many">;
-        depth: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodNumber>>;
-    }, "strip", import("zod").ZodTypeAny, {
-        types: string[];
-        depth?: number | undefined;
-    }, {
-        types: string[];
         depth?: number | undefined;
+        searchTerm?: string | undefined;
+        category?: "all" | "query" | "metadata" | "alerts" | "metrics" | undefined;
+        methodPattern?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
     }>>;
     sourceModulePath: string;
-})[];
+}[];
 //# sourceMappingURL=metadata.d.ts.map

package/dist/tools/kubernetes/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/kubernetes/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;2BAUkzC,CAAC;;;;;;;;;+BAAmP,CAAC;4BAAkB,CAAC;;;;;;;;;;;;;;qBAAuR,CAAC;sBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IADz4D,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/kubernetes/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;2BAM06H,CAAC;;;;;;;;;+BAAmP,CAAC;4BAAkB,CAAC;;;;;;;;;;;;;;qBAAuR,CAAC;sBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAswD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAAD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GADxwM,CAAC"}

package/dist/tools/kubernetes/metadata.js

@@ -1,19 +1,14 @@
 /**
  * Kubernetes tool metadata
  *
- * Exports searchTools for discovering API methods and getTypeDefinition
- * for getting TypeScript type definitions.
+ * Exports searchTools which provides both API method discovery (mode: 'methods')
+ * and TypeScript type definitions (mode: 'types').
  */
 import { searchToolsTool } from './searchTools.js';
-import { getTypeDefinitionTool } from './typeDefinitions.js';
 export const kubernetesToolMetadata = [
     {
         tool: searchToolsTool,
         sourceModulePath: './searchTools.ts',
     },
-    {
-        tool: getTypeDefinitionTool,
-        sourceModulePath: './typeDefinitions.ts',
-    },
 ];
 //# sourceMappingURL=metadata.js.map

package/dist/tools/kubernetes/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/tools/kubernetes/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;QACE,IAAI,EAAE,eAAe;QACrB,gBAAgB,EAAE,kBAAkB;KACrC;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,gBAAgB,EAAE,sBAAsB;KACzC;CACF,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/tools/kubernetes/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;QACE,IAAI,EAAE,eAAe;QACrB,gBAAgB,EAAE,kBAAkB;KACrC;CACF,CAAC"}