@confluentinc/mcp-confluent 1.0.1

package/dist/lazy.js

@@ -0,0 +1,106 @@
+/**
+ * A class that implements lazy loading for synchronous values.
+ * It defers the initialization of a value until it's first requested.
+ * @template T The type of value to be lazily loaded
+ */
+export class Lazy {
+    /** The cached instance of the lazily loaded value */
+    instance;
+    /** A function that produces the value to be lazily loaded */
+    supplier;
+    /** Optional handler to clean up the instance when closed */
+    closeHandler;
+    /**
+     * Creates a new Lazy instance
+     * @param supplier A function that creates the lazy-loaded value
+     * @param closeHandler Optional function to clean up the instance when closed
+     */
+    constructor(supplier, closeHandler) {
+        this.supplier = supplier;
+        this.closeHandler = closeHandler;
+    }
+    /**
+     * Retrieves the lazy-loaded value, initializing it if necessary
+     * @returns The lazy-loaded value
+     * @throws If the supplier function fails to initialize the value
+     */
+    get() {
+        try {
+            this.instance = this.supplier();
+            console.error(`Lazy instance created with type ${this.instance?.constructor.name || typeof this.instance}`);
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize lazy instance: ${error}`);
+        }
+        return this.instance;
+    }
+    /**
+     * Closes and cleans up the lazy-loaded instance if it exists.
+     * If a closeHandler was provided, it will be called with the instance.
+     * The instance is set to undefined after cleanup.
+     */
+    close() {
+        if (this.instance) {
+            if (this.closeHandler) {
+                console.error(`Initiating close handler for lazy instance of type ${typeof this.instance}`);
+                this.closeHandler(this.instance);
+                console.error(`Lazy instance closed with type ${typeof this.instance}`);
+            }
+            this.instance = undefined;
+        }
+    }
+}
+/**
+ * A class that implements lazy loading for asynchronous values.
+ * It defers the initialization of a value until it's first requested.
+ * @template T The type of value to be lazily loaded
+ */
+export class AsyncLazy {
+    /** The cached instance of the lazily loaded value */
+    instance;
+    /** A function that produces the value to be lazily loaded */
+    supplier;
+    /** Optional handler to clean up the instance when closed */
+    closeHandler;
+    /** Tracks the ongoing initialization promise to prevent multiple simultaneous initializations */
+    initializationPromise = null;
+    /**
+     * Creates a new AsyncLazy instance
+     * @param supplier An async function that creates the lazy-loaded value
+     * @param closeHandler Optional async function to clean up the instance when closed
+     */
+    constructor(supplier, closeHandler) {
+        this.supplier = supplier;
+        this.closeHandler = closeHandler;
+    }
+    /**
+     * Retrieves the lazy-loaded value, initializing it if necessary
+     * @returns A promise that resolves to the lazy-loaded value
+     * @throws If the supplier function fails to initialize the value
+     */
+    async get() {
+        if (!this.instance) {
+            if (!this.initializationPromise) {
+                this.initializationPromise = this.supplier();
+            }
+            this.instance = await this.initializationPromise;
+        }
+        console.error(`Async Lazy instance created with type ${this.instance?.constructor.name || typeof this.instance}`);
+        return this.instance;
+    }
+    /**
+     * Closes and cleans up the lazy-loaded instance if it exists
+     * If a closeHandler was provided, it will be called with the instance
+     * @returns A promise that resolves when the cleanup is complete
+     */
+    async close() {
+        if (this.instance) {
+            if (this.closeHandler) {
+                console.error(`Initiating close handler for lazy instance of type ${typeof this.instance}`);
+                await this.closeHandler(this.instance);
+                console.error(`Lazy instance closed with type ${typeof this.instance}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,IAAI;IACf,qDAAqD;IAC7C,QAAQ,CAAgB;IAEhC,6DAA6D;IAC5C,QAAQ,CAAU;IAEnC,4DAA4D;IAC3C,YAAY,CAAyB;IAEtD;;;;OAIG;IACH,YAAY,QAAiB,EAAE,YAAoC;QACjE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,GAAG;QACD,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CACX,mCAAmC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7F,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC,QAAS,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CACX,sDAAsD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7E,CAAC;gBACF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjC,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB,qDAAqD;IAC7C,QAAQ,CAAgB;IAEhC,6DAA6D;IAC5C,QAAQ,CAAmB;IAE5C,4DAA4D;IAC3C,YAAY,CAAkC;IAE/D,iGAAiG;IACzF,qBAAqB,GAAsB,IAAI,CAAC;IAExD;;;;OAIG;IACH,YACE,QAA0B,EAC1B,YAA6C;QAE7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;gBAChC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,KAAK,CACX,yCAAyC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE,CACnG,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,CAAC,KAAK,CACX,sDAAsD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAC7E,CAAC;gBACF,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvC,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/print-md-schema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=print-md-schema.d.ts.map

package/dist/print-md-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-md-schema.d.ts","sourceRoot":"","sources":["../src/print-md-schema.ts"],"names":[],"mappings":""}

package/dist/print-md-schema.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+import { combinedSchema } from "./env-schema.js";
+function zodSchemaToMarkdown(schema, parentKey = "") {
+    // Initialize table header
+    if (!parentKey) {
+        return ("| Variable | Description | Default Value | Required |\n" +
+            "|----------|-------------|---------------|----------|\n" +
+            extractRows(schema));
+    }
+    return extractRows(schema);
+}
+function extractRows(schema, parentKey = "") {
+    // Handle objects (nested properties)
+    if (schema instanceof z.ZodObject) {
+        return Object.entries(schema.shape)
+            .map(([key, subSchema]) => {
+            const fullKey = parentKey ? `${parentKey}.${key}` : key;
+            const isRequired = !(subSchema instanceof z.ZodOptional);
+            return {
+                key: fullKey,
+                schema: subSchema instanceof z.ZodObject
+                    ? subSchema
+                    : subSchema,
+                isRequired,
+            };
+        })
+            .sort((a, b) => {
+            // Sort by required status first (required comes first)
+            if (a.isRequired !== b.isRequired) {
+                return a.isRequired ? -1 : 1;
+            }
+            // Then sort alphabetically
+            return a.key.localeCompare(b.key);
+        })
+            .map(({ key, schema }) => {
+            if (schema instanceof z.ZodObject) {
+                return extractRows(schema, key);
+            }
+            return formatTableRow(key, schema);
+        })
+            .join("");
+    }
+    // Handle non-object schemas
+    return formatTableRow(parentKey, schema);
+}
+function formatTableRow(key, schema) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let description = schema.description || "";
+    let defaultValue = "";
+    const isRequired = !(schema instanceof z.ZodOptional);
+    // Extract default value if exists
+    if (schema instanceof z.ZodDefault) {
+        defaultValue = JSON.stringify(schema._def.defaultValue());
+        schema = schema.removeDefault();
+    }
+    // Add type information to description if not empty
+    const typeInfo = getTypeInfo(schema);
+    description = description ? `${description} (${typeInfo})` : typeInfo;
+    // Format the table row
+    return `| ${key} | ${description} | ${defaultValue} | ${isRequired ? "Yes" : "No"} |\n`;
+}
+function getTypeInfo(schema) {
+    if (schema instanceof z.ZodString) {
+        const constraints = [
+            schema.minLength !== null && `min: ${schema.minLength}`,
+            schema.maxLength !== null && `max: ${schema.maxLength}`,
+        ]
+            .filter(Boolean)
+            .join(", ");
+        return `string${constraints ? ` (${constraints})` : ""}`;
+    }
+    if (schema instanceof z.ZodNumber) {
+        const constraints = [
+            schema.minValue !== null && `min: ${schema.minValue}`,
+            schema.maxValue !== null && `max: ${schema.maxValue}`,
+        ]
+            .filter(Boolean)
+            .join(", ");
+        return `number${constraints ? ` (${constraints})` : ""}`;
+    }
+    if (schema instanceof z.ZodBoolean)
+        return "boolean";
+    if (schema instanceof z.ZodEnum)
+        return `enum: ${schema.options.join(" | ")}`;
+    if (schema instanceof z.ZodArray)
+        return `array of ${getTypeInfo(schema.element)}`;
+    if (schema instanceof z.ZodOptional)
+        return `${getTypeInfo(schema.unwrap())}`;
+    if (schema instanceof z.ZodNullable)
+        return `nullable ${getTypeInfo(schema.unwrap())}`;
+    if (schema instanceof z.ZodUnion)
+        return `union: ${schema.options.map((opt) => getTypeInfo(opt)).join(" | ")}`;
+    return schema.constructor.name.replace("Zod", "").toLowerCase();
+}
+console.log(zodSchemaToMarkdown(combinedSchema));
+//# sourceMappingURL=print-md-schema.js.map

package/dist/print-md-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-md-schema.js","sourceRoot":"","sources":["../src/print-md-schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@confluentinc/mcp-confluent",
+  "description": "Confluent MCP Server",
+  "version": "1.0.1",
+  "author": "Confluent Inc.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/confluentinc/mcp-confluent.git"
+  },
+  "bin": {
+    "mcp-confluent": "dist/index.js"
+  },
+  "type": "module",
+  "keywords": [
+    "confluent",
+    "mcp",
+    "kafka",
+    "flink",
+    "modelcontextprotocol"
+  ],
+  "bugs": {
+    "url": "https://github.com/confluentinc/mcp-confluent/issues"
+  },
+  "homepage": "https://www.confluent.io/blog/ai-agents-using-anthropic-mcp/",
+  "scripts": {
+    "dev": "concurrently \"tsc --watch\" \"tsc-alias --watch\"",
+    "test:ts": "tsc --noEmit",
+    "start": "node dist/index.js --env-file .env",
+    "lint": "eslint .",
+    "format": "prettier --write \"**/*.+(js|ts|json)\"",
+    "build": "tsc && tsc-alias",
+    "print:schema": "node dist/print-md-schema.js",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.23.0",
+    "@types/content-type": "^1.1.8",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^22.14.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "concurrently": "^9.1.2",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.6",
+    "globals": "^16.0.0",
+    "husky": "^9.1.7",
+    "openapi-typescript": "^7.6.1",
+    "prettier": "3.5.3",
+    "tsc-alias": "^1.8.13",
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.29.0"
+  },
+  "dependencies": {
+    "@commander-js/extra-typings": "^13.1.0",
+    "@confluentinc/kafka-javascript": "^1.2.0",
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "commander": "^13.1.0",
+    "dotenv": "^16.4.7",
+    "openapi-fetch": "^0.13.5",
+    "zod": "^3.24.2"
+  },
+  "files": [
+    "dist"
+  ]
+}