@kubb/plugin-mcp 5.1.0 → 5.1.2

package/README.md

@@ -10,7 +10,7 @@
 [![Node][node-src]][node-href]
 
 <h4>
-<a href="https://kubb.dev/plugins/plugin-mcp" target="_blank">Documentation</a>
+<a href="https://kubb.dev/extensions/kubb-labs/plugin-mcp" target="_blank">Documentation</a>
 <span> · </span>
 <a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
 <span> · </span>
@@ -38,7 +38,7 @@ npm install @kubb/plugin-mcp
 
 ## Documentation
 
-See the [full documentation](https://kubb.dev/plugins/plugin-mcp) for configuration options and examples.
+See the [full documentation](https://kubb.dev/extensions/kubb-labs/plugin-mcp) for configuration options and examples.
 
 ## Supporting Kubb
 

package/dist/index.cjs

@@ -261,6 +261,27 @@ function camelCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
 }
 //#endregion
+//#region ../../internals/utils/src/fs.ts
+function toSlash(p) {
+	if (p.startsWith("\\\\?\\")) return p;
+	return p.replaceAll("\\", "/");
+}
+/**
+* Returns the relative path from `rootDir` to `filePath`, always using forward slashes
+* and prefixed with `./` when not already traversing upward.
+*
+* @example
+* ```ts
+* getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'
+* getRelativePath('/src/components', '/src/utils/helpers.ts')      // '../utils/helpers.ts'
+* ```
+*/
+function getRelativePath(rootDir, filePath) {
+	if (!rootDir || !filePath) throw new Error(`Root and file should be filled in when retrieving the relativePath, ${rootDir || ""} ${filePath || ""}`);
+	const relativePath = node_path.posix.relative(toSlash(rootDir), toSlash(filePath));
+	return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
+}
+//#endregion
 //#region ../../internals/shared/src/group.ts
 /**
 * Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
@@ -718,11 +739,21 @@ const serverGenerator = (0, kubb_kit.defineGenerator)({
 			path: node_path.default.resolve(root, output.path, "server.ts"),
 			meta: { pluginName: plugin.name }
 		};
+		const startFile = {
+			baseName: "start.ts",
+			path: node_path.default.resolve(root, output.path, "start.ts"),
+			meta: { pluginName: plugin.name }
+		};
 		const jsonFile = {
 			baseName: ".mcp.json",
 			path: node_path.default.resolve(root, output.path, ".mcp.json"),
 			meta: { pluginName: plugin.name }
 		};
+		const mcpConfig = { mcpServers: { [ctx.meta.title || "server"]: {
+			type: "stdio",
+			command: "npx",
+			args: ["tsx", getRelativePath(node_path.default.resolve(config.root), startFile.path)]
+		} } };
 		const operationsMapped = nodes.filter(kubb_kit.ast.isHttpOperationNode).map((node) => {
 			const { path: pathParams, query: queryParams, header: headerParams } = getOperationParameters(node);
 			const mcpFile = resolver.file({
@@ -790,76 +821,98 @@ const serverGenerator = (0, kubb_kit.defineGenerator)({
 				path: zod.file.path
 			}, `zod-${mcp.name}`)].filter(Boolean);
 		});
-		return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
-			baseName: serverFile.baseName,
-			path: serverFile.path,
-			meta: serverFile.meta,
-			banner: resolver.default.banner(ctx.meta, {
-				output,
-				config,
-				file: {
-					path: serverFile.path,
-					baseName: serverFile.baseName
-				}
-			}),
-			footer: resolver.default.footer(ctx.meta, {
-				output,
-				config,
-				file: {
-					path: serverFile.path,
-					baseName: serverFile.baseName
-				}
-			}),
-			children: [
-				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-					name: ["McpServer"],
-					path: "@modelcontextprotocol/server"
+		return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx_jsx_runtime.Fragment, { children: [
+			/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
+				baseName: serverFile.baseName,
+				path: serverFile.path,
+				meta: serverFile.meta,
+				banner: resolver.default.banner(ctx.meta, {
+					output,
+					config,
+					file: {
+						path: serverFile.path,
+						baseName: serverFile.baseName
+					}
 				}),
-				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-					name: ["serveStdio"],
-					path: "@modelcontextprotocol/server/stdio"
+				footer: resolver.default.footer(ctx.meta, {
+					output,
+					config,
+					file: {
+						path: serverFile.path,
+						baseName: serverFile.baseName
+					}
 				}),
-				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
-					name: ["z"],
-					path: "zod"
+				children: [
+					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
+						name: ["McpServer"],
+						path: "@modelcontextprotocol/server"
+					}),
+					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
+						name: ["serveStdio"],
+						path: "@modelcontextprotocol/server/stdio"
+					}),
+					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
+						name: ["z"],
+						path: "zod"
+					}),
+					imports,
+					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(Server, {
+						serverName: ctx.meta.title ?? "server",
+						serverVersion: ctx.meta.version ?? "0.0.0",
+						operations: operationsMapped
+					})
+				]
+			}),
+			/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
+				baseName: startFile.baseName,
+				path: startFile.path,
+				meta: startFile.meta,
+				banner: resolver.default.banner(ctx.meta, {
+					output,
+					config,
+					file: {
+						path: startFile.path,
+						baseName: startFile.baseName
+					}
 				}),
-				imports,
-				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(Server, {
-					serverName: ctx.meta.title ?? "server",
-					serverVersion: ctx.meta.version ?? "0.0.0",
-					operations: operationsMapped
+				footer: resolver.default.footer(ctx.meta, {
+					output,
+					config,
+					file: {
+						path: startFile.path,
+						baseName: startFile.baseName
+					}
+				}),
+				children: [/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
+					name: ["startServer"],
+					root: startFile.path,
+					path: serverFile.path
+				}), /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
+					name: "start",
+					children: "void startServer()"
+				})]
+			}),
+			/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File, {
+				baseName: jsonFile.baseName,
+				path: jsonFile.path,
+				meta: jsonFile.meta,
+				children: /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
+					name,
+					children: `${JSON.stringify(mcpConfig, null, 2)}\n`
 				})
-			]
-		}), /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File, {
-			baseName: jsonFile.baseName,
-			path: jsonFile.path,
-			meta: jsonFile.meta,
-			children: /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
-				name,
-				children: `
-          {
-            "mcpServers": {
-              "${ctx.meta.title || "server"}": {
-                "type": "stdio",
-                "command": "npx",
-                "args": ["tsx", "${node_path.default.relative(node_path.default.dirname(jsonFile.path), serverFile.path)}"]
-              }
-            }
-          }
-          `
 			})
-		})] });
+		] });
 	}
 });
 //#endregion
 //#region kubb-extension.json
 var compatibility = {
-	"kubb": ">=5.8.0",
+	"kubb": ">=5.8.3",
 	"node": ">=22"
 };
 //#endregion
 //#region package.json
-var version = "5.1.0";
+var version = "5.1.2";
 //#endregion
 //#region src/resolvers/resolverMcp.ts
 /**
@@ -895,12 +948,15 @@ const pluginMcpName = "plugin-mcp";
 * operation becomes a typed MCP tool that AI assistants (Claude Desktop, Claude
 * Code, MCP-compatible clients) can call directly. Each handler calls a contract
 * client `<op>` from a registered `@kubb/plugin-axios` or `@kubb/plugin-fetch`.
+* Next to the handlers it writes `server.ts`, a `start.ts` entry that serves the
+* tools over stdio, and a `.mcp.json` that runs `start.ts` with `tsx`.
 *
 * @example
 * ```ts
 * import { defineConfig } from 'kubb/config'
 * import { pluginTs } from '@kubb/plugin-ts'
 * import { pluginZod } from '@kubb/plugin-zod'
+* import { pluginFetch } from '@kubb/plugin-fetch'
 * import { pluginMcp } from '@kubb/plugin-mcp'
 *
 * export default defineConfig({
@@ -909,15 +965,14 @@ const pluginMcpName = "plugin-mcp";
 *   plugins: [
 *     pluginTs(),
 *     pluginZod(),
-*     pluginMcp({
-*       output: { path: './mcp' },
-*       baseURL: 'https://petstore.swagger.io/v2',
-*     }),
+*     pluginFetch({ baseURL: 'https://petstore.swagger.io/v2' }),
+*     pluginMcp({ output: { path: 'mcp' } }),
 *   ],
 * })
 * ```
 */
-const pluginMcp = (0, kubb_kit.definePlugin)({
+const pluginMcp = (0, kubb_kit.defineExtension)({
+	kind: "plugin",
 	meta: {
 		name: pluginMcpName,
 		version,