@kubb/mcp 4.15.2 → 4.17.0

package/README.md

@@ -0,0 +1,157 @@
+# @kubb/mcp
+
+Model Context Protocol (MCP) server for Kubb.
+
+## Overview
+
+This package provides an MCP server that exposes Kubb's code generation functionality through the [Model Context Protocol](https://modelcontextprotocol.io), allowing AI assistants like [Claude](https://claude.ai), [Cursor](https://cursor.sh), and other MCP-compatible clients to generate code from OpenAPI specifications using natural language.
+
+The server acts as a bridge between MCP clients (like [Claude Desktop](https://claude.ai/download)) and Kubb's build system, enabling conversational code generation workflows.
+
+## Features
+
+- **Generate Tool**: Generate TypeScript types, API clients, and more from OpenAPI specs using your `kubb.config.ts`
+- **Real-time Progress Notifications**: Stream build events and progress updates to the MCP client
+- Uses `@kubb/core` build functionality directly
+- Lightweight and focused on code generation
+
+## Installation
+
+Install as a dev dependency:
+
+```bash [npm]
+npm install --save-dev @kubb/mcp
+```
+
+> [!IMPORTANT]
+> You also need to install `@kubb/cli` to use the `kubb mcp` command.
+
+## Usage
+
+### Start the MCP Server
+
+Start the server using the Kubb CLI:
+
+```bash
+npx kubb mcp
+```
+
+Or run it directly as a standalone package:
+
+```bash
+npx @kubb/mcp
+```
+
+This starts an MCP server that communicates via stdio (standard input/output), making it compatible with MCP clients.
+
+### Configure MCP Client
+
+Add to your MCP client configuration (e.g., [Claude Desktop](https://claude.ai/download)'s `claude_desktop_config.json`):
+
+**Option 1: Using Kubb CLI (recommended):**
+```json
+{
+  "mcpServers": {
+    "kubb": {
+      "command": "npx",
+      "args": ["kubb", "mcp"]
+    }
+  }
+}
+```
+
+**Option 2: Using standalone bin:**
+```json
+{
+  "mcpServers": {
+    "kubb": {
+      "command": "npx",
+      "args": ["@kubb/mcp"]
+    }
+  }
+}
+```
+
+For project-specific configurations, you can specify the working directory:
+
+```json
+{
+  "mcpServers": {
+    "kubb-petstore": {
+      "command": "npx",
+      "args": ["@kubb/mcp"],
+      "cwd": "/path/to/your/project"
+    }
+  }
+}
+```
+
+### Available Tools
+
+#### `generate`
+
+Generate code from OpenAPI/Swagger specifications using Kubb configuration.
+
+**Parameters:**
+- `config` (string, optional): Path to kubb.config.ts file. If not provided, looks for kubb.config.ts in current directory
+- `input` (string, optional): Path to OpenAPI/Swagger spec file (overrides config file setting)
+- `output` (string, optional): Output directory path (overrides config file setting)
+- `logLevel` (enum, optional): Control logging verbosity - `'silent'`, `'error'`, `'warn'`, `'info'`, `'verbose'`, `'debug'` (default: 'info')
+
+**Examples:**
+
+Using default config file:
+```json
+{
+  "config": "./kubb.config.ts"
+}
+```
+
+Overriding input and output:
+```json
+{
+  "config": "./kubb.config.ts",
+  "input": "./specs/petstore.yaml",
+  "output": "./src/generated"
+}
+```
+
+With verbose logging:
+```json
+{
+  "config": "./kubb.config.ts",
+  "logLevel": "verbose"
+}
+```
+
+## Configuration
+
+The build tool looks for `kubb.config.ts` in the current directory by default. You can also provide an inline configuration or path to a config file.
+
+Example `kubb.config.ts`:
+
+```typescript
+import { defineConfig } from '@kubb/core'
+import { pluginOas } from '@kubb/plugin-oas'
+import { pluginTs } from '@kubb/plugin-ts'
+import { pluginClient } from '@kubb/plugin-client'
+
+export default defineConfig({
+  input: {
+    path: './petstore.yaml',
+  },
+  output: {
+    path: './src/generated',
+  },
+  plugins: [
+    pluginOas(),
+    pluginTs(),
+    pluginClient(),
+  ],
+})
+```
+
+## License
+
+MIT
+

package/bin/kubb-mcp.cjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import('../dist/index.js')
+  .then(({ run }) => {
+    process.title = 'Kubb MCP'
+    run(process.argv)
+  })
+  .catch((err) => {
+    console.error('Failed to start Kubb MCP server:', err)
+    process.exit(1)
+  })

package/dist/index.cjs

@@ -1,3 +1,345 @@
-const require_src = require('./src-C8Z8ptbx.cjs');
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
-exports.startServer = require_src.startServer;
+//#endregion
+let node_process = require("node:process");
+node_process = __toESM(node_process);
+let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
+let _modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
+let zod = require("zod");
+let _kubb_core = require("@kubb/core");
+let _kubb_core_utils = require("@kubb/core/utils");
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let jiti = require("jiti");
+jiti = __toESM(jiti);
+
+//#region package.json
+var version = "4.17.0";
+
+//#endregion
+//#region src/schemas/generateSchema.ts
+const generateSchema = zod.z.object({
+	config: zod.z.string().optional().describe("Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory"),
+	input: zod.z.string().optional().describe("Path to OpenAPI/Swagger spec file (overrides config)"),
+	output: zod.z.string().optional().describe("Output directory path (overrides config)"),
+	logLevel: zod.z.enum([
+		"silent",
+		"error",
+		"warn",
+		"info",
+		"verbose",
+		"debug"
+	]).optional().default("info").describe("Log level for build output")
+});
+
+//#endregion
+//#region src/types.ts
+const NotifyTypes = {
+	INFO: "INFO",
+	SUCCESS: "SUCCESS",
+	ERROR: "ERROR",
+	WARN: "WARN",
+	PLUGIN_START: "PLUGIN_START",
+	PLUGIN_END: "PLUGIN_END",
+	FILES_START: "FILES_START",
+	FILE_UPDATE: "FILE_UPDATE",
+	FILES_END: "FILES_END",
+	GENERATION_START: "GENERATION_START",
+	GENERATION_END: "GENERATION_END",
+	CONFIG_LOADED: "CONFIG_LOADED",
+	CONFIG_ERROR: "CONFIG_ERROR",
+	CONFIG_READY: "CONFIG_READY",
+	SETUP_START: "SETUP_START",
+	SETUP_END: "SETUP_END",
+	BUILD_START: "BUILD_START",
+	BUILD_END: "BUILD_END",
+	BUILD_FAILED: "BUILD_FAILED",
+	BUILD_SUCCESS: "BUILD_SUCCESS",
+	FATAL_ERROR: "FATAL_ERROR"
+};
+
+//#endregion
+//#region src/utils/loadUserConfig.ts
+const jiti$1 = (0, jiti.default)(require("url").pathToFileURL(__filename).href, { sourceMaps: true });
+/**
+* Load the user configuration from the specified path or current directory
+*/
+async function loadUserConfig(configPath, { notify }) {
+	let userConfig;
+	let cwd;
+	if (configPath) {
+		cwd = node_path.default.dirname(node_path.default.resolve(configPath));
+		try {
+			userConfig = await jiti$1.import(configPath, { default: true });
+			await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${configPath}`);
+		} catch (error) {
+			await notify(NotifyTypes.CONFIG_ERROR, `Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
+			throw new Error(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	} else {
+		cwd = process.cwd();
+		const configFileNames = [
+			"kubb.config.ts",
+			"kubb.config.js",
+			"kubb.config.cjs"
+		];
+		for (const configFileName of configFileNames) try {
+			const configFilePath = node_path.default.resolve(process.cwd(), configFileName);
+			userConfig = await jiti$1.import(configFilePath, { default: true });
+			await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`);
+			break;
+		} catch {}
+		if (!userConfig) {
+			await notify(NotifyTypes.CONFIG_ERROR, "No config file found");
+			throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(", ")}`);
+		}
+	}
+	return {
+		userConfig,
+		cwd
+	};
+}
+
+//#endregion
+//#region src/utils/resolveCwd.ts
+/**
+* Determine the root directory based on userConfig.root and resolvedConfigDir
+* 1. If userConfig.root exists and is absolute, use it as-is
+* 2. If userConfig.root exists and is relative, resolve it relative to config directory
+* 3. Otherwise, use the config directory as root
+*/
+function resolveCwd(userConfig, cwd) {
+	if (userConfig.root) {
+		if (node_path.default.isAbsolute(userConfig.root)) return userConfig.root;
+		return node_path.default.resolve(cwd, userConfig.root);
+	}
+	return cwd;
+}
+
+//#endregion
+//#region src/utils/resolveUserConfig.ts
+/**
+* Resolve the config by handling function configs and returning the final configuration
+*/
+async function resolveUserConfig(userConfig, options) {
+	let kubbUserConfig = Promise.resolve(userConfig);
+	if (typeof userConfig === "function") {
+		const possiblePromise = userConfig({
+			logLevel: options.logLevel,
+			config: options.configPath
+		});
+		if ((0, _kubb_core_utils.isPromise)(possiblePromise)) kubbUserConfig = possiblePromise;
+		else kubbUserConfig = Promise.resolve(possiblePromise);
+	}
+	return await kubbUserConfig;
+}
+
+//#endregion
+//#region src/tools/generate.ts
+/**
+* Build tool that generates code from OpenAPI specs using Kubb.
+* Sends real-time notifications of build progress and events.
+*/
+async function generate(schema, handler) {
+	const { config: configPath, input, output, logLevel } = schema;
+	try {
+		const events = new _kubb_core_utils.AsyncEventEmitter();
+		const messages = [];
+		const notify = async (type, message, data) => {
+			messages.push(`${type}: ${message}`);
+			await handler.sendNotification("kubb/progress", {
+				type,
+				message,
+				timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+				...data
+			});
+		};
+		events.on("info", async (message) => {
+			await notify(NotifyTypes.INFO, message);
+		});
+		events.on("success", async (message) => {
+			await notify(NotifyTypes.SUCCESS, message);
+		});
+		events.on("error", async (error$1) => {
+			await notify(NotifyTypes.ERROR, error$1.message, { stack: error$1.stack });
+		});
+		events.on("warn", async (message) => {
+			await notify(NotifyTypes.WARN, message);
+		});
+		events.on("plugin:start", async ({ name }) => {
+			await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${name}`);
+		});
+		events.on("plugin:end", async ({ name, duration }) => {
+			await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${name}`, { duration });
+		});
+		events.on("files:processing:start", async () => {
+			await notify(NotifyTypes.FILES_START, "Starting file processing");
+		});
+		events.on("file:processing:update", async ({ file }) => {
+			await notify(NotifyTypes.FILE_UPDATE, `Processing file: ${file.name}`);
+		});
+		events.on("files:processing:end", async () => {
+			await notify(NotifyTypes.FILES_END, "File processing complete");
+		});
+		events.on("generation:start", async () => {
+			await notify(NotifyTypes.GENERATION_START, "Generation started");
+		});
+		events.on("generation:end", async () => {
+			await notify(NotifyTypes.GENERATION_END, "Generation ended");
+		});
+		let userConfig;
+		let cwd;
+		try {
+			const configResult = await loadUserConfig(configPath, { notify });
+			userConfig = configResult.userConfig;
+			cwd = configResult.cwd;
+			if (Array.isArray(userConfig) && userConfig.length) throw new Error("Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.");
+			userConfig = await resolveUserConfig(userConfig, {
+				configPath,
+				logLevel
+			});
+		} catch (error$1) {
+			const errorMessage = error$1 instanceof Error ? error$1.message : String(error$1);
+			await notify(NotifyTypes.CONFIG_ERROR, errorMessage);
+			return {
+				content: [{
+					type: "text",
+					text: errorMessage
+				}],
+				isError: true
+			};
+		}
+		const inputPath = input ?? ("path" in userConfig.input ? userConfig.input.path : void 0);
+		const config = {
+			...userConfig,
+			root: resolveCwd(userConfig, cwd),
+			input: inputPath ? {
+				...userConfig.input,
+				path: inputPath
+			} : userConfig.input,
+			output: output ? {
+				...userConfig.output,
+				path: output
+			} : userConfig.output
+		};
+		await notify(NotifyTypes.CONFIG_READY, "Configuration ready", { root: config.root });
+		await notify(NotifyTypes.SETUP_START, "Setting up Kubb");
+		const { fabric, pluginManager } = await (0, _kubb_core.setup)({
+			config,
+			events
+		});
+		await notify(NotifyTypes.SETUP_END, "Kubb setup complete");
+		await notify(NotifyTypes.BUILD_START, "Starting build");
+		const { files, failedPlugins, error } = await (0, _kubb_core.safeBuild)({
+			config,
+			events
+		}, {
+			pluginManager,
+			fabric,
+			events
+		});
+		await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`);
+		if (error || failedPlugins.size > 0) {
+			const allErrors = [error, ...Array.from(failedPlugins).filter((it) => it.error).map((it) => it.error)].filter(Boolean);
+			await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`, {
+				errorCount: allErrors.length,
+				errors: allErrors.map((err) => err.message)
+			});
+			return {
+				content: [{
+					type: "text",
+					text: `Build failed:\n${allErrors.map((err) => err.message).join("\n")}\n\n${messages.join("\n")}`
+				}],
+				isError: true
+			};
+		}
+		await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`, { filesCount: files.length });
+		return { content: [{
+			type: "text",
+			text: `Build completed successfully!\n\nGenerated ${files.length} files\n\n${messages.join("\n")}`
+		}] };
+	} catch (caughtError) {
+		const error = caughtError;
+		await handler.sendNotification("kubb/progress", {
+			type: NotifyTypes.FATAL_ERROR,
+			message: error.message,
+			stack: error.stack,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		return {
+			content: [{
+				type: "text",
+				text: `Build error: ${error.message}\n${error.stack || ""}`
+			}],
+			isError: true
+		};
+	}
+}
+
+//#endregion
+//#region src/server.ts
+/**
+* Kubb MCP Server
+*
+* Provides tools for building OpenAPI specifications using Kubb.
+*/
+async function startServer() {
+	try {
+		const transport = new _modelcontextprotocol_sdk_server_stdio_js.StdioServerTransport();
+		const server = new _modelcontextprotocol_sdk_server_mcp_js.McpServer({
+			name: "Kubb",
+			version
+		});
+		server.tool("generate", "Generate OpenAPI spec helpers using Kubb configuration", generateSchema.shape, async (args) => {
+			return generate(args, { sendNotification: async (method, params) => {
+				try {
+					await transport.send({
+						jsonrpc: "2.0",
+						method,
+						params
+					});
+				} catch (error) {
+					console.error("Failed to send notification:", error);
+				}
+			} });
+		});
+		await server.connect(transport);
+	} catch (error) {
+		console.error("Failed to start MCP server:", error);
+		node_process.default.exit(1);
+	}
+}
+
+//#endregion
+//#region src/index.ts
+async function run(_argv) {
+	await startServer();
+}
+
+//#endregion
+exports.run = run;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["z","jiti","userConfig: Config | undefined","cwd: string","path","path","AsyncEventEmitter","messages: string[]","error","userConfig: Config","cwd: string","config: Config","allErrors: Error[]","StdioServerTransport","McpServer"],"sources":["../package.json","../src/schemas/generateSchema.ts","../src/types.ts","../src/utils/loadUserConfig.ts","../src/utils/resolveCwd.ts","../src/utils/resolveUserConfig.ts","../src/tools/generate.ts","../src/server.ts","../src/index.ts"],"sourcesContent":["","import { z } from 'zod'\n\nexport const generateSchema = z.object({\n  config: z\n    .string()\n    .optional()\n\n    .describe('Path to kubb.config file (supports .ts, .js, .cjs). If not provided, will look for kubb.config.{ts,js,cjs} in current directory'),\n  input: z.string().optional().describe('Path to OpenAPI/Swagger spec file (overrides config)'),\n  output: z.string().optional().describe('Output directory path (overrides config)'),\n  logLevel: z.enum(['silent', 'error', 'warn', 'info', 'verbose', 'debug']).optional().default('info').describe('Log level for build output'),\n})\n\n","export const NotifyTypes = {\n  INFO: 'INFO',\n  SUCCESS: 'SUCCESS',\n  ERROR: 'ERROR',\n  WARN: 'WARN',\n  PLUGIN_START: 'PLUGIN_START',\n  PLUGIN_END: 'PLUGIN_END',\n  FILES_START: 'FILES_START',\n  FILE_UPDATE: 'FILE_UPDATE',\n  FILES_END: 'FILES_END',\n  GENERATION_START: 'GENERATION_START',\n  GENERATION_END: 'GENERATION_END',\n  CONFIG_LOADED: 'CONFIG_LOADED',\n  CONFIG_ERROR: 'CONFIG_ERROR',\n  CONFIG_READY: 'CONFIG_READY',\n  SETUP_START: 'SETUP_START',\n  SETUP_END: 'SETUP_END',\n  BUILD_START: 'BUILD_START',\n  BUILD_END: 'BUILD_END',\n  BUILD_FAILED: 'BUILD_FAILED',\n  BUILD_SUCCESS: 'BUILD_SUCCESS',\n  FATAL_ERROR: 'FATAL_ERROR',\n} as const\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\nimport createJiti from 'jiti'\nimport { NotifyTypes } from '../types.ts'\n\ntype NotifyFunction = (type: string, message: string, data?: Record<string, unknown>) => Promise<void>\n\nconst jiti = createJiti(import.meta.url, {\n  sourceMaps: true,\n})\n\n/**\n * Load the user configuration from the specified path or current directory\n */\nexport async function loadUserConfig(configPath: string | undefined, { notify }: { notify: NotifyFunction }): Promise<{ userConfig: Config; cwd: string }> {\n  let userConfig: Config | undefined\n  let cwd: string\n\n  if (configPath) {\n    // Resolve the config path to absolute path and get its directory\n    cwd = path.dirname(path.resolve(configPath))\n\n    // Try to load from path\n    try {\n      userConfig = await jiti.import(configPath, { default: true })\n      await notify(NotifyTypes.CONFIG_LOADED, `Loaded config from ${configPath}`)\n    } catch (error) {\n      await notify(NotifyTypes.CONFIG_ERROR, `Failed to load config: ${error instanceof Error ? error.message : String(error)}`)\n      throw new Error(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`)\n    }\n  } else {\n    // Look for kubb.config in current directory with various extensions\n    cwd = process.cwd()\n    const configFileNames = ['kubb.config.ts', 'kubb.config.js', 'kubb.config.cjs']\n\n    for (const configFileName of configFileNames) {\n      try {\n        const configFilePath = path.resolve(process.cwd(), configFileName)\n        userConfig = await jiti.import(configFilePath, { default: true })\n        await notify(NotifyTypes.CONFIG_LOADED, `Loaded ${configFileName} from current directory`)\n        break\n      } catch {\n        // Continue trying next config file\n      }\n    }\n\n    if (!userConfig) {\n      await notify(NotifyTypes.CONFIG_ERROR, 'No config file found')\n\n      throw new Error(`No config file found. Please provide a config path or create one of: ${configFileNames.join(', ')}`)\n    }\n  }\n\n  return { userConfig: userConfig!, cwd }\n}\n","import path from 'node:path'\nimport type { Config } from '@kubb/core'\n\n/**\n * Determine the root directory based on userConfig.root and resolvedConfigDir\n * 1. If userConfig.root exists and is absolute, use it as-is\n * 2. If userConfig.root exists and is relative, resolve it relative to config directory\n * 3. Otherwise, use the config directory as root\n */\nexport function resolveCwd(userConfig: Config, cwd: string): string {\n  if (userConfig.root) {\n    if (path.isAbsolute(userConfig.root)) {\n      return userConfig.root\n    }\n\n    return path.resolve(cwd, userConfig.root)\n  }\n\n  return cwd\n}\n","import type { CLIOptions, Config, UserConfig } from '@kubb/core'\nimport { isPromise } from '@kubb/core/utils'\n\nexport type ResolveUserConfigOptions = {\n  configPath?: string\n  logLevel?: string\n}\n\n/**\n * Resolve the config by handling function configs and returning the final configuration\n */\nexport async function resolveUserConfig(userConfig: UserConfig, options: ResolveUserConfigOptions): Promise<Config> {\n  let kubbUserConfig = Promise.resolve(userConfig) as Promise<UserConfig>\n\n  if (typeof userConfig === 'function') {\n    const possiblePromise = (userConfig as any)({ logLevel: options.logLevel, config: options.configPath } as CLIOptions)\n    if (isPromise(possiblePromise)) {\n      kubbUserConfig = possiblePromise\n    } else {\n      kubbUserConfig = Promise.resolve(possiblePromise)\n    }\n  }\n\n  return (await kubbUserConfig) as Config\n}\n","import { type Config, type KubbEvents, safeBuild, setup } from '@kubb/core'\nimport { AsyncEventEmitter } from '@kubb/core/utils'\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.d.ts'\nimport type { z } from 'zod'\nimport type { generateSchema } from '../schemas/generateSchema.ts'\nimport { NotifyTypes } from '../types.ts'\nimport { loadUserConfig } from '../utils/loadUserConfig.ts'\nimport { resolveCwd } from '../utils/resolveCwd.ts'\nimport { resolveUserConfig } from '../utils/resolveUserConfig.ts'\n\ninterface NotificationHandler {\n  sendNotification(method: string, params: unknown): Promise<void>\n}\n\n/**\n * Build tool that generates code from OpenAPI specs using Kubb.\n * Sends real-time notifications of build progress and events.\n */\nexport async function generate(schema: z.infer<typeof generateSchema>, handler: NotificationHandler): Promise<CallToolResult> {\n  const { config: configPath, input, output, logLevel } = schema\n\n  try {\n    const events = new AsyncEventEmitter<KubbEvents>()\n    const messages: string[] = []\n\n    // Helper to send notifications\n    const notify = async (type: string, message: string, data?: Record<string, unknown>) => {\n      messages.push(`${type}: ${message}`)\n\n      await handler.sendNotification('kubb/progress', {\n        type,\n        message,\n        timestamp: new Date().toISOString(),\n        ...data,\n      })\n    }\n\n    // Capture events for output and send notifications\n    events.on('info', async (message: string) => {\n      await notify(NotifyTypes.INFO, message)\n    })\n\n    events.on('success', async (message: string) => {\n      await notify(NotifyTypes.SUCCESS, message)\n    })\n\n    events.on('error', async (error: Error) => {\n      await notify(NotifyTypes.ERROR, error.message, { stack: error.stack })\n    })\n\n    events.on('warn', async (message: string) => {\n      await notify(NotifyTypes.WARN, message)\n    })\n\n    // Plugin lifecycle events\n    events.on('plugin:start', async ({ name }: { name: string }) => {\n      await notify(NotifyTypes.PLUGIN_START, `Plugin starting: ${name}`)\n    })\n\n    events.on('plugin:end', async ({ name, duration }: { name: string; duration?: number }) => {\n      await notify(NotifyTypes.PLUGIN_END, `Plugin finished: ${name}`, { duration })\n    })\n\n    // File processing events\n    events.on('files:processing:start', async () => {\n      await notify(NotifyTypes.FILES_START, 'Starting file processing')\n    })\n\n    events.on('file:processing:update', async ({ file }: { file: { name: string } }) => {\n      await notify(NotifyTypes.FILE_UPDATE, `Processing file: ${file.name}`)\n    })\n\n    events.on('files:processing:end', async () => {\n      await notify(NotifyTypes.FILES_END, 'File processing complete')\n    })\n\n    // Generation events\n    events.on('generation:start', async () => {\n      await notify(NotifyTypes.GENERATION_START, 'Generation started')\n    })\n\n    events.on('generation:end', async () => {\n      await notify(NotifyTypes.GENERATION_END, 'Generation ended')\n    })\n\n    // Load and process configuration\n    let userConfig: Config\n    let cwd: string\n\n    try {\n      const configResult = await loadUserConfig(configPath, { notify })\n      userConfig = configResult.userConfig\n      cwd = configResult.cwd\n\n      if (Array.isArray(userConfig) && userConfig.length) {\n        throw new Error('Array type in kubb.config.ts is not supported in this tool. Please provide a single configuration object.')\n      }\n\n      userConfig = await resolveUserConfig(userConfig, { configPath, logLevel })\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error)\n      await notify(NotifyTypes.CONFIG_ERROR, errorMessage)\n      return {\n        content: [\n          {\n            type: 'text',\n            text: errorMessage,\n          },\n        ],\n        isError: true,\n      }\n    }\n\n    const inputPath = input ?? ('path' in userConfig.input ? userConfig.input.path : undefined)\n\n    // Override config with CLI options\n    const config: Config = {\n      ...userConfig,\n      root: resolveCwd(userConfig, cwd),\n      input: inputPath\n        ? {\n            ...userConfig.input,\n            path: inputPath,\n          }\n        : userConfig.input,\n      output: output\n        ? {\n            ...userConfig.output,\n            path: output,\n          }\n        : userConfig.output,\n    }\n\n    await notify(NotifyTypes.CONFIG_READY, 'Configuration ready', {\n      root: config.root,\n    })\n\n    // Setup and build\n    await notify(NotifyTypes.SETUP_START, 'Setting up Kubb')\n\n    const { fabric, pluginManager } = await setup({\n      config,\n      events,\n    })\n    await notify(NotifyTypes.SETUP_END, 'Kubb setup complete')\n\n    await notify(NotifyTypes.BUILD_START, 'Starting build')\n    const { files, failedPlugins, error } = await safeBuild(\n      {\n        config,\n        events,\n      },\n      { pluginManager, fabric, events },\n    )\n    await notify(NotifyTypes.BUILD_END, `Build complete - Generated ${files.length} files`)\n\n    if (error || failedPlugins.size > 0) {\n      const allErrors: Error[] = [\n        error,\n        ...Array.from(failedPlugins)\n          .filter((it) => it.error)\n          .map((it) => it.error),\n      ].filter(Boolean)\n\n      await notify(NotifyTypes.BUILD_FAILED, `Build failed with ${allErrors.length} error(s)`, {\n        errorCount: allErrors.length,\n        errors: allErrors.map((err) => err.message),\n      })\n\n      return {\n        content: [\n          {\n            type: 'text',\n            text: `Build failed:\\n${allErrors.map((err) => err.message).join('\\n')}\\n\\n${messages.join('\\n')}`,\n          },\n        ],\n        isError: true,\n      }\n    }\n\n    await notify(NotifyTypes.BUILD_SUCCESS, `Build completed successfully - Generated ${files.length} files`, {\n      filesCount: files.length,\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Build completed successfully!\\n\\nGenerated ${files.length} files\\n\\n${messages.join('\\n')}`,\n        },\n      ],\n    }\n  } catch (caughtError) {\n    const error = caughtError as Error\n\n    await handler.sendNotification('kubb/progress', {\n      type: NotifyTypes.FATAL_ERROR,\n      message: error.message,\n      stack: error.stack,\n      timestamp: new Date().toISOString(),\n    })\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: `Build error: ${error.message}\\n${error.stack || ''}`,\n        },\n      ],\n      isError: true,\n    }\n  }\n}\n","import process from 'node:process'\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { version } from '../package.json'\nimport { generateSchema } from './schemas/generateSchema.ts'\nimport { generate } from './tools/generate.ts'\n\n/**\n * Kubb MCP Server\n *\n * Provides tools for building OpenAPI specifications using Kubb.\n */\nexport async function startServer() {\n  try {\n    const transport = new StdioServerTransport()\n    const server = new McpServer({\n      name: 'Kubb',\n      version,\n    })\n\n    // Build tool - runs Kubb build using @kubb/core\n    // Wrapped to pass notification handler for real-time progress updates\n    server.tool('generate', 'Generate OpenAPI spec helpers using Kubb configuration', generateSchema.shape, async (args) => {\n      // Create notification handler that sends events back to the client\n      const notificationHandler = {\n        sendNotification: async (method: string, params: any) => {\n          try {\n            await transport.send({\n              jsonrpc: '2.0',\n              method,\n              params,\n            })\n          } catch (error) {\n            console.error('Failed to send notification:', error)\n          }\n        },\n      }\n\n      // Call build tool with notification handler\n      return generate(args, notificationHandler)\n    })\n\n    await server.connect(transport)\n  } catch (error) {\n    console.error('Failed to start MCP server:', error)\n    process.exit(1)\n  }\n}\n","import { startServer } from './server.ts'\n\nexport async function run(_argv?: string[]): Promise<void> {\n  await startServer()\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 //#region src/index.d.ts
-declare function startServer(): Promise<void>;
+declare function run(_argv?: string[]): Promise<void>;
 //#endregion
-export { startServer };
+export { run };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 //#region src/index.d.ts
-declare function startServer(): Promise<void>;
+declare function run(_argv?: string[]): Promise<void>;
 //#endregion
-export { startServer };
+export { run };
 //# sourceMappingURL=index.d.ts.map