@kubb/plugin-mcp 5.0.0-alpha.9 → 5.0.0-beta.4

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fetchClientSource","axiosClientSource","configSource"],"sources":["../src/plugin.ts"],"sourcesContent":["import path from 'node:path'\nimport { camelCase } from '@internals/utils'\nimport { createPlugin, type Group, getBarrelFiles, getMode } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { OperationGenerator, pluginOasName } from '@kubb/plugin-oas'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mcpGenerator, serverGenerator } from './generators'\nimport type { PluginMcp } from './types.ts'\n\nexport const pluginMcpName = 'plugin-mcp' satisfies PluginMcp['name']\n\nexport const pluginMcp = createPlugin<PluginMcp>((options) => {\n  const {\n    output = { path: 'mcp', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    transformers = {},\n    generators = [mcpGenerator, serverGenerator].filter(Boolean),\n    contentType,\n    paramsCasing,\n    client,\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  return {\n    name: pluginMcpName,\n    options: {\n      output,\n      group,\n      paramsCasing,\n      client: {\n        client: clientName,\n        clientType: client?.clientType ?? 'function',\n        importPath: clientImportPath,\n        dataReturnType: client?.dataReturnType ?? 'data',\n        bundle: client?.bundle,\n        baseURL: client?.baseURL,\n        paramsCasing: client?.paramsCasing,\n      },\n    },\n    pre: [pluginOasName, pluginTsName, pluginZodName].filter(Boolean),\n    resolvePath(baseName, pathMode, options) {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = pathMode ?? getMode(path.resolve(root, output.path))\n\n      if (mode === 'single') {\n        /**\n         * when output is a file then we will always append to the same file(output file), see fileManager.addOrAppend\n         * Other plugins then need to call addOrAppend instead of just add from the fileManager class\n         */\n        return path.resolve(root, output.path)\n      }\n\n      if (group && (options?.group?.path || options?.group?.tag)) {\n        const groupName: Group['name'] = group?.name\n          ? group.name\n          : (ctx) => {\n              if (group?.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Requests`\n            }\n\n        return path.resolve(\n          root,\n          output.path,\n          groupName({\n            group: group.type === 'path' ? options.group.path! : options.group.tag!,\n          }),\n          baseName,\n        )\n      }\n\n      return path.resolve(root, output.path, baseName)\n    },\n    resolveName(name, type) {\n      const resolvedName = camelCase(name, {\n        isFile: type === 'file',\n      })\n\n      if (type) {\n        return transformers?.name?.(resolvedName, type) || resolvedName\n      }\n\n      return resolvedName\n    },\n    async install() {\n      const root = path.resolve(this.config.root, this.config.output.path)\n      const mode = getMode(path.resolve(root, output.path))\n      const oas = await this.getOas()\n      const baseURL = await this.getBaseURL()\n\n      if (baseURL) {\n        this.plugin.options.client.baseURL = baseURL\n      }\n\n      const hasClientPlugin = !!this.driver.getPluginByName(pluginClientName)\n\n      if (this.plugin.options.client.bundle && !hasClientPlugin && !this.plugin.options.client.importPath) {\n        // pre add bundled fetch\n        await this.addFile({\n          baseName: 'fetch.ts',\n          path: path.resolve(root, '.kubb/fetch.ts'),\n          sources: [\n            {\n              name: 'fetch',\n              value: this.plugin.options.client.client === 'fetch' ? fetchClientSource : axiosClientSource,\n              isExportable: true,\n              isIndexable: true,\n            },\n          ],\n          imports: [],\n          exports: [],\n        })\n      }\n\n      if (!hasClientPlugin) {\n        await this.addFile({\n          baseName: 'config.ts',\n          path: path.resolve(root, '.kubb/config.ts'),\n          sources: [\n            {\n              name: 'config',\n              value: configSource,\n              isExportable: false,\n              isIndexable: false,\n            },\n          ],\n          imports: [],\n          exports: [],\n        })\n      }\n\n      const operationGenerator = new OperationGenerator(this.plugin.options, {\n        fabric: this.fabric,\n        oas,\n        driver: this.driver,\n        events: this.events,\n        plugin: this.plugin,\n        contentType,\n        exclude,\n        include,\n        override,\n        mode,\n      })\n\n      const files = await operationGenerator.build(...generators)\n      await this.upsertFile(...files)\n\n      const barrelFiles = await getBarrelFiles(this.fabric.files, {\n        type: output.barrelType ?? 'named',\n        root,\n        output,\n        meta: {\n          pluginName: this.plugin.name,\n        },\n      })\n\n      await this.upsertFile(...barrelFiles)\n    },\n  }\n})\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,gBAAgB;AAE7B,MAAa,YAAY,cAAyB,YAAY;CAC5D,MAAM,EACJ,SAAS;EAAE,MAAM;EAAO,YAAY;EAAS,EAC7C,OACA,UAAU,EAAE,EACZ,SACA,WAAW,EAAE,EACb,eAAe,EAAE,EACjB,aAAa,CAAC,cAAc,gBAAgB,CAAC,OAAO,QAAQ,EAC5D,aACA,cACA,WACE;CAEJ,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,mBAAmB,QAAQ,eAAe,CAAC,QAAQ,SAAS,+BAA+B,eAAe,KAAA;AAEhH,QAAO;EACL,MAAM;EACN,SAAS;GACP;GACA;GACA;GACA,QAAQ;IACN,QAAQ;IACR,YAAY,QAAQ,cAAc;IAClC,YAAY;IACZ,gBAAgB,QAAQ,kBAAkB;IAC1C,QAAQ,QAAQ;IAChB,SAAS,QAAQ;IACjB,cAAc,QAAQ;IACvB;GACF;EACD,KAAK;GAAC;GAAe;GAAc;GAAc,CAAC,OAAO,QAAQ;EACjE,YAAY,UAAU,UAAU,SAAS;GACvC,MAAM,OAAO,KAAK,QAAQ,KAAK,OAAO,MAAM,KAAK,OAAO,OAAO,KAAK;AAGpE,QAFa,YAAY,QAAQ,KAAK,QAAQ,MAAM,OAAO,KAAK,CAAC,MAEpD;;;;;AAKX,UAAO,KAAK,QAAQ,MAAM,OAAO,KAAK;AAGxC,OAAI,UAAU,SAAS,OAAO,QAAQ,SAAS,OAAO,MAAM;IAC1D,MAAM,YAA2B,OAAO,OACpC,MAAM,QACL,QAAQ;AACP,SAAI,OAAO,SAAS,OAClB,QAAO,GAAG,IAAI,MAAM,MAAM,IAAI,CAAC;AAEjC,YAAO,GAAG,UAAU,IAAI,MAAM,CAAC;;AAGrC,WAAO,KAAK,QACV,MACA,OAAO,MACP,UAAU,EACR,OAAO,MAAM,SAAS,SAAS,QAAQ,MAAM,OAAQ,QAAQ,MAAM,KACpE,CAAC,EACF,SACD;;AAGH,UAAO,KAAK,QAAQ,MAAM,OAAO,MAAM,SAAS;;EAElD,YAAY,MAAM,MAAM;GACtB,MAAM,eAAe,UAAU,MAAM,EACnC,QAAQ,SAAS,QAClB,CAAC;AAEF,OAAI,KACF,QAAO,cAAc,OAAO,cAAc,KAAK,IAAI;AAGrD,UAAO;;EAET,MAAM,UAAU;GACd,MAAM,OAAO,KAAK,QAAQ,KAAK,OAAO,MAAM,KAAK,OAAO,OAAO,KAAK;GACpE,MAAM,OAAO,QAAQ,KAAK,QAAQ,MAAM,OAAO,KAAK,CAAC;GACrD,MAAM,MAAM,MAAM,KAAK,QAAQ;GAC/B,MAAM,UAAU,MAAM,KAAK,YAAY;AAEvC,OAAI,QACF,MAAK,OAAO,QAAQ,OAAO,UAAU;GAGvC,MAAM,kBAAkB,CAAC,CAAC,KAAK,OAAO,gBAAgB,iBAAiB;AAEvE,OAAI,KAAK,OAAO,QAAQ,OAAO,UAAU,CAAC,mBAAmB,CAAC,KAAK,OAAO,QAAQ,OAAO,WAEvF,OAAM,KAAK,QAAQ;IACjB,UAAU;IACV,MAAM,KAAK,QAAQ,MAAM,iBAAiB;IAC1C,SAAS,CACP;KACE,MAAM;KACN,OAAO,KAAK,OAAO,QAAQ,OAAO,WAAW,UAAUA,WAAoBC;KAC3E,cAAc;KACd,aAAa;KACd,CACF;IACD,SAAS,EAAE;IACX,SAAS,EAAE;IACZ,CAAC;AAGJ,OAAI,CAAC,gBACH,OAAM,KAAK,QAAQ;IACjB,UAAU;IACV,MAAM,KAAK,QAAQ,MAAM,kBAAkB;IAC3C,SAAS,CACP;KACE,MAAM;KACN,OAAOC;KACP,cAAc;KACd,aAAa;KACd,CACF;IACD,SAAS,EAAE;IACX,SAAS,EAAE;IACZ,CAAC;GAgBJ,MAAM,QAAQ,MAba,IAAI,mBAAmB,KAAK,OAAO,SAAS;IACrE,QAAQ,KAAK;IACb;IACA,QAAQ,KAAK;IACb,QAAQ,KAAK;IACb,QAAQ,KAAK;IACb;IACA;IACA;IACA;IACA;IACD,CAAC,CAEqC,MAAM,GAAG,WAAW;AAC3D,SAAM,KAAK,WAAW,GAAG,MAAM;GAE/B,MAAM,cAAc,MAAM,eAAe,KAAK,OAAO,OAAO;IAC1D,MAAM,OAAO,cAAc;IAC3B;IACA;IACA,MAAM,EACJ,YAAY,KAAK,OAAO,MACzB;IACF,CAAC;AAEF,SAAM,KAAK,WAAW,GAAG,YAAY;;EAExC;EACD"}
+{"version":3,"file":"index.js","names":["#options","#transformParam","#eachParam","fetchClientSource","axiosClientSource","configSource"],"sources":["../../../internals/utils/src/casing.ts","../../../internals/utils/src/reserved.ts","../../../internals/utils/src/urlPath.ts","../src/utils.ts","../src/components/McpHandler.tsx","../src/components/Server.tsx","../src/generators/mcpGenerator.tsx","../src/generators/serverGenerator.tsx","../src/resolvers/resolverMcp.ts","../src/plugin.ts"],"sourcesContent":["type Options = {\n  /**\n   * When `true`, dot-separated segments are split on `.` and joined with `/` after casing.\n   */\n  isFile?: boolean\n  /**\n   * Text prepended before casing is applied.\n   */\n  prefix?: string\n  /**\n   * Text appended before casing is applied.\n   */\n  suffix?: string\n}\n\n/**\n * Shared implementation for camelCase and PascalCase conversion.\n * Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)\n * and capitalizes each word according to `pascal`.\n *\n * When `pascal` is `true` the first word is also capitalized (PascalCase), otherwise only subsequent words are.\n */\nfunction toCamelOrPascal(text: string, pascal: boolean): string {\n  const normalized = text\n    .trim()\n    .replace(/([a-z\\d])([A-Z])/g, '$1 $2')\n    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n    .replace(/(\\d)([a-z])/g, '$1 $2')\n\n  const words = normalized.split(/[\\s\\-_./\\\\:]+/).filter(Boolean)\n\n  return words\n    .map((word, i) => {\n      const allUpper = word.length > 1 && word === word.toUpperCase()\n      if (allUpper) return word\n      if (i === 0 && !pascal) return word.charAt(0).toLowerCase() + word.slice(1)\n      return word.charAt(0).toUpperCase() + word.slice(1)\n    })\n    .join('')\n    .replace(/[^a-zA-Z0-9]/g, '')\n}\n\n/**\n * Splits `text` on `.` and applies `transformPart` to each segment.\n * The last segment receives `isLast = true`, all earlier segments receive `false`.\n * Segments are joined with `/` to form a file path.\n *\n * Only splits on dots followed by a letter so that version numbers\n * embedded in operationIds (e.g. `v2025.0`) are kept intact.\n */\nfunction applyToFileParts(text: string, transformPart: (part: string, isLast: boolean) => string): string {\n  const parts = text.split(/\\.(?=[a-zA-Z])/)\n  return parts.map((part, i) => transformPart(part, i === parts.length - 1)).join('/')\n}\n\n/**\n * Converts `text` to camelCase.\n * When `isFile` is `true`, dot-separated segments are each cased independently and joined with `/`.\n *\n * @example\n * camelCase('hello-world')                   // 'helloWorld'\n * camelCase('pet.petId', { isFile: true })   // 'pet/petId'\n */\nexport function camelCase(text: string, { isFile, prefix = '', suffix = '' }: Options = {}): string {\n  if (isFile) {\n    return applyToFileParts(text, (part, isLast) => camelCase(part, isLast ? { prefix, suffix } : {}))\n  }\n\n  return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false)\n}\n\n/**\n * Converts `text` to PascalCase.\n * When `isFile` is `true`, the last dot-separated segment is PascalCased and earlier segments are camelCased.\n *\n * @example\n * pascalCase('hello-world')                  // 'HelloWorld'\n * pascalCase('pet.petId', { isFile: true })  // 'pet/PetId'\n */\nexport function pascalCase(text: string, { isFile, prefix = '', suffix = '' }: Options = {}): string {\n  if (isFile) {\n    return applyToFileParts(text, (part, isLast) => (isLast ? pascalCase(part, { prefix, suffix }) : camelCase(part)))\n  }\n\n  return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true)\n}\n\n/**\n * Converts `text` to snake_case.\n *\n * @example\n * snakeCase('helloWorld')  // 'hello_world'\n * snakeCase('Hello-World') // 'hello_world'\n */\nexport function snakeCase(text: string, { prefix = '', suffix = '' }: Omit<Options, 'isFile'> = {}): string {\n  const processed = `${prefix} ${text} ${suffix}`.trim()\n  return processed\n    .replace(/([a-z])([A-Z])/g, '$1_$2')\n    .replace(/[\\s\\-.]+/g, '_')\n    .replace(/[^a-zA-Z0-9_]/g, '')\n    .toLowerCase()\n    .split('_')\n    .filter(Boolean)\n    .join('_')\n}\n\n/**\n * Converts `text` to SCREAMING_SNAKE_CASE.\n *\n * @example\n * screamingSnakeCase('helloWorld') // 'HELLO_WORLD'\n */\nexport function screamingSnakeCase(text: string, { prefix = '', suffix = '' }: Omit<Options, 'isFile'> = {}): string {\n  return snakeCase(text, { prefix, suffix }).toUpperCase()\n}\n","/**\n * JavaScript and Java reserved words.\n * @link https://github.com/jonschlinkert/reserved/blob/master/index.js\n */\nconst reservedWords = new Set([\n  'abstract',\n  'arguments',\n  'boolean',\n  'break',\n  'byte',\n  'case',\n  'catch',\n  'char',\n  'class',\n  'const',\n  'continue',\n  'debugger',\n  'default',\n  'delete',\n  'do',\n  'double',\n  'else',\n  'enum',\n  'eval',\n  'export',\n  'extends',\n  'false',\n  'final',\n  'finally',\n  'float',\n  'for',\n  'function',\n  'goto',\n  'if',\n  'implements',\n  'import',\n  'in',\n  'instanceof',\n  'int',\n  'interface',\n  'let',\n  'long',\n  'native',\n  'new',\n  'null',\n  'package',\n  'private',\n  'protected',\n  'public',\n  'return',\n  'short',\n  'static',\n  'super',\n  'switch',\n  'synchronized',\n  'this',\n  'throw',\n  'throws',\n  'transient',\n  'true',\n  'try',\n  'typeof',\n  'var',\n  'void',\n  'volatile',\n  'while',\n  'with',\n  'yield',\n  'Array',\n  'Date',\n  'hasOwnProperty',\n  'Infinity',\n  'isFinite',\n  'isNaN',\n  'isPrototypeOf',\n  'length',\n  'Math',\n  'name',\n  'NaN',\n  'Number',\n  'Object',\n  'prototype',\n  'String',\n  'toString',\n  'undefined',\n  'valueOf',\n] as const)\n\n/**\n * Returns `true` when `name` is a syntactically valid JavaScript variable name.\n *\n * @example\n * ```ts\n * isValidVarName('status')  // true\n * isValidVarName('class')   // false (reserved word)\n * isValidVarName('42foo')   // false (starts with digit)\n * ```\n */\nexport function isValidVarName(name: string): boolean {\n  if (!name || reservedWords.has(name as 'valueOf')) {\n    return false\n  }\n  return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name)\n}\n","import { camelCase } from './casing.ts'\nimport { isValidVarName } from './reserved.ts'\n\nexport type URLObject = {\n  /**\n   * The resolved URL string (Express-style or template literal, depending on context).\n   */\n  url: string\n  /**\n   * Extracted path parameters as a key-value map, or `undefined` when the path has none.\n   */\n  params?: Record<string, string>\n}\n\ntype ObjectOptions = {\n  /**\n   * Controls whether the `url` is rendered as an Express path or a template literal.\n   * @default 'path'\n   */\n  type?: 'path' | 'template'\n  /**\n   * Optional transform applied to each extracted parameter name.\n   */\n  replacer?: (pathParam: string) => string\n  /**\n   * When `true`, the result is serialized to a string expression instead of a plain object.\n   */\n  stringify?: boolean\n}\n\n/**\n * Supported identifier casing strategies for path parameters.\n */\ntype PathCasing = 'camelcase'\n\ntype Options = {\n  /**\n   * Casing strategy applied to path parameter names.\n   * @default undefined (original identifier preserved)\n   */\n  casing?: PathCasing\n}\n\n/**\n * Parses and transforms an OpenAPI/Swagger path string into various URL formats.\n *\n * @example\n * const p = new URLPath('/pet/{petId}')\n * p.URL      // '/pet/:petId'\n * p.template // '`/pet/${petId}`'\n */\nexport class URLPath {\n  /**\n   * The raw OpenAPI/Swagger path string, e.g. `/pet/{petId}`.\n   */\n  path: string\n\n  #options: Options\n\n  constructor(path: string, options: Options = {}) {\n    this.path = path\n    this.#options = options\n  }\n\n  /** Converts the OpenAPI path to Express-style colon syntax, e.g. `/pet/{petId}` → `/pet/:petId`.\n   *\n   * @example\n   * ```ts\n   * new URLPath('/pet/{petId}').URL // '/pet/:petId'\n   * ```\n   */\n  get URL(): string {\n    return this.toURLPath()\n  }\n\n  /** Returns `true` when `path` is a fully-qualified URL (e.g. starts with `https://`).\n   *\n   * @example\n   * ```ts\n   * new URLPath('https://petstore.swagger.io/v2/pet').isURL // true\n   * new URLPath('/pet/{petId}').isURL                       // false\n   * ```\n   */\n  get isURL(): boolean {\n    try {\n      return !!new URL(this.path).href\n    } catch {\n      return false\n    }\n  }\n\n  /**\n   * Converts the OpenAPI path to a TypeScript template literal string.\n   *\n   * @example\n   * new URLPath('/pet/{petId}').template              // '`/pet/${petId}`'\n   * new URLPath('/account/monetary-accountID').template // '`/account/${monetaryAccountId}`'\n   */\n  get template(): string {\n    return this.toTemplateString()\n  }\n\n  /** Returns the path and its extracted params as a structured `URLObject`, or as a stringified expression when `stringify` is set.\n   *\n   * @example\n   * ```ts\n   * new URLPath('/pet/{petId}').object\n   * // { url: '/pet/:petId', params: { petId: 'petId' } }\n   * ```\n   */\n  get object(): URLObject | string {\n    return this.toObject()\n  }\n\n  /** Returns a map of path parameter names, or `undefined` when the path has no parameters.\n   *\n   * @example\n   * ```ts\n   * new URLPath('/pet/{petId}').params // { petId: 'petId' }\n   * new URLPath('/pet').params         // undefined\n   * ```\n   */\n  get params(): Record<string, string> | undefined {\n    return this.getParams()\n  }\n\n  #transformParam(raw: string): string {\n    const param = isValidVarName(raw) ? raw : camelCase(raw)\n    return this.#options.casing === 'camelcase' ? camelCase(param) : param\n  }\n\n  /**\n   * Iterates over every `{param}` token in `path`, calling `fn` with the raw token and transformed name.\n   */\n  #eachParam(fn: (raw: string, param: string) => void): void {\n    for (const match of this.path.matchAll(/\\{([^}]+)\\}/g)) {\n      const raw = match[1]!\n      fn(raw, this.#transformParam(raw))\n    }\n  }\n\n  toObject({ type = 'path', replacer, stringify }: ObjectOptions = {}): URLObject | string {\n    const object = {\n      url: type === 'path' ? this.toURLPath() : this.toTemplateString({ replacer }),\n      params: this.getParams(),\n    }\n\n    if (stringify) {\n      if (type === 'template') {\n        return JSON.stringify(object).replaceAll(\"'\", '').replaceAll(`\"`, '')\n      }\n\n      if (object.params) {\n        return `{ url: '${object.url}', params: ${JSON.stringify(object.params).replaceAll(\"'\", '').replaceAll(`\"`, '')} }`\n      }\n\n      return `{ url: '${object.url}' }`\n    }\n\n    return object\n  }\n\n  /**\n   * Converts the OpenAPI path to a TypeScript template literal string.\n   * An optional `replacer` can transform each extracted parameter name before interpolation.\n   *\n   * @example\n   * new URLPath('/pet/{petId}').toTemplateString() // '`/pet/${petId}`'\n   */\n  toTemplateString({ prefix = '', replacer }: { prefix?: string; replacer?: (pathParam: string) => string } = {}): string {\n    const parts = this.path.split(/\\{([^}]+)\\}/)\n    const result = parts\n      .map((part, i) => {\n        if (i % 2 === 0) return part\n        const param = this.#transformParam(part)\n        return `\\${${replacer ? replacer(param) : param}}`\n      })\n      .join('')\n\n    return `\\`${prefix}${result}\\``\n  }\n\n  /**\n   * Extracts all `{param}` segments from the path and returns them as a key-value map.\n   * An optional `replacer` transforms each parameter name in both key and value positions.\n   * Returns `undefined` when no path parameters are found.\n   *\n   * @example\n   * ```ts\n   * new URLPath('/pet/{petId}/tag/{tagId}').getParams()\n   * // { petId: 'petId', tagId: 'tagId' }\n   * ```\n   */\n  getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined {\n    const params: Record<string, string> = {}\n\n    this.#eachParam((_raw, param) => {\n      const key = replacer ? replacer(param) : param\n      params[key] = key\n    })\n\n    return Object.keys(params).length > 0 ? params : undefined\n  }\n\n  /** Converts the OpenAPI path to Express-style colon syntax.\n   *\n   * @example\n   * ```ts\n   * new URLPath('/pet/{petId}').toURLPath() // '/pet/:petId'\n   * ```\n   */\n  toURLPath(): string {\n    return this.path.replace(/\\{([^}]+)\\}/g, ':$1')\n  }\n}\n","import { camelCase } from '@internals/utils'\nimport type { ast } from '@kubb/core'\n\n/**\n * Find the first 2xx response status code from an operation's responses.\n */\nexport function findSuccessStatusCode(responses: Array<{ statusCode: number | string }>): ast.StatusCode | undefined {\n  for (const res of responses) {\n    const code = Number(res.statusCode)\n    if (code >= 200 && code < 300) {\n      return res.statusCode as ast.StatusCode\n    }\n  }\n  return undefined\n}\n\nexport type ZodParam = {\n  name: string\n  schemaName: string\n}\n\n/**\n * Render a group param value — compose individual schemas into `z.object({ ... })`,\n * or use a schema name string directly.\n */\nexport function zodGroupExpr(entry: string | Array<ZodParam>): string {\n  if (typeof entry === 'string') {\n    return entry\n  }\n  const entries = entry.map((p) => `${JSON.stringify(p.name)}: ${p.schemaName}`)\n  return `z.object({ ${entries.join(', ')} })`\n}\n\n/**\n * Build JSDoc comment lines from an OperationNode.\n */\nexport function getComments(node: ast.OperationNode): Array<string> {\n  return [\n    node.description && `@description ${node.description}`,\n    node.summary && `@summary ${node.summary}`,\n    node.deprecated && '@deprecated',\n    `{@link ${node.path.replaceAll('{', ':').replaceAll('}', '')}}`,\n  ].filter((x): x is string => Boolean(x))\n}\n\n/**\n * Build a mapping of original param names → camelCase names.\n * Returns `undefined` when no names actually change (no remapping needed).\n */\nexport function getParamsMapping(params: Array<{ name: string }>): Record<string, string> | undefined {\n  if (!params.length) {\n    return undefined\n  }\n\n  const mapping: Record<string, string> = {}\n  let hasDifference = false\n\n  for (const p of params) {\n    const camelName = camelCase(p.name)\n    mapping[p.name] = camelName\n    if (p.name !== camelName) {\n      hasDifference = true\n    }\n  }\n\n  return hasDifference ? mapping : undefined\n}\n\n/**\n * Convert a SchemaNode type to an inline Zod expression string.\n * Used as fallback when no named zod schema is available for a path parameter.\n */\nexport function zodExprFromSchemaNode(schema: ast.SchemaNode): string {\n  let expr: string\n  switch (schema.type) {\n    case 'enum': {\n      // namedEnumValues takes priority over enumValues\n      const rawValues: Array<string | number | boolean> = schema.namedEnumValues?.length\n        ? schema.namedEnumValues.map((v) => v.value)\n        : (schema.enumValues ?? []).filter((v): v is string | number | boolean => v !== null)\n\n      if (rawValues.length > 0 && rawValues.every((v) => typeof v === 'string')) {\n        expr = `z.enum([${rawValues.map((v) => JSON.stringify(v)).join(', ')}])`\n      } else if (rawValues.length > 0) {\n        const literals = rawValues.map((v) => `z.literal(${JSON.stringify(v)})`)\n        expr = literals.length === 1 ? literals[0]! : `z.union([${literals.join(', ')}])`\n      } else {\n        expr = 'z.string()'\n      }\n      break\n    }\n    case 'integer':\n      expr = 'z.coerce.number()'\n      break\n    case 'number':\n      expr = 'z.number()'\n      break\n    case 'boolean':\n      expr = 'z.boolean()'\n      break\n    case 'array':\n      expr = 'z.array(z.unknown())'\n      break\n    default:\n      expr = 'z.string()'\n  }\n\n  if (schema.nullable) {\n    expr = `${expr}.nullable()`\n  }\n\n  return expr\n}\n","import { isValidVarName, URLPath } from '@internals/utils'\nimport { ast } from '@kubb/core'\nimport type { ResolverTs } from '@kubb/plugin-ts'\nimport { functionPrinter } from '@kubb/plugin-ts'\nimport { File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx/types'\nimport type { PluginMcp } from '../types.ts'\nimport { getComments, getParamsMapping } from '../utils.ts'\n\ntype Props = {\n  /**\n   * Name of the handler function.\n   */\n  name: string\n  /**\n   * AST operation node.\n   */\n  node: ast.OperationNode\n  /**\n   * TypeScript resolver for resolving param/data/response type names.\n   */\n  resolver: ResolverTs\n  /**\n   * Base URL prepended to every generated request URL.\n   */\n  baseURL: string | undefined\n  /**\n   * Return type when calling fetch.\n   * - 'data' returns response data only.\n   * - 'full' returns the full response object.\n   * @default 'data'\n   */\n  dataReturnType: PluginMcp['resolvedOptions']['client']['dataReturnType']\n  /**\n   * How to style your params.\n   */\n  paramsCasing?: PluginMcp['resolvedOptions']['paramsCasing']\n}\n\n/**\n * Generate a remapping statement: `const mappedX = x ? { \"orig\": x.camel, ... } : undefined`\n */\nfunction buildRemappingCode(mapping: Record<string, string>, varName: string, sourceName: string): string {\n  const pairs = Object.entries(mapping)\n    .map(([orig, camel]) => `\"${orig}\": ${sourceName}.${camel}`)\n    .join(', ')\n  return `const ${varName} = ${sourceName} ? { ${pairs} } : undefined`\n}\n\nconst declarationPrinter = functionPrinter({ mode: 'declaration' })\n\nexport function McpHandler({ name, node, resolver, baseURL, dataReturnType, paramsCasing }: Props): KubbReactNode {\n  const urlPath = new URLPath(node.path)\n  const contentType = node.requestBody?.content?.[0]?.contentType\n  const isFormData = contentType === 'multipart/form-data'\n\n  const casedParams = ast.caseParams(node.parameters, paramsCasing)\n  const queryParams = casedParams.filter((p) => p.in === 'query')\n  const headerParams = casedParams.filter((p) => p.in === 'header')\n\n  // Use original (uncased) parameters for mapping so original→camelCase difference is detected\n  const originalPathParams = node.parameters.filter((p) => p.in === 'path')\n  const originalQueryParams = node.parameters.filter((p) => p.in === 'query')\n  const originalHeaderParams = node.parameters.filter((p) => p.in === 'header')\n\n  const requestName = node.requestBody?.content?.[0]?.schema ? resolver.resolveDataName(node) : undefined\n  const responseName = resolver.resolveResponseName(node)\n\n  const errorResponses = node.responses.filter((r) => Number(r.statusCode) >= 400).map((r) => resolver.resolveResponseStatusName(node, r.statusCode))\n  const errorType = errorResponses.length > 0 ? errorResponses.join(' | ') : 'Error'\n\n  const TError = `ResponseErrorConfig<${errorType}>`\n  const generics = [responseName, TError, requestName || 'unknown'].filter(Boolean)\n\n  const paramsNode = ast.createOperationParams(node, {\n    paramsType: 'object',\n    pathParamsType: 'inline',\n    resolver,\n    paramsCasing,\n  })\n  const baseParamsSignature = declarationPrinter.print(paramsNode) ?? ''\n  const paramsSignature = baseParamsSignature\n    ? `${baseParamsSignature}, request: RequestHandlerExtra<ServerRequest, ServerNotification>`\n    : 'request: RequestHandlerExtra<ServerRequest, ServerNotification>'\n\n  const pathParamsMapping = paramsCasing ? getParamsMapping(originalPathParams) : undefined\n  const queryParamsMapping = paramsCasing ? getParamsMapping(originalQueryParams) : undefined\n  const headerParamsMapping = paramsCasing ? getParamsMapping(originalHeaderParams) : undefined\n\n  const contentTypeHeader =\n    contentType && contentType !== 'application/json' && contentType !== 'multipart/form-data' ? `'Content-Type': '${contentType}'` : undefined\n  const headers = [headerParams.length ? (headerParamsMapping ? '...mappedHeaders' : '...headers') : undefined, contentTypeHeader].filter(Boolean)\n\n  const fetchConfig: string[] = []\n  fetchConfig.push(`method: ${JSON.stringify(node.method.toUpperCase())}`)\n  fetchConfig.push(`url: ${urlPath.template}`)\n  if (baseURL) fetchConfig.push(`baseURL: \\`${baseURL}\\``)\n  if (queryParams.length) fetchConfig.push(queryParamsMapping ? 'params: mappedParams' : 'params')\n  if (requestName) fetchConfig.push(`data: ${isFormData ? 'formData as FormData' : 'requestData'}`)\n  if (headers.length) fetchConfig.push(`headers: { ${headers.join(', ')} }`)\n\n  const callToolResult =\n    dataReturnType === 'data'\n      ? `return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(res.data)\n              }\n            ],\n            structuredContent: { data: res.data }\n           }`\n      : `return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(res)\n              }\n            ],\n            structuredContent: { data: res.data }\n           }`\n\n  return (\n    <File.Source name={name} isExportable isIndexable>\n      <Function\n        name={name}\n        async\n        export\n        params={paramsSignature}\n        JSDoc={{\n          comments: getComments(node),\n        }}\n        returnType={'Promise<CallToolResult>'}\n      >\n        {''}\n        <br />\n        <br />\n        {pathParamsMapping &&\n          Object.entries(pathParamsMapping)\n            .filter(([originalName, camelCaseName]) => originalName !== camelCaseName && isValidVarName(originalName))\n            .map(([originalName, camelCaseName]) => `const ${originalName} = ${camelCaseName}`)\n            .join('\\n')}\n        {pathParamsMapping && (\n          <>\n            <br />\n            <br />\n          </>\n        )}\n        {queryParamsMapping && queryParams.length > 0 && (\n          <>\n            {buildRemappingCode(queryParamsMapping, 'mappedParams', 'params')}\n            <br />\n            <br />\n          </>\n        )}\n        {headerParamsMapping && headerParams.length > 0 && (\n          <>\n            {buildRemappingCode(headerParamsMapping, 'mappedHeaders', 'headers')}\n            <br />\n            <br />\n          </>\n        )}\n        {requestName && 'const requestData = data'}\n        <br />\n        {isFormData && requestName && 'const formData = buildFormData(requestData)'}\n        <br />\n        {`const res = await fetch<${generics.join(', ')}>({ ${fetchConfig.join(', ')} }, request)`}\n        <br />\n        {callToolResult}\n      </Function>\n    </File.Source>\n  )\n}\n","import { ast } from '@kubb/core'\nimport { functionPrinter } from '@kubb/plugin-ts'\nimport { Const, File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx/types'\nimport type { PluginMcp } from '../types.ts'\nimport type { ZodParam } from '../utils.ts'\nimport { zodExprFromSchemaNode, zodGroupExpr } from '../utils.ts'\n\ntype Props = {\n  /**\n   * Variable name for the MCP server instance (e.g. 'server').\n   */\n  name: string\n  /**\n   * Human-readable server name passed to `new McpServer({ name })`.\n   */\n  serverName: string\n  /**\n   * Semantic version string passed to `new McpServer({ version })`.\n   */\n  serverVersion: string\n  /**\n   * How to style your params.\n   */\n  paramsCasing?: PluginMcp['resolvedOptions']['paramsCasing']\n  /**\n   * Operations to register as MCP tools, each carrying its handler,\n   * zod schema, and AST node metadata.\n   */\n  operations: Array<{\n    tool: {\n      name: string\n      title?: string\n      description: string\n    }\n    mcp: {\n      name: string\n      file: ast.FileNode\n    }\n    zod: {\n      pathParams: Array<ZodParam>\n      /**\n       * Query params — individual schemas to compose into `z.object({ ... })`.\n       */\n      queryParams?: string | Array<ZodParam>\n      /**\n       * Header params — individual schemas to compose into `z.object({ ... })`.\n       */\n      headerParams?: string | Array<ZodParam>\n      requestName?: string\n      responseName?: string\n    }\n    node: ast.OperationNode\n  }>\n}\n\nconst keysPrinter = functionPrinter({ mode: 'keys' })\n\nexport function Server({ name, serverName, serverVersion, paramsCasing, operations }: Props): KubbReactNode {\n  return (\n    <File.Source name={name} isExportable isIndexable>\n      <Const name={'server'} export>\n        {`\n          new McpServer({\n  name: '${serverName}',\n  version: '${serverVersion}',\n})\n          `}\n      </Const>\n\n      {operations\n        .map(({ tool, mcp, zod, node }) => {\n          const casedParams = ast.caseParams(node.parameters, paramsCasing)\n          const pathParams = casedParams.filter((p) => p.in === 'path')\n\n          const pathEntries: Array<{ key: string; value: string }> = []\n          const otherEntries: Array<{ key: string; value: string }> = []\n\n          for (const p of pathParams) {\n            const zodParam = zod.pathParams.find((zp) => zp.name === p.name)\n            pathEntries.push({ key: p.name, value: zodParam ? zodParam.schemaName : zodExprFromSchemaNode(p.schema) })\n          }\n\n          if (zod.requestName) {\n            otherEntries.push({ key: 'data', value: zod.requestName })\n          }\n\n          if (zod.queryParams) {\n            otherEntries.push({ key: 'params', value: zodGroupExpr(zod.queryParams) })\n          }\n\n          if (zod.headerParams) {\n            otherEntries.push({ key: 'headers', value: zodGroupExpr(zod.headerParams) })\n          }\n\n          otherEntries.sort((a, b) => a.key.localeCompare(b.key))\n          const entries = [...pathEntries, ...otherEntries]\n\n          const paramsNode = entries.length\n            ? ast.createFunctionParameters({\n                params: [\n                  ast.createParameterGroup({\n                    properties: entries.map((e) => ast.createFunctionParameter({ name: e.key, optional: false })),\n                  }),\n                ],\n              })\n            : undefined\n\n          const destructured = paramsNode ? (keysPrinter.print(paramsNode) ?? '') : ''\n          const inputSchema = entries.length ? `{ ${entries.map((e) => `${e.key}: ${e.value}`).join(', ')} }` : undefined\n          const outputSchema = zod.responseName\n\n          const config = [\n            tool.title ? `title: ${JSON.stringify(tool.title)}` : null,\n            `description: ${JSON.stringify(tool.description)}`,\n            outputSchema ? `outputSchema: { data: ${outputSchema} }` : null,\n          ]\n            .filter(Boolean)\n            .join(',\\n  ')\n\n          if (inputSchema) {\n            return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n  ${config},\n  inputSchema: ${inputSchema},\n}, async (${destructured}, request) => {\n  return ${mcp.name}(${destructured}, request)\n})\n          `\n          }\n\n          return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n  ${config},\n}, async (request) => {\n  return ${mcp.name}(request)\n})\n          `\n        })\n        .filter(Boolean)}\n\n      <Function name=\"startServer\" async export>\n        {`try {\n    const transport = new StdioServerTransport()\n    await server.connect(transport)\n\n  } catch (error) {\n    console.error('Failed to start server:', error)\n    process.exit(1)\n  }`}\n      </Function>\n    </File.Source>\n  )\n}\n","import path from 'node:path'\nimport { ast, defineGenerator } from '@kubb/core'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { McpHandler } from '../components/McpHandler.tsx'\nimport type { PluginMcp } from '../types.ts'\n\nexport const mcpGenerator = defineGenerator<PluginMcp>({\n  name: 'mcp',\n  renderer: jsxRenderer,\n  operation(node, ctx) {\n    const { resolver, driver, root } = ctx\n    const { output, client, paramsCasing, group } = ctx.options\n\n    const pluginTs = driver.getPlugin(pluginTsName)\n\n    if (!pluginTs) {\n      return null\n    }\n\n    const tsResolver = driver.getResolver(pluginTsName)\n\n    const casedParams = ast.caseParams(node.parameters, paramsCasing)\n\n    const pathParams = casedParams.filter((p) => p.in === 'path')\n    const queryParams = casedParams.filter((p) => p.in === 'query')\n    const headerParams = casedParams.filter((p) => p.in === 'header')\n\n    const importedTypeNames = [\n      ...pathParams.map((p) => tsResolver.resolvePathParamsName(node, p)),\n      ...queryParams.map((p) => tsResolver.resolveQueryParamsName(node, p)),\n      ...headerParams.map((p) => tsResolver.resolveHeaderParamsName(node, p)),\n      node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : undefined,\n      tsResolver.resolveResponseName(node),\n      ...node.responses.filter((r) => Number(r.statusCode) >= 400).map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode)),\n    ].filter(Boolean)\n\n    const meta = {\n      name: resolver.resolveName(node.operationId),\n      file: resolver.resolveFile({ name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path }, { root, output, group }),\n      fileTs: tsResolver.resolveFile(\n        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },\n        {\n          root,\n          output: pluginTs.options?.output ?? output,\n          group: pluginTs.options?.group,\n        },\n      ),\n    } as const\n\n    return (\n      <File baseName={meta.file.baseName} path={meta.file.path} meta={meta.file.meta}>\n        {meta.fileTs && importedTypeNames.length > 0 && (\n          <File.Import name={Array.from(new Set(importedTypeNames)).sort()} root={meta.file.path} path={meta.fileTs.path} isTypeOnly />\n        )}\n        <File.Import name={['CallToolResult', 'ServerNotification', 'ServerRequest']} path={'@modelcontextprotocol/sdk/types'} isTypeOnly />\n        <File.Import name={['RequestHandlerExtra']} path={'@modelcontextprotocol/sdk/shared/protocol'} isTypeOnly />\n        <File.Import name={['buildFormData']} root={meta.file.path} path={path.resolve(root, '.kubb/config.ts')} />\n        {client.importPath ? (\n          <>\n            <File.Import name={['Client', 'RequestConfig', 'ResponseErrorConfig']} path={client.importPath} isTypeOnly />\n            <File.Import name={'fetch'} path={client.importPath} />\n            {client.dataReturnType === 'full' && <File.Import name={['ResponseConfig']} path={client.importPath} isTypeOnly />}\n          </>\n        ) : (\n          <>\n            <File.Import\n              name={['Client', 'RequestConfig', 'ResponseErrorConfig']}\n              root={meta.file.path}\n              path={path.resolve(root, '.kubb/fetch.ts')}\n              isTypeOnly\n            />\n            <File.Import name={['fetch']} root={meta.file.path} path={path.resolve(root, '.kubb/fetch.ts')} />\n            {client.dataReturnType === 'full' && (\n              <File.Import name={['ResponseConfig']} root={meta.file.path} path={path.resolve(root, '.kubb/fetch.ts')} isTypeOnly />\n            )}\n          </>\n        )}\n\n        <McpHandler\n          name={meta.name}\n          node={node}\n          resolver={tsResolver}\n          baseURL={client.baseURL}\n          dataReturnType={client.dataReturnType || 'data'}\n          paramsCasing={paramsCasing}\n        />\n      </File>\n    )\n  },\n})\n","import path from 'node:path'\nimport { ast, defineGenerator } from '@kubb/core'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { Server } from '../components/Server.tsx'\nimport type { PluginMcp } from '../types.ts'\nimport { findSuccessStatusCode } from '../utils.ts'\n\n/**\n * Default v5 server generator for `@kubb/plugin-mcp`.\n *\n * Uses individual zod schemas for each param (e.g. `createPetsPathUuidSchema`, `createPetsQueryOffsetSchema`)\n * and `resolveResponseStatusName` for per-status response schemas.\n * Query and header params are composed into `z.object({ ... })` from individual schemas.\n */\nexport const serverGenerator = defineGenerator<PluginMcp>({\n  name: 'operations',\n  renderer: jsxRenderer,\n  operations(nodes, ctx) {\n    const { adapter, config, resolver, plugin, driver, root } = ctx\n    const { output, paramsCasing, group } = ctx.options\n\n    const pluginZod = driver.getPlugin(pluginZodName)\n\n    if (!pluginZod) {\n      return\n    }\n\n    const zodResolver = driver.getResolver(pluginZodName)\n\n    const name = 'server'\n    const serverFilePath = path.resolve(root, output.path, 'server.ts')\n    const serverFile = {\n      baseName: 'server.ts' as const,\n      path: serverFilePath,\n      meta: { pluginName: plugin.name },\n    }\n\n    const jsonFilePath = path.resolve(root, output.path, '.mcp.json')\n    const jsonFile = {\n      baseName: '.mcp.json' as const,\n      path: jsonFilePath,\n      meta: { pluginName: plugin.name },\n    }\n\n    const operationsMapped = nodes.map((node) => {\n      const casedParams = ast.caseParams(node.parameters, paramsCasing)\n      const pathParams = casedParams.filter((p) => p.in === 'path')\n      const queryParams = casedParams.filter((p) => p.in === 'query')\n      const headerParams = casedParams.filter((p) => p.in === 'header')\n\n      const mcpFile = resolver.resolveFile({ name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path }, { root, output, group })\n\n      const zodFile = zodResolver.resolveFile(\n        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },\n        {\n          root,\n          output: pluginZod.options?.output ?? output,\n          group: pluginZod.options?.group,\n        },\n      )\n\n      const requestName = node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName(node) : undefined\n      const successStatus = findSuccessStatusCode(node.responses)\n      const responseName = successStatus ? zodResolver.resolveResponseStatusName(node, successStatus) : undefined\n\n      const resolveParams = (params: typeof pathParams) => params.map((p) => ({ name: p.name, schemaName: zodResolver.resolveParamName(node, p) }))\n\n      return {\n        tool: {\n          name: node.operationId,\n          title: node.summary || undefined,\n          description: node.description || `Make a ${node.method.toUpperCase()} request to ${node.path}`,\n        },\n        mcp: {\n          name: resolver.resolveName(node.operationId),\n          file: mcpFile,\n        },\n        zod: {\n          pathParams: resolveParams(pathParams),\n          queryParams: queryParams.length ? resolveParams(queryParams) : undefined,\n          headerParams: headerParams.length ? resolveParams(headerParams) : undefined,\n          requestName,\n          responseName,\n          file: zodFile,\n        },\n        node: node,\n      }\n    })\n\n    const imports = operationsMapped.flatMap(({ mcp, zod }) => {\n      const zodNames = [\n        ...zod.pathParams.map((p) => p.schemaName),\n        ...(zod.queryParams ?? []).map((p) => p.schemaName),\n        ...(zod.headerParams ?? []).map((p) => p.schemaName),\n        zod.requestName,\n        zod.responseName,\n      ].filter(Boolean)\n\n      const uniqueNames = [...new Set(zodNames)].sort()\n\n      return [\n        <File.Import key={mcp.name} name={[mcp.name]} root={serverFile.path} path={mcp.file.path} />,\n        uniqueNames.length > 0 && <File.Import key={`zod-${mcp.name}`} name={uniqueNames} root={serverFile.path} path={zod.file.path} />,\n      ].filter(Boolean)\n    })\n\n    return (\n      <>\n        <File\n          baseName={serverFile.baseName}\n          path={serverFile.path}\n          meta={serverFile.meta}\n          banner={resolver.resolveBanner(adapter.inputNode, { output, config })}\n          footer={resolver.resolveFooter(adapter.inputNode, { output, config })}\n        >\n          <File.Import name={['McpServer']} path={'@modelcontextprotocol/sdk/server/mcp'} />\n          <File.Import name={['z']} path={'zod'} />\n          <File.Import name={['StdioServerTransport']} path={'@modelcontextprotocol/sdk/server/stdio'} />\n\n          {imports}\n          <Server\n            name={name}\n            serverName={adapter.inputNode?.meta?.title ?? 'server'}\n            serverVersion={adapter.inputNode?.meta?.version ?? '0.0.0'}\n            paramsCasing={paramsCasing}\n            operations={operationsMapped}\n          />\n        </File>\n\n        <File baseName={jsonFile.baseName} path={jsonFile.path} meta={jsonFile.meta}>\n          <File.Source name={name}>\n            {`\n          {\n            \"mcpServers\": {\n              \"${adapter.inputNode?.meta?.title || 'server'}\": {\n                \"type\": \"stdio\",\n                \"command\": \"npx\",\n                \"args\": [\"tsx\", \"${path.relative(path.dirname(jsonFile.path), serverFile.path)}\"]\n              }\n            }\n          }\n          `}\n          </File.Source>\n        </File>\n      </>\n    )\n  },\n})\n","import { camelCase } from '@internals/utils'\nimport { defineResolver } from '@kubb/core'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Naming convention resolver for MCP plugin.\n *\n * Provides default naming helpers using camelCase with a `handler` suffix for functions.\n *\n * @example\n * `resolverMcp.default('addPet', 'function')  // → 'addPetHandler'`\n */\nexport const resolverMcp = defineResolver<PluginMcp>((ctx) => ({\n  name: 'default',\n  pluginName: 'plugin-mcp',\n  default(name, type) {\n    if (type === 'file') {\n      return camelCase(name, { isFile: true })\n    }\n    return camelCase(name, { suffix: 'handler' })\n  },\n  resolveName(name) {\n    return ctx.default(name, 'function')\n  },\n}))\n","import path from 'node:path'\nimport { camelCase } from '@internals/utils'\n\nimport { ast, definePlugin, type Group } from '@kubb/core'\nimport { pluginClientName } from '@kubb/plugin-client'\nimport { source as axiosClientSource } from '@kubb/plugin-client/templates/clients/axios.source'\nimport { source as fetchClientSource } from '@kubb/plugin-client/templates/clients/fetch.source'\nimport { source as configSource } from '@kubb/plugin-client/templates/config.source'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mcpGenerator } from './generators/mcpGenerator.tsx'\nimport { serverGenerator } from './generators/serverGenerator.tsx'\nimport { resolverMcp } from './resolvers/resolverMcp.ts'\nimport type { PluginMcp } from './types.ts'\n\nexport const pluginMcpName = 'plugin-mcp' satisfies PluginMcp['name']\n\nexport const pluginMcp = definePlugin<PluginMcp>((options) => {\n  const {\n    output = { path: 'mcp', barrelType: 'named' },\n    group,\n    exclude = [],\n    include,\n    override = [],\n    paramsCasing,\n    client,\n    resolver: userResolver,\n    transformer: userTransformer,\n    generators: userGenerators = [],\n  } = options\n\n  const clientName = client?.client ?? 'axios'\n  const clientImportPath = client?.importPath ?? (!client?.bundle ? `@kubb/plugin-client/clients/${clientName}` : undefined)\n\n  const groupConfig = group\n    ? ({\n        ...group,\n        name: group.name\n          ? group.name\n          : (ctx: { group: string }) => {\n              if (group.type === 'path') {\n                return `${ctx.group.split('/')[1]}`\n              }\n              return `${camelCase(ctx.group)}Requests`\n            },\n      } satisfies Group)\n    : undefined\n\n  return {\n    name: pluginMcpName,\n    options,\n    dependencies: [pluginTsName, pluginZodName],\n    hooks: {\n      'kubb:plugin:setup'(ctx) {\n        const resolver = userResolver ? { ...resolverMcp, ...userResolver } : resolverMcp\n\n        ctx.setOptions({\n          output,\n          exclude,\n          include,\n          override,\n          group: groupConfig,\n          paramsCasing,\n          client: {\n            client: clientName,\n            clientType: client?.clientType ?? 'function',\n            importPath: clientImportPath,\n            dataReturnType: client?.dataReturnType ?? 'data',\n            bundle: client?.bundle,\n            baseURL: client?.baseURL,\n            paramsCasing: client?.paramsCasing,\n          },\n          resolver,\n        })\n        ctx.setResolver(resolver)\n        if (userTransformer) {\n          ctx.setTransformer(userTransformer)\n        }\n        ctx.addGenerator(mcpGenerator)\n        ctx.addGenerator(serverGenerator)\n        for (const gen of userGenerators) {\n          ctx.addGenerator(gen)\n        }\n\n        const root = path.resolve(ctx.config.root, ctx.config.output.path)\n        const hasClientPlugin = ctx.config.plugins?.some((p) => p.name === pluginClientName)\n\n        if (client?.bundle && !hasClientPlugin && !clientImportPath) {\n          ctx.injectFile({\n            baseName: 'fetch.ts',\n            path: path.resolve(root, '.kubb/fetch.ts'),\n            sources: [\n              ast.createSource({\n                name: 'fetch',\n                nodes: [ast.createText(clientName === 'fetch' ? fetchClientSource : axiosClientSource)],\n                isExportable: true,\n                isIndexable: true,\n              }),\n            ],\n          })\n        }\n\n        if (!hasClientPlugin) {\n          ctx.injectFile({\n            baseName: 'config.ts',\n            path: path.resolve(root, '.kubb/config.ts'),\n            sources: [\n              ast.createSource({\n                name: 'config',\n                nodes: [ast.createText(configSource)],\n                isExportable: false,\n                isIndexable: false,\n              }),\n            ],\n          })\n        }\n      },\n    },\n  }\n})\n\nexport default pluginMcp\n"],"mappings":"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"}

package/extension.yaml

@@ -0,0 +1,470 @@
+$schema: https://kubb.dev/schemas/extension.json
+kind: plugin
+id: plugin-mcp
+name: MCP
+description: Generate Model Context Protocol (MCP) servers from OpenAPI specifications for AI assistants to call your API.
+category: ai
+type: official
+npmPackage: "@kubb/plugin-mcp"
+docsPath: /plugins/plugin-mcp
+repo: https://github.com/kubb-labs/plugins
+maintainers:
+  - name: Stijn Van Hulle
+    github: stijnvanhulle
+compatibility:
+  kubb: ">=5.0.0"
+  node: ">=22"
+tags:
+  - mcp
+  - model-context-protocol
+  - ai
+  - claude
+  - llm
+  - codegen
+  - openapi
+dependencies:
+  - plugin-ts
+  - plugin-client
+  - plugin-zod
+resources:
+  documentation: https://kubb.dev/plugins/plugin-mcp
+  repository: https://github.com/kubb-labs/plugins
+  issues: https://github.com/kubb-labs/plugins/issues
+  changelog: https://github.com/kubb-labs/plugins/blob/main/packages/plugin-mcp/CHANGELOG.md
+  codesandbox: https://codesandbox.io/p/github/kubb-labs/plugins/main/examples/mcp
+featured: false
+icon:
+  light: https://kubb.dev/feature/mcp-light.svg
+  dark: https://kubb.dev/feature/mcp-dark.svg
+intro: |
+  # @kubb/plugin-mcp
+
+  Generate [Model Context Protocol](https://modelcontextprotocol.io/introduction) servers from your OpenAPI schema. AI assistants like Claude can now call your API through conversational interfaces.
+
+  ```mermaid
+  graph TD
+    A[Kubb<br/>Generates code from OpenAPI] --> B[MCP Server<br/>Handles tool calls]
+    B --> C[Claude<br/>Conversational AI]
+    C -->|Sends tool request| B
+    B -->|Uses generated code| A
+  ```
+notes:
+  - type: tip
+    body: |
+      See [Setup Claude with Kubb](https://modelcontextprotocol.io/docs/tools/claude-desktop) for configuration instructions.
+options:
+  - name: output
+    type: Output
+    required: false
+    default: "{ path: 'mcp', barrelType: 'named' }"
+    description: Specify the export location for the files and define the behavior of the output.
+    properties:
+      - name: path
+        type: string
+        required: true
+        description: Output directory or file for the generated code, relative to the global `output.path`.
+        tip: |
+          if `output.path` is a file, `group` cannot be used.
+        default: "'mcp'"
+      - name: barrelType
+        type: "'all' | 'named' | 'propagate' | false"
+        required: false
+        default: "'named'"
+        description: Specify what to export and optionally disable barrel-file generation.
+        tip: |
+          Using `propagate` will prevent a plugin from creating a barrel file, but it will still propagate, allowing [`output.barrelType`](https://kubb.dev/docs/5.x/configuration#output-barreltype) to export the specific function or type.
+        examples:
+          - name: all
+            files:
+              - lang: typescript
+                code: |
+                  export * from './gen/petService.ts'
+                twoslash: false
+          - name: named
+            files:
+              - lang: typescript
+                code: |
+                  export { PetService } from './gen/petService.ts'
+                twoslash: false
+          - name: propagate
+            files:
+              - lang: typescript
+                code: ""
+                twoslash: false
+          - name: "false"
+            files:
+              - lang: typescript
+                code: ""
+                twoslash: false
+      - name: banner
+        type: "string | ((node: RootNode) => string)"
+        required: false
+        description: Add a banner comment at the top of every generated file. Accepts a static string or a function that receives the `RootNode` and returns a string.
+      - name: footer
+        type: "string | ((node: RootNode) => string)"
+        required: false
+        description: Add a footer comment at the end of every generated file. Accepts a static string or a function that receives the `RootNode` and returns a string.
+      - name: override
+        type: boolean
+        required: false
+        default: "false"
+        description: Whether Kubb overrides existing external files that can be generated if they already exist.
+  - name: resolver
+    type: Partial<ResolverMcp> & ThisType<ResolverMcp>
+    required: false
+    description: |
+      A single resolver that overrides the naming and path-resolution conventions. Each method you provide replaces the corresponding built-in one. When a method returns `null` or `undefined`, the resolver's result is used as the fallback, so you only need to supply the methods you want to change.
+
+      `this` inside each method is bound to the **full** resolver, so you can call other resolver methods (e.g. `this.default(name, 'function')`) without losing context.
+    body: |
+      Each plugin ships a built-in resolver:
+
+      | Plugin | Default resolver |
+      | --- | --- |
+      | `@kubb/plugin-ts` | `resolverTs` |
+      | `@kubb/plugin-zod` | `resolverZod` |
+      | `@kubb/plugin-cypress` | `resolverCypress` |
+      | `@kubb/plugin-mcp` | `resolverMcp` |
+    codeBlock:
+      lang: typescript
+      title: Custom resolver (plugin-mcp example)
+      code: |
+        import { pluginMcp } from '@kubb/plugin-mcp'
+
+        pluginMcp({
+          resolver: {
+            resolveName(name) {
+              return `Mcp${this.default(name, 'function')}`
+            },
+          },
+        })
+    tip: |
+      Use `resolver` for fine-grained control over naming conventions.
+  - name: group
+    type: Group
+    required: false
+    description: |
+      Grouping combines files in a folder based on a specific `type`.
+    examples:
+      - name: kubb.config.ts
+        files:
+          - lang: typescript
+            code: |
+              group: {
+                type: 'tag',
+                name({ group }) {
+                  return `${group}Controller`
+                }
+              }
+            twoslash: false
+    body: |
+      With the configuration above, the generator emits:
+
+      ```text
+      .
+      ├── src/
+      │   └── petController/
+      │   │   ├── addPet.ts
+      │   │   └── getPet.ts
+      │   └── storeController/
+      │       ├── createStore.ts
+      │       └── getStoreById.ts
+      ├── petStore.yaml
+      ├── kubb.config.ts
+      └── package.json
+      ```
+    properties:
+      - name: type
+        type: "'tag'"
+        required: true
+        description: Specify the property to group files by. Required when `group` is defined.
+        note: |
+          `Required: true*` means this is required only when the `group` option is used. The `group` option itself is optional.
+        body: |
+          - `'tag'`: Uses the first tag from `operation.getTags().at(0)?.name`
+      - name: name
+        type: "(context: GroupContext) => string"
+        required: false
+        default: (ctx) => `${ctx.group}Requests`
+        description: Return the name of a group based on the group name. This is used for file and identifier generation.
+  - name: paramsCasing
+    type: "'camelcase'"
+    required: false
+    description: Transform parameter names to camelCase in generated MCP handlers.
+    important: |
+      When using `paramsCasing`, ensure that `@kubb/plugin-ts` also has the same `paramsCasing` setting. This option automatically maps transformed parameter names back to their original API names in HTTP requests.
+    body: |
+      - `'camelcase'` transforms parameter names to camelCase.
+    examples:
+      - name: With paramsCasing camelcase
+        files:
+          - lang: typescript
+            code: |
+              // Handler uses camelCase parameters
+              export async function findPetsByStatusHandler({
+                stepId  // ✓ camelCase
+              }: {
+                stepId: FindPetsByStatusPathParams['stepId']
+              }): Promise<Promise<CallToolResult>> {
+                // Automatically maps back to original name
+                const step_id = stepId
+
+                const res = await fetch({
+                  method: 'GET',
+                  url: `/pet/findByStatus/${step_id}`,  // Uses original API name
+                  ...
+                })
+                ...
+              }
+            twoslash: false
+      - name: Without paramsCasing
+        files:
+          - lang: typescript
+            code: |
+              // Handler uses original API naming
+              export async function findPetsByStatusHandler({
+                step_id  // Original naming
+              }: {
+                step_id: FindPetsByStatusPathParams['step_id']
+              }): Promise<Promise<CallToolResult>> {
+                const res = await fetch({
+                  method: 'GET',
+                  url: `/pet/findByStatus/${step_id}`,
+                  ...
+                })
+                ...
+              }
+            twoslash: false
+  - name: client
+    type: ClientImportPath & { clientType?, dataReturnType?, baseURL?, bundle?, paramsCasing? }
+    required: false
+    description: Client configuration for HTTP request generation, including client type, data return type, base URL, and bundling options.
+    properties:
+      - name: importPath
+        type: string
+        required: false
+        description: Path to the client used for API calls. Supports both relative and absolute paths.
+        details:
+          - title: When to use `importPath`
+            body: |
+              Use `importPath` when you want to:
+
+              - **Customize the HTTP client**: Provide your own client implementation with custom configurations (e.g., baseURL, headers, interceptors)
+              - **Add authentication**: Include authentication tokens or other security mechanisms in your client
+              - **Override default behavior**: Replace the default Kubb client with your own implementation
+          - title: Default behavior
+            body: |
+              When `importPath` is not specified:
+
+              - If `bundle: false` (default): Uses `@kubb/plugin-client/clients/${client}` where client is either `axios` or `fetch`.
+              - If `bundle: true`: Bundles the client into `.kubb/fetch.ts`.
+          - title: Import structure
+            body: "Generated code imports the client as a default import and the runtime types as named type imports:"
+            codeBlock:
+              lang: typescript
+              code: |-
+                /**
+                 * Generated by Kubb (https://kubb.dev/).
+                 * Do not edit manually.
+                 */
+                import client from '${client.importPath}'
+                import type { RequestConfig, ResponseErrorConfig } from '${client.importPath}'
+                // ... rest of generated file
+        important: |
+          When using `importPath` with query plugins such as `@kubb/plugin-react-query` or `@kubb/plugin-vue-query`, the generated hooks also import a `Client` type alongside `RequestConfig` and `ResponseErrorConfig` from the custom module. Your custom client module **must** export all three types — if any is missing, TypeScript will report an unresolvable import error.
+        codeBlock:
+          lang: typescript
+          title: client.ts
+          code: |
+            export type RequestConfig<TData = unknown> = {
+              url?: string
+              method: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE'
+              params?: object
+              data?: TData | FormData
+              responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
+              signal?: AbortSignal
+              headers?: HeadersInit
+            }
+
+            export type ResponseConfig<TData = unknown> = {
+              data: TData
+              status: number
+              statusText: string
+            }
+
+            export type ResponseErrorConfig<TError = unknown> = TError
+
+            // The Client type alias is required when using query plugins
+            export type Client = <TData, _TError = unknown, TVariables = unknown>(
+              config: RequestConfig<TVariables>
+            ) => Promise<ResponseConfig<TData>>
+
+            export const client: Client = async (config) => { /* ... */ }
+            export default client
+        examples:
+          - name: kubb.config.ts
+            files:
+              - lang: typescript
+                code: |
+                  import { defineConfig } from 'kubb'
+                  import { pluginClient } from '@kubb/plugin-client'
+
+                  export default defineConfig({
+                    // ...
+                    plugins: [
+                      pluginClient({
+                        importPath: './src/client.ts', // Path to your custom client
+                      }),
+                    ],
+                  })
+                twoslash: false
+        tip: |
+          Learn more about defining a custom client [here](https://kubb.dev/plugins/plugin-client#importpath).
+      - name: dataReturnType
+        type: "'data' | 'full'"
+        required: false
+        default: "'data'"
+        description: |
+          Return type used when calling the client.
+
+          - `'data'` returns `ResponseConfig['data']`.
+          - `'full'` returns the full `ResponseConfig`.
+        examples:
+          - name: data
+            files:
+              - lang: typescript
+                code: |
+                  export async function getPetById<TData>(
+                    petId: GetPetByIdPathParams,
+                  ): Promise<ResponseConfig<TData>['data']> {
+                    ...
+                  }
+                twoslash: false
+          - name: full
+            files:
+              - lang: typescript
+                code: |
+                  export async function getPetById<TData>(
+                    petId: GetPetByIdPathParams,
+                  ): Promise<ResponseConfig<TData>> {
+                    ...
+                  }
+                twoslash: false
+      - name: baseURL
+        type: string
+        required: false
+        description: Sets a custom base URL for all generated calls. When not set, the base URL is automatically taken from the OAS spec via the adapter (e.g. the `servers[0].url` field).
+  - name: include
+    type: Array<Include>
+    required: false
+    description: Array containing include parameters to include tags, operations, methods, paths, or content types.
+    codeBlock:
+      lang: typescript
+      title: Include
+      code: |
+        export type Include = {
+          type: 'tag' | 'operationId' | 'path' | 'method' | 'contentType'
+          pattern: string | RegExp
+        }
+  - name: exclude
+    type: Array<Exclude>
+    required: false
+    description: Array containing exclude parameters to exclude or skip tags, operations, methods, paths, or content types.
+    codeBlock:
+      lang: typescript
+      title: Exclude
+      code: |
+        export type Exclude = {
+          type: 'tag' | 'operationId' | 'path' | 'method' | 'contentType'
+          pattern: string | RegExp
+        }
+  - name: override
+    type: Array<Override>
+    required: false
+    description: Array containing override parameters to override `options` based on tags, operations, methods, paths, or content types.
+    codeBlock:
+      lang: typescript
+      title: Override
+      code: |
+        export type Override = {
+          type: 'tag' | 'operationId' | 'path' | 'method' | 'contentType'
+          pattern: string | RegExp
+          options: PluginOptions
+        }
+  - name: generators
+    type: Array<Generator<PluginMcp>>
+    required: false
+    experimental: true
+    description: |
+      Define additional generators next to the built-in generators.
+
+      See [Generators](https://kubb.dev/docs/5.x/guides/creating-plugins) for more information on how to use generators.
+  - name: transformer
+    type: Visitor
+    required: false
+    description: |
+      A single AST visitor applied to every node before code is printed. Each method you provide replaces the corresponding built-in one. When a method returns `null` or `undefined`, the preset transformer's result is used as the fallback — so you only need to supply the methods you want to change.
+
+      Visitor methods receive the node and a context object. Return a modified node to replace it, or return `undefined`/`void` to leave it unchanged.
+    examples:
+      - name: Strip descriptions before printing
+        files:
+          - lang: typescript
+            code: |
+              import { pluginTs } from '@kubb/plugin-ts'
+
+              pluginTs({
+                transformer: {
+                  schema(node) {
+                    return { ...node, description: undefined }
+                  },
+                },
+              })
+            twoslash: false
+      - name: Prefix every operationId
+        files:
+          - lang: typescript
+            code: |
+              import { pluginTs } from '@kubb/plugin-ts'
+
+              pluginTs({
+                transformer: {
+                  operation(node) {
+                    return { ...node, operationId: `api_${node.operationId}` }
+                  },
+                },
+              })
+            twoslash: false
+    tip: |
+      Use `transformer` to rewrite node properties before printing. For output naming customization, use `resolver` instead.
+examples:
+  - name: kubb.config.ts
+    files:
+      - lang: typescript
+        code: |
+          import { defineConfig } from 'kubb'
+          import { pluginTs } from '@kubb/plugin-ts'
+          import { pluginClient } from '@kubb/plugin-client'
+          import { pluginZod } from '@kubb/plugin-zod'
+          import { pluginMcp } from '@kubb/plugin-mcp'
+
+          export default defineConfig({
+            input: { path: './petStore.yaml' },
+            output: { path: './src/gen' },
+            plugins: [
+              pluginTs(),
+              pluginClient(),
+              pluginZod(),
+              pluginMcp({
+                output: { path: 'mcp', barrelType: 'named' },
+                client: {
+                  baseURL: 'https://petstore.swagger.io/v2',
+                },
+                group: {
+                  type: 'tag',
+                  name: ({ group }) => `${group}Handlers`,
+                },
+              }),
+            ],
+          })
+        twoslash: false