@nestia/sdk 11.2.1 → 11.3.0

package/lib/generates/internal/SdkFileProgrammer.js

@@ -19,6 +19,7 @@ const MapUtil_1 = require("../../utils/MapUtil");
 const FilePrinter_1 = require("./FilePrinter");
 const ImportDictionary_1 = require("./ImportDictionary");
 const SdkHttpRouteProgrammer_1 = require("./SdkHttpRouteProgrammer");
+const SdkMcpRouteProgrammer_1 = require("./SdkMcpRouteProgrammer");
 const SdkRouteDirectory_1 = require("./SdkRouteDirectory");
 const SdkWebSocketRouteProgrammer_1 = require("./SdkWebSocketRouteProgrammer");
 var SdkFileProgrammer;
@@ -66,7 +67,9 @@ var SdkFileProgrammer;
                 importer.declarations(route.imports);
             statements.push(...(route.protocol === "http"
                 ? SdkHttpRouteProgrammer_1.SdkHttpRouteProgrammer.write(project)(importer)(route)
-                : SdkWebSocketRouteProgrammer_1.SdkWebSocketRouteProgrammer.write(project)(importer)(route)));
+                : route.protocol === "websocket"
+                    ? SdkWebSocketRouteProgrammer_1.SdkWebSocketRouteProgrammer.write(project)(importer)(route)
+                    : SdkMcpRouteProgrammer_1.SdkMcpRouteProgrammer.write(project)(importer)(route)));
             if (i !== directory.routes.length - 1)
                 statements.push(FilePrinter_1.FilePrinter.enter());
         });

package/lib/generates/internal/SdkFileProgrammer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SdkFileProgrammer.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkFileProgrammer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,4DAA4B;AAM5B,iDAA8C;AAC9C,+CAA4C;AAC5C,yDAAsD;AACtD,qEAAkE;AAClE,2DAAwD;AACxD,+EAA4E;AAE5E,IAAiB,iBAAiB,CA+FjC;AA/FD,WAAiB,iBAAiB;IAChC;;kEAE8D;IACjD,0BAAQ,GAAG,CAAO,GAAsB,EAAiB,EAAE;QACtE,wBAAwB;QACxB,MAAM,IAAI,GAAsB,IAAI,qCAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC1E,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC;QAErD,gBAAgB;QAChB,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,aAAa,CAAC,CAAC;IAC9E,CAAC,CAAA,CAAC;IAEF,MAAM,OAAO,GACX,CAAC,SAA4B,EAAE,EAAE,CACjC,CAAC,KAA6C,EAAQ,EAAE;QACtD,mBAAmB;QACnB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,SAAS,GAAG,iBAAO,CAAC,IAAI,CACtB,SAAS,CAAC,QAAQ,EAClB,GAAG,EACH,GAAG,EAAE,CAAC,IAAI,qCAAiB,CAAC,SAAS,EAAE,GAAG,CAAC,CAC5C,CAAC;QACJ,CAAC;QAED,YAAY;QACZ,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC,CAAC;IAEJ;;kEAE8D;IAC9D,MAAM,OAAO,GACX,CAAC,OAAuB,EAAE,EAAE,CAC5B,CAAC,SAA4B,EAAE,EAAE,CACjC,CAAO,MAAc,EAAiB,EAAE;QACtC,yBAAyB;QACzB,IAAI,CAAC;YACH,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,WAAM,CAAC,CAAA,CAAC;QAEV,mBAAmB;QACnB,MAAM,UAAU,GAAmB,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;YAClD,UAAU,CAAC,IAAI,CACb,oBAAE,CAAC,OAAO,CAAC,uBAAuB,CAChC,SAAS,EACT,KAAK,EACL,oBAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,oBAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAClE,oBAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,GAAG,QAAQ,CAAC,EAChD,SAAS,CACV,CACF,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM;YAC9C,UAAU,CAAC,IAAI,CAAC,yBAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QAEvC,iBAAiB;QACjB,MAAM,QAAQ,GAAqB,IAAI,mCAAgB,CACrD,GAAG,MAAM,WAAW,CACrB,CAAC;QACF,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC;gBAC/D,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,UAAU,CAAC,IAAI,CACb,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM;gBAC3B,CAAC,CAAC,+CAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;gBACxD,CAAC,CAAC,yDAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CACjE,CAAC;YACF,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBACnC,UAAU,CAAC,IAAI,CAAC,yBAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAC/B,UAAU,CAAC,IAAI,CACb,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAChC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,UAAU,CAAC,MAAM;gBACxC,CAAC,CAAC,CAAC,yBAAW,CAAC,KAAK,EAAE,CAAC;gBACvB,CAAC,CAAC,EAAE,CAAC,EACP,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAC3C,CAAC;QACJ,MAAM,yBAAW,CAAC,KAAK,CAAC;YACtB,QAAQ,EAAE,QAAQ,CAAC,IAAI;YACvB,UAAU;YACV,GAAG,EACD,OAAO;gBACP,4BAA4B;gBAC5B,cAAc,SAAS,CAAC,MAAM,IAAI;gBAClC,uEAAuE;gBACvE,OAAO;gBACP,sEAAsE;SACzE,CAAC,CAAC;IACL,CAAC,CAAA,CAAC;AACN,CAAC,EA/FgB,iBAAiB,iCAAjB,iBAAiB,QA+FjC"}
+{"version":3,"file":"SdkFileProgrammer.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkFileProgrammer.ts"],"names":[],"mappings":"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"}

package/lib/generates/internal/SdkMcpRouteProgrammer.d.ts

@@ -0,0 +1,25 @@
+import ts from "typescript";
+import { INestiaProject } from "../../structures/INestiaProject";
+import { ITypedMcpRoute } from "../../structures/ITypedMcpRoute";
+import { ImportDictionary } from "./ImportDictionary";
+/**
+ * Emits a typed client wrapper for an MCP tool.
+ *
+ * Output mirrors `SdkHttpRouteProgrammer` conventions: a top-level async
+ * function paired with a namespace that exposes `Input`, `Output`, and
+ * `METADATA`. Object output types are wrapped in `Primitive<T>` from typia
+ * because MCP round-trips values through JSON, matching the semantics of
+ * `Primitive`. Void MCP tools return `Promise<void>`.
+ *
+ * The response is typed via `CallToolResult` from `@modelcontextprotocol/sdk`
+ * and narrowed structurally (`isError === true`, `type === "text"`) rather than
+ * asserted with `as any`. The single unavoidable cast is on the `arguments`
+ * field of `client.callTool(...)`, which the MCP SDK types as `Record<string,
+ * unknown> | undefined`; a user interface without an index signature is not
+ * structurally assignable to that record.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export declare namespace SdkMcpRouteProgrammer {
+    const write: (project: INestiaProject) => (importer: ImportDictionary) => (route: ITypedMcpRoute) => ts.Statement[];
+}

package/lib/generates/internal/SdkMcpRouteProgrammer.js

@@ -0,0 +1,192 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SdkMcpRouteProgrammer = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const FilePrinter_1 = require("./FilePrinter");
+/**
+ * Emits a typed client wrapper for an MCP tool.
+ *
+ * Output mirrors `SdkHttpRouteProgrammer` conventions: a top-level async
+ * function paired with a namespace that exposes `Input`, `Output`, and
+ * `METADATA`. Object output types are wrapped in `Primitive<T>` from typia
+ * because MCP round-trips values through JSON, matching the semantics of
+ * `Primitive`. Void MCP tools return `Promise<void>`.
+ *
+ * The response is typed via `CallToolResult` from `@modelcontextprotocol/sdk`
+ * and narrowed structurally (`isError === true`, `type === "text"`) rather than
+ * asserted with `as any`. The single unavoidable cast is on the `arguments`
+ * field of `client.callTool(...)`, which the MCP SDK types as `Record<string,
+ * unknown> | undefined`; a user interface without an index signature is not
+ * structurally assignable to that record.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+var SdkMcpRouteProgrammer;
+(function (SdkMcpRouteProgrammer) {
+    SdkMcpRouteProgrammer.write = (project) => (importer) => (route) => [
+        FilePrinter_1.FilePrinter.description(writeFunction(project)(importer)(route), writeDescription(route)),
+        writeNamespace(project)(importer)(route),
+    ];
+    /* ---------------------------------------------------------
+      FUNCTION
+    --------------------------------------------------------- */
+    const writeFunction = (_project) => (importer) => (route) => {
+        const clientType = typescript_1.default.factory.createTypeReferenceNode(importer.external({
+            declaration: true,
+            file: "@modelcontextprotocol/sdk/client/index.js",
+            type: "element",
+            name: "Client",
+            alias: "McpClient",
+        }));
+        const callToolResultTypeName = importer.external({
+            declaration: true,
+            file: "@modelcontextprotocol/sdk/types.js",
+            type: "element",
+            name: "CallToolResult",
+            alias: "McpCallToolResult",
+        });
+        const isVoid = isVoidReturn(route);
+        // Register Primitive import so Output type resolves.
+        if (!isVoid)
+            importer.external({
+                declaration: true,
+                file: "typia",
+                type: "element",
+                name: "Primitive",
+            });
+        const inputRef = route.input
+            ? typescript_1.default.factory.createTypeReferenceNode(`${route.name}.Input`)
+            : typescript_1.default.factory.createTypeLiteralNode([]);
+        const outputRef = typescript_1.default.factory.createTypeReferenceNode(`${route.name}.Output`);
+        const params = [
+            typescript_1.default.factory.createParameterDeclaration(undefined, undefined, "client", undefined, clientType),
+        ];
+        if (route.input) {
+            params.push(typescript_1.default.factory.createParameterDeclaration(undefined, undefined, "args", undefined, inputRef));
+        }
+        const toolNameExpr = typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier(route.name), "METADATA"), "tool");
+        const callToolParams = [
+            typescript_1.default.factory.createPropertyAssignment("name", toolNameExpr),
+        ];
+        if (route.input) {
+            callToolParams.push(typescript_1.default.factory.createPropertyAssignment("arguments", typescript_1.default.factory.createAsExpression(typescript_1.default.factory.createAsExpression(typescript_1.default.factory.createIdentifier("args"), typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.UnknownKeyword)), typescript_1.default.factory.createTypeReferenceNode("Record", [
+                typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.StringKeyword),
+                typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.UnknownKeyword),
+            ]))));
+        }
+        const body = typescript_1.default.factory.createBlock([
+            // const raw = await client.callTool({ ... });
+            // NOTE: callTool returns `CallToolResult | CompatibilityCallToolResult`
+            //       (the pre-2024-11-05 compat variant has `toolResult`, no
+            //       `content`). TypeScript cannot narrow the union structurally
+            //       because both variants carry an `[x: string]: unknown` index
+            //       signature. Branch at runtime, then cast to CallToolResult
+            //       once for the modern path.
+            typescript_1.default.factory.createVariableStatement(undefined, typescript_1.default.factory.createVariableDeclarationList([
+                typescript_1.default.factory.createVariableDeclaration("raw", undefined, undefined, typescript_1.default.factory.createAwaitExpression(typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("client"), "callTool"), undefined, [
+                    typescript_1.default.factory.createObjectLiteralExpression(callToolParams, true),
+                ]))),
+            ], typescript_1.default.NodeFlags.Const)),
+            // if ("toolResult" in raw) throw ...;
+            typescript_1.default.factory.createIfStatement(typescript_1.default.factory.createBinaryExpression(typescript_1.default.factory.createStringLiteral("toolResult"), typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.InKeyword), typescript_1.default.factory.createIdentifier("raw")), typescript_1.default.factory.createThrowStatement(typescript_1.default.factory.createNewExpression(typescript_1.default.factory.createIdentifier("Error"), undefined, [
+                typescript_1.default.factory.createTemplateExpression(typescript_1.default.factory.createTemplateHead('MCP tool "'), [
+                    typescript_1.default.factory.createTemplateSpan(toolNameExpr, typescript_1.default.factory.createTemplateTail('" returned a legacy (pre-2024-11-05) compatibility result')),
+                ]),
+            ]))),
+            // const result: CallToolResult = raw;
+            //   Safe: preceding branch rejected the compat variant.
+            typescript_1.default.factory.createVariableStatement(undefined, typescript_1.default.factory.createVariableDeclarationList([
+                typescript_1.default.factory.createVariableDeclaration("result", undefined, typescript_1.default.factory.createTypeReferenceNode(callToolResultTypeName), typescript_1.default.factory.createAsExpression(typescript_1.default.factory.createIdentifier("raw"), typescript_1.default.factory.createTypeReferenceNode(callToolResultTypeName))),
+            ], typescript_1.default.NodeFlags.Const)),
+            // if (result.isError === true) throw ...;
+            typescript_1.default.factory.createIfStatement(typescript_1.default.factory.createBinaryExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("result"), "isError"), typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.EqualsEqualsEqualsToken), typescript_1.default.factory.createTrue()), typescript_1.default.factory.createThrowStatement(typescript_1.default.factory.createNewExpression(typescript_1.default.factory.createIdentifier("Error"), undefined, [
+                typescript_1.default.factory.createTemplateExpression(typescript_1.default.factory.createTemplateHead('MCP tool "'), [
+                    typescript_1.default.factory.createTemplateSpan(toolNameExpr, typescript_1.default.factory.createTemplateTail('" returned isError')),
+                ]),
+            ]))),
+            ...(isVoid
+                ? [typescript_1.default.factory.createReturnStatement()]
+                : [
+                    // const first = result.content[0];
+                    typescript_1.default.factory.createVariableStatement(undefined, typescript_1.default.factory.createVariableDeclarationList([
+                        typescript_1.default.factory.createVariableDeclaration("first", undefined, undefined, typescript_1.default.factory.createElementAccessExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("result"), "content"), typescript_1.default.factory.createNumericLiteral(0))),
+                    ], typescript_1.default.NodeFlags.Const)),
+                    typescript_1.default.factory.createIfStatement(typescript_1.default.factory.createBinaryExpression(typescript_1.default.factory.createBinaryExpression(typescript_1.default.factory.createIdentifier("first"), typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.EqualsEqualsEqualsToken), typescript_1.default.factory.createIdentifier("undefined")), typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.BarBarToken), typescript_1.default.factory.createBinaryExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("first"), "type"), typescript_1.default.factory.createToken(typescript_1.default.SyntaxKind.ExclamationEqualsEqualsToken), typescript_1.default.factory.createStringLiteral("text"))), typescript_1.default.factory.createThrowStatement(typescript_1.default.factory.createNewExpression(typescript_1.default.factory.createIdentifier("Error"), undefined, [
+                        typescript_1.default.factory.createTemplateExpression(typescript_1.default.factory.createTemplateHead('MCP tool "'), [
+                            typescript_1.default.factory.createTemplateSpan(toolNameExpr, typescript_1.default.factory.createTemplateTail('" returned no text content')),
+                        ]),
+                    ]))),
+                    typescript_1.default.factory.createReturnStatement(typescript_1.default.factory.createAsExpression(typescript_1.default.factory.createCallExpression(typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("JSON"), "parse"), undefined, [
+                        typescript_1.default.factory.createPropertyAccessExpression(typescript_1.default.factory.createIdentifier("first"), "text"),
+                    ]), outputRef)),
+                ]),
+        ], true);
+        return typescript_1.default.factory.createFunctionDeclaration([
+            typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword),
+            typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.AsyncKeyword),
+        ], undefined, route.name, undefined, params, typescript_1.default.factory.createTypeReferenceNode("Promise", [outputRef]), body);
+    };
+    /* ---------------------------------------------------------
+      NAMESPACE
+    --------------------------------------------------------- */
+    const writeNamespace = (_project) => (importer) => (route) => {
+        const statements = [];
+        // Input type alias
+        if (route.input) {
+            statements.push(typescript_1.default.factory.createTypeAliasDeclaration([typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword)], "Input", undefined, typescript_1.default.factory.createTypeReferenceNode(route.input.type.name)));
+        }
+        // Output type alias
+        const isVoid = isVoidReturn(route);
+        const outputType = !isVoid && route.returnType !== null
+            ? typescript_1.default.factory.createTypeReferenceNode(importer.external({
+                declaration: true,
+                file: "typia",
+                type: "element",
+                name: "Primitive",
+            }), [
+                typescript_1.default.factory.createTypeReferenceNode(unwrapPromise(route.returnType.name)),
+            ])
+            : typescript_1.default.factory.createKeywordTypeNode(typescript_1.default.SyntaxKind.VoidKeyword);
+        statements.push(typescript_1.default.factory.createTypeAliasDeclaration([typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword)], "Output", undefined, outputType));
+        // METADATA const
+        const metadataProps = [
+            typescript_1.default.factory.createPropertyAssignment("protocol", typescript_1.default.factory.createStringLiteral("mcp")),
+            typescript_1.default.factory.createPropertyAssignment("tool", typescript_1.default.factory.createStringLiteral(route.toolName)),
+            typescript_1.default.factory.createPropertyAssignment("title", route.title === null
+                ? typescript_1.default.factory.createNull()
+                : typescript_1.default.factory.createStringLiteral(route.title)),
+            typescript_1.default.factory.createPropertyAssignment("description", route.toolDescription === null
+                ? typescript_1.default.factory.createNull()
+                : typescript_1.default.factory.createStringLiteral(route.toolDescription)),
+        ];
+        statements.push(typescript_1.default.factory.createVariableStatement([typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword)], typescript_1.default.factory.createVariableDeclarationList([
+            typescript_1.default.factory.createVariableDeclaration("METADATA", undefined, undefined, typescript_1.default.factory.createAsExpression(typescript_1.default.factory.createObjectLiteralExpression(metadataProps, true), typescript_1.default.factory.createTypeReferenceNode("const"))),
+        ], typescript_1.default.NodeFlags.Const)));
+        return typescript_1.default.factory.createModuleDeclaration([typescript_1.default.factory.createModifier(typescript_1.default.SyntaxKind.ExportKeyword)], typescript_1.default.factory.createIdentifier(route.name), typescript_1.default.factory.createModuleBlock(statements), typescript_1.default.NodeFlags.Namespace);
+    };
+    /* ---------------------------------------------------------
+      DESCRIPTION
+    --------------------------------------------------------- */
+    const writeDescription = (route) => {
+        const lines = [];
+        if (route.toolDescription)
+            lines.push(...route.toolDescription.split("\n"));
+        else if (route.description)
+            lines.push(...route.description.split("\n"));
+        if (lines.length)
+            lines.push("");
+        lines.push(`@controller ${route.controller.class.name}.${route.function.name || route.name}`, `@tool ${route.toolName}`, `@accessor ${["api", "functional", ...route.accessor].join(".")}`, `@protocol mcp`, `@nestia Generated by Nestia - https://github.com/samchon/nestia`);
+        return lines.join("\n");
+    };
+    const unwrapPromise = (name) => {
+        const m = /^Promise<(.+)>$/.exec(name);
+        return m ? m[1] : name;
+    };
+    const isVoidReturn = (route) => route.returnType === null ||
+        isVoidName(unwrapPromise(route.returnType.name));
+    const isVoidName = (name) => name === "void" || name === "undefined";
+})(SdkMcpRouteProgrammer || (exports.SdkMcpRouteProgrammer = SdkMcpRouteProgrammer = {}));
+//# sourceMappingURL=SdkMcpRouteProgrammer.js.map

package/lib/generates/internal/SdkMcpRouteProgrammer.js.map

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

package/lib/generates/internal/SdkRouteDirectory.d.ts

@@ -1,10 +1,11 @@
 import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "../../structures/ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
 export declare class SdkRouteDirectory {
     readonly parent: SdkRouteDirectory | null;
     readonly name: string;
     readonly module: string;
     readonly children: Map<string, SdkRouteDirectory>;
-    readonly routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
+    readonly routes: Array<ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute>;
     constructor(parent: SdkRouteDirectory | null, name: string);
 }

package/lib/generates/internal/SdkRouteDirectory.js.map

@@ -1 +1 @@
-{"version":3,"file":"SdkRouteDirectory.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkRouteDirectory.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAK5B,YACW,MAAgC,EAChC,IAAY;QADZ,WAAM,GAAN,MAAM,CAA0B;QAChC,SAAI,GAAJ,IAAI,CAAQ;QAErB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM;YACT,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IAC3E,CAAC;CACF;AAdD,8CAcC"}
+{"version":3,"file":"SdkRouteDirectory.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkRouteDirectory.ts"],"names":[],"mappings":";;;AAIA,MAAa,iBAAiB;IAO5B,YACW,MAAgC,EAChC,IAAY;QADZ,WAAM,GAAN,MAAM,CAA0B;QAChC,SAAI,GAAJ,IAAI,CAAQ;QAErB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,MAAM;YACT,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IAC3E,CAAC;CACF;AAhBD,8CAgBC"}

package/lib/structures/IReflectController.d.ts

@@ -1,5 +1,6 @@
 import type { VERSION_NEUTRAL } from "@nestjs/common/interfaces";
 import { IReflectHttpOperation } from "./IReflectHttpOperation";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
 import { IReflectWebSocketOperation } from "./IReflectWebSocketOperation";
 export interface IReflectController {
     class: Function;
@@ -7,7 +8,7 @@ export interface IReflectController {
     paths: string[];
     file: string;
     versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation>;
+    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation | IReflectMcpOperation>;
     security: Record<string, string[]>[];
     tags: string[];
 }

package/lib/structures/IReflectMcpOperation.d.ts

@@ -0,0 +1,37 @@
+import ts from "typescript";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+/**
+ * Reflected operation metadata for a method decorated with `@McpRoute`.
+ *
+ * Produced by {@link ReflectMcpOperationAnalyzer.analyze}; consumed by
+ * {@link TypedMcpRouteAnalyzer.analyze} to produce the final
+ * {@link ITypedMcpRoute}.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export interface IReflectMcpOperation {
+    protocol: "mcp";
+    name: string;
+    toolName: string;
+    title: string | null;
+    toolDescription: string | null;
+    inputSchema: object;
+    outputSchema: object | null;
+    annotations: IReflectMcpOperation.IAnnotations | null;
+    function: Function;
+    parameters: IReflectMcpOperationParameter[];
+    returnType: IReflectType | null;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: ts.JSDocTagInfo[];
+}
+export declare namespace IReflectMcpOperation {
+    interface IAnnotations {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    }
+}

package/lib/structures/IReflectMcpOperation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IReflectMcpOperation.js.map

package/lib/structures/IReflectMcpOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReflectMcpOperation.js","sourceRoot":"","sources":["../../src/structures/IReflectMcpOperation.ts"],"names":[],"mappings":""}

package/lib/structures/IReflectMcpOperationParameter.d.ts

@@ -0,0 +1,21 @@
+import { IJsDocTagInfo } from "typia";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectType } from "./IReflectType";
+/**
+ * Parameter descriptor for an MCP tool method. Reflected from
+ * `"nestia/McpRoute/Parameters"` metadata plus compile-time type information
+ * collected by the nestia transformer.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export interface IReflectMcpOperationParameter {
+    category: "params";
+    name: string;
+    index: number;
+    type: IReflectType;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+}
+export declare namespace IReflectMcpOperationParameter {
+}

package/lib/structures/IReflectMcpOperationParameter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IReflectMcpOperationParameter.js.map

package/lib/structures/IReflectMcpOperationParameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReflectMcpOperationParameter.js","sourceRoot":"","sources":["../../src/structures/IReflectMcpOperationParameter.ts"],"names":[],"mappings":""}

package/lib/structures/ITypedApplication.d.ts

@@ -1,9 +1,10 @@
 import { IMetadataDictionary } from "@typia/core";
 import { INestiaProject } from "./INestiaProject";
 import { ITypedHttpRoute } from "./ITypedHttpRoute";
+import { ITypedMcpRoute } from "./ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
 export interface ITypedApplication {
     project: INestiaProject;
     collection: IMetadataDictionary;
-    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
+    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute>;
 }

package/lib/structures/ITypedMcpRoute.d.ts

@@ -0,0 +1,33 @@
+import ts from "typescript";
+import { IReflectController } from "./IReflectController";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+/**
+ * Final typed representation of an MCP tool route.
+ *
+ * Carries everything the SDK generator needs to emit a typed client function:
+ * the controller reference, accessor path, typia-derived input schema, and
+ * input/output type info.
+ *
+ * @author wildduck - https://github.com/wildduck2
+ */
+export interface ITypedMcpRoute {
+    protocol: "mcp";
+    controller: IReflectController;
+    name: string;
+    toolName: string;
+    title: string | null;
+    toolDescription: string | null;
+    accessor: string[];
+    function: Function;
+    input: IReflectMcpOperationParameter | null;
+    returnType: IReflectType | null;
+    inputSchema: object;
+    outputSchema: object | null;
+    annotations: IReflectMcpOperation.IAnnotations | null;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: ts.JSDocTagInfo[];
+}

package/lib/structures/ITypedMcpRoute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITypedMcpRoute.js.map

package/lib/structures/ITypedMcpRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITypedMcpRoute.js","sourceRoot":"","sources":["../../src/structures/ITypedMcpRoute.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "11.2.1",
+  "version": "11.3.0",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "exports": {
@@ -58,13 +58,14 @@
     "tsconfig-paths": "^4.1.1",
     "tstl": "^3.0.0",
     "typia": "12.1.0",
-    "@nestia/core": "^11.2.1",
-    "@nestia/fetcher": "^11.2.1"
+    "@nestia/core": "^11.3.0",
+    "@nestia/fetcher": "^11.3.0"
   },
   "peerDependencies": {
-    "@nestia/core": "^11.2.1"
+    "@nestia/core": "^11.3.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
     "@nestjs/common": "^11.1.6",
     "@nestjs/core": "^11.1.6",
     "@types/cli": "^0.11.21",

package/src/NestiaSdkApplication.ts

@@ -9,6 +9,7 @@ import { ConfigAnalyzer } from "./analyses/ConfigAnalyzer";
 import { PathAnalyzer } from "./analyses/PathAnalyzer";
 import { ReflectControllerAnalyzer } from "./analyses/ReflectControllerAnalyzer";
 import { TypedHttpRouteAnalyzer } from "./analyses/TypedHttpRouteAnalyzer";
+import { TypedMcpRouteAnalyzer } from "./analyses/TypedMcpRouteAnalyzer";
 import { TypedWebSocketRouteAnalyzer } from "./analyses/TypedWebSocketRouteAnalyzer";
 import { E2eGenerator } from "./generates/E2eGenerator";
 import { SdkGenerator } from "./generates/SdkGenerator";
@@ -18,6 +19,7 @@ import { IReflectController } from "./structures/IReflectController";
 import { IReflectOperationError } from "./structures/IReflectOperationError";
 import { ITypedApplication } from "./structures/ITypedApplication";
 import { ITypedHttpRoute } from "./structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "./structures/ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "./structures/ITypedWebSocketRoute";
 import { IOperationMetadata } from "./transformers/IOperationMetadata";
 import { StringUtil } from "./utils/StringUtil";
@@ -162,7 +164,11 @@ export class NestiaSdkApplication {
       const set: HashSet<Pair<string, string>> = new HashSet();
       for (const controller of controllers)
         for (const controllerPath of controller.paths)
-          for (const operation of controller.operations)
+          for (const operation of controller.operations) {
+            if (operation.protocol === "mcp") {
+              set.insert(new Pair(`mcp:${operation.toolName}`, "mcp"));
+              continue;
+            }
             for (const operationPath of operation.paths)
               set.insert(
                 new Pair(
@@ -170,6 +176,7 @@ export class NestiaSdkApplication {
                   operation.protocol === "http" ? operation.method : "",
                 ),
               );
+          }
       return set.size();
     })();
 
@@ -180,7 +187,9 @@ export class NestiaSdkApplication {
         .map(
           (c) =>
             c.paths.length *
-            c.operations.map((f) => f.paths.length).reduce((a, b) => a + b, 0),
+            c.operations
+              .map((f) => (f.protocol === "mcp" ? 1 : f.paths.length))
+              .reduce((a, b) => a + b, 0),
         )
         .reduce((a, b) => a + b, 0)}`,
     );
@@ -196,9 +205,20 @@ export class NestiaSdkApplication {
 
     // CONVERT TO TYPED OPERATIONS
     const globalPrefix: string = project.input.globalPrefix?.prefix ?? "";
-    const routes: Array<ITypedHttpRoute | ITypedWebSocketRoute> = [];
+    const routes: Array<
+      ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute
+    > = [];
     for (const c of controllers)
       for (const o of c.operations) {
+        if (o.protocol === "mcp") {
+          routes.push(
+            ...TypedMcpRouteAnalyzer.analyze({
+              controller: c,
+              operation: o,
+            }),
+          );
+          continue;
+        }
         const pathList: Set<string> = new Set();
         const versions: string[] = VersioningStrategy.merge(project)([
           ...(c.versions ?? []),

package/src/NestiaSwaggerComposer.ts

@@ -68,6 +68,7 @@ export namespace NestiaSwaggerComposer {
     const routes: ITypedHttpRoute[] = [];
     for (const c of controllers)
       for (const o of c.operations) {
+        if (o.protocol === "mcp") continue;
         const pathList: Set<string> = new Set();
         const versions: string[] = VersioningStrategy.merge(project)([
           ...(c.versions ?? []),

package/src/analyses/AccessorAnalyzer.ts

@@ -1,21 +1,20 @@
 import { NamingConvention } from "@typia/utils";
 
 import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
+import { ITypedMcpRoute } from "../structures/ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "../structures/ITypedWebSocketRoute";
 
+type AnyRoute = ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute;
+
 export namespace AccessorAnalyzer {
-  export const analyze = (
-    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ) => {
+  export const analyze = (routes: Array<AnyRoute>) => {
     shrink(routes);
     variable(routes);
     shrink(routes);
     for (const r of routes) r.name = r.accessor.at(-1) ?? r.name;
   };
 
-  const prepare = (
-    routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ): Map<string, number> => {
+  const prepare = (routeList: Array<AnyRoute>): Map<string, number> => {
     const dict: Map<string, number> = new Map();
     for (const route of routeList)
       route.accessor.forEach((_a, i) => {
@@ -25,9 +24,7 @@ export namespace AccessorAnalyzer {
     return dict;
   };
 
-  const variable = (
-    routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>,
-  ) => {
+  const variable = (routeList: Array<AnyRoute>) => {
     const dict: Map<string, number> = prepare(routeList);
     for (const route of routeList) {
       const emended: string[] = route.accessor.slice();
@@ -49,7 +46,7 @@ export namespace AccessorAnalyzer {
     }
   };
 
-  const shrink = (routeList: Array<ITypedHttpRoute | ITypedWebSocketRoute>) => {
+  const shrink = (routeList: Array<AnyRoute>) => {
     const dict: Map<string, number> = prepare(routeList);
     for (const route of routeList) {
       if (

package/src/analyses/ReflectControllerAnalyzer.ts

@@ -8,10 +8,12 @@ import { INestiaProject } from "../structures/INestiaProject";
 import { INestiaSdkInput } from "../structures/INestiaSdkInput";
 import { IReflectController } from "../structures/IReflectController";
 import { IReflectHttpOperation } from "../structures/IReflectHttpOperation";
+import { IReflectMcpOperation } from "../structures/IReflectMcpOperation";
 import { IReflectWebSocketOperation } from "../structures/IReflectWebSocketOperation";
 import { IOperationMetadata } from "../transformers/IOperationMetadata";
 import { ArrayUtil } from "../utils/ArrayUtil";
 import { ReflectHttpOperationAnalyzer } from "./ReflectHttpOperationAnalyzer";
+import { ReflectMcpOperationAnalyzer } from "./ReflectMcpOperationAnalyzer";
 import { ReflectMetadataAnalyzer } from "./ReflectMetadataAnalyzer";
 import { ReflectWebSocketOperationAnalyzer } from "./ReflectWebSocketOperationAnalyzer";
 
@@ -81,7 +83,12 @@ export namespace ReflectControllerAnalyzer {
         function: value,
         metadata,
       };
-      const child: IReflectHttpOperation | IReflectWebSocketOperation | null =
+      const child:
+        | IReflectHttpOperation
+        | IReflectWebSocketOperation
+        | IReflectMcpOperation
+        | null =
+        ReflectMcpOperationAnalyzer.analyze(next) ??
         ReflectWebSocketOperationAnalyzer.analyze(next) ??
         ReflectHttpOperationAnalyzer.analyze(next);
       if (child !== null) controller.operations.push(child);