@typia/mcp 12.0.0-dev.20260225

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# `@typia/mcp`
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+
+[MCP (Model Context Protocol)](https://modelcontextprotocol.io) integration for [`typia`](https://github.com/samchon/typia).
+
+Registers typia controllers as MCP tools with automatic validation.
+
+## Setup
+
+```bash
+npm install @typia/mcp @modelcontextprotocol/sdk
+npm install typia
+npx typia setup
+```
+
+## Usage
+
+### From TypeScript class
+
+```typescript
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerMcpControllers } from "@typia/mcp";
+import typia from "typia";
+
+const server: McpServer = new McpServer({
+  name: "my-server",
+  version: "1.0.0",
+});
+registerMcpControllers({
+  server,
+  controllers: [
+    typia.llm.controller<Calculator>("Calculator", new Calculator()),
+  ],
+});
+```
+
+### From OpenAPI document
+
+```typescript
+import { registerMcpControllers } from "@typia/mcp";
+import { HttpLlm } from "@typia/utils";
+
+registerMcpControllers({
+  server,
+  controllers: [
+    HttpLlm.controller({
+      name: "petStore",
+      document: yourOpenApiDocument,
+      connection: { host: "https://api.example.com" },
+    }),
+  ],
+});
+```
+
+## Features
+
+- No manual schema definition — generates everything from TypeScript types or OpenAPI
+- Automatic argument validation with LLM-friendly error feedback
+- Supports both class-based (`typia.llm.controller`) and HTTP-based (`HttpLlm.controller`) controllers
+- `preserve` option to coexist with `McpServer.registerTool()`

package/lib/index.d.ts

@@ -0,0 +1,60 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+/**
+ * Register MCP tools from controllers.
+ *
+ * Registers TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` as MCP tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns {@link IValidation.IFailure} formatted by
+ * {@link stringifyValidationFailure} so that LLM can correct them automatically.
+ * Below is an example of the validation error format:
+ *
+ * ```json
+ * {
+ *   "name": "John",
+ *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+ *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+ *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+ * }
+ * ```
+ *
+ * If you use `McpServer.registerTool()` instead, you have to define Zod schema,
+ * function name, and description string manually for each tool. Also, without
+ * typia's validation feedback, LLM cannot auto-correct its mistakes, which
+ * significantly degrades tool calling performance.
+ *
+ * @param props Registration properties
+ */
+export declare function registerMcpControllers(props: {
+    /**
+     * Target MCP server to register tools.
+     *
+     * Both {@link McpServer} and raw {@link Server} are supported. To combine with
+     * `McpServer.registerTool()`, set `preserve: true`.
+     */
+    server: McpServer | Server;
+    /**
+     * List of controllers to register as MCP tools.
+     *
+     * - {@link ILlmController}: from `typia.llm.controller<Class>()`, registers all
+     *   methods of the class as tools
+     * - {@link IHttpLlmController}: from `HttpLlm.controller()`, registers all
+     *   operations from OpenAPI document as tools
+     */
+    controllers: Array<ILlmController | IHttpLlmController>;
+    /**
+     * Preserve existing tools registered via `McpServer.registerTool()`.
+     *
+     * If `true`, typia tools coexist with existing McpServer tools. This uses MCP
+     * SDK's internal (private) API which may break on SDK updates.
+     *
+     * If `false`, typia tools completely replace the tool handlers, ignoring any
+     * tools registered via `McpServer.registerTool()`.
+     *
+     * @default false
+     */
+    preserve?: boolean | undefined;
+}): void;

package/lib/index.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMcpControllers = registerMcpControllers;
+const McpControllerRegistrar_1 = require("./internal/McpControllerRegistrar");
+/**
+ * Register MCP tools from controllers.
+ *
+ * Registers TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` as MCP tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns {@link IValidation.IFailure} formatted by
+ * {@link stringifyValidationFailure} so that LLM can correct them automatically.
+ * Below is an example of the validation error format:
+ *
+ * ```json
+ * {
+ *   "name": "John",
+ *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+ *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+ *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+ * }
+ * ```
+ *
+ * If you use `McpServer.registerTool()` instead, you have to define Zod schema,
+ * function name, and description string manually for each tool. Also, without
+ * typia's validation feedback, LLM cannot auto-correct its mistakes, which
+ * significantly degrades tool calling performance.
+ *
+ * @param props Registration properties
+ */
+function registerMcpControllers(props) {
+    return McpControllerRegistrar_1.McpControllerRegistrar.register(props);
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAiCA,wDAiCC;AA9DD,8EAA2E;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,sBAAsB,CAAC,KA+BtC;IACC,OAAO,+CAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/lib/index.mjs

@@ -0,0 +1,35 @@
+import { McpControllerRegistrar } from './internal/McpControllerRegistrar.mjs';
+
+/**
+ * Register MCP tools from controllers.
+ *
+ * Registers TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` as MCP tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns {@link IValidation.IFailure} formatted by
+ * {@link stringifyValidationFailure} so that LLM can correct them automatically.
+ * Below is an example of the validation error format:
+ *
+ * ```json
+ * {
+ *   "name": "John",
+ *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+ *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+ *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+ * }
+ * ```
+ *
+ * If you use `McpServer.registerTool()` instead, you have to define Zod schema,
+ * function name, and description string manually for each tool. Also, without
+ * typia's validation feedback, LLM cannot auto-correct its mistakes, which
+ * significantly degrades tool calling performance.
+ *
+ * @param props Registration properties
+ */
+function registerMcpControllers(props) {
+    return McpControllerRegistrar.register(props);
+}
+
+export { registerMcpControllers };
+//# sourceMappingURL=index.mjs.map

package/lib/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BG;AACG,SAAU,sBAAsB,CAAC,KA+BtC,EAAA;AACC,IAAA,OAAO,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC;AAC/C;;;;"}

package/lib/internal/McpControllerRegistrar.d.ts

@@ -0,0 +1,10 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+export declare namespace McpControllerRegistrar {
+    const register: (props: {
+        server: McpServer | Server;
+        controllers: Array<ILlmController | IHttpLlmController>;
+        preserve?: boolean | undefined;
+    }) => void;
+}

package/lib/internal/McpControllerRegistrar.js

@@ -0,0 +1,259 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpControllerRegistrar = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const utils_1 = require("@typia/utils");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+var McpControllerRegistrar;
+(function (McpControllerRegistrar) {
+    McpControllerRegistrar.register = (props) => {
+        var _a;
+        // McpServer wraps raw Server - we need raw Server for JSON Schema support
+        const server = "server" in props.server
+            ? props.server.server
+            : props.server;
+        // Build tool registry from controllers
+        const registry = new Map();
+        for (const controller of props.controllers) {
+            if (controller.protocol === "class") {
+                registerClassController(registry, controller);
+            }
+            else {
+                registerHttpController(registry, controller);
+            }
+        }
+        // Determine preserve mode (default: false)
+        const preserve = (_a = props.preserve) !== null && _a !== void 0 ? _a : false;
+        if (preserve) {
+            // PRESERVE MODE: Coexist with McpServer.registerTool()
+            // Uses MCP SDK internal API (_registeredTools, _toolHandlersInitialized)
+            registerWithPreserve(server, registry, props.server);
+        }
+        else {
+            // STANDALONE MODE: Typia tools only, no private API dependency
+            registerStandalone(server, registry);
+        }
+    };
+    /**
+     * Standalone registration without private API. Typia tools completely replace
+     * any existing tool handlers.
+     */
+    const registerStandalone = (server, registry) => {
+        // tools/list handler
+        server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
+            return ({
+                tools: Array.from(registry.values()).map((entry) => ({
+                    name: entry.function.name,
+                    description: entry.function.description,
+                    inputSchema: {
+                        type: "object",
+                        properties: entry.function.parameters.properties,
+                        required: entry.function.parameters.required,
+                        additionalProperties: false,
+                        $defs: entry.function.parameters.$defs,
+                    },
+                })),
+            });
+        }));
+        // tools/call handler
+        server.setRequestHandler(types_js_1.CallToolRequestSchema, (request) => __awaiter(this, void 0, void 0, function* () {
+            const name = request.params.name;
+            const args = request.params.arguments;
+            const entry = registry.get(name);
+            if (entry !== undefined) {
+                return handleToolCall(entry, args);
+            }
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+        }));
+    };
+    /**
+     * Preserve mode registration with private API. Coexists with tools registered
+     * via McpServer.registerTool().
+     */
+    const registerWithPreserve = (server, registry, originalServer) => {
+        // Get McpServer reference for coexistence with McpServer.registerTool()
+        const mcpServer = "server" in originalServer ? originalServer : null;
+        // Helper to get existing tools dynamically (supports tools registered after this call)
+        const getExistingTools = () => { var _a; 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return mcpServer ? ((_a = mcpServer._registeredTools) !== null && _a !== void 0 ? _a : {}) : {}; };
+        // Check for conflicts with existing McpServer tools at registration time
+        for (const pair of Object.entries(getExistingTools())) {
+            if (pair[1].enabled && registry.has(pair[0])) {
+                throw new Error(`Duplicate function name "${pair[0]}" between McpServer.registerTool() and controller "${registry.get(pair[0]).controller}"`);
+            }
+        }
+        // tools/list handler
+        server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => __awaiter(this, void 0, void 0, function* () {
+            const existingTools = getExistingTools();
+            return {
+                tools: [
+                    // Typia controller tools
+                    ...Array.from(registry.values()).map((entry) => {
+                        return {
+                            name: entry.function.name,
+                            description: entry.function.description,
+                            inputSchema: {
+                                type: "object",
+                                properties: entry.function.parameters.properties,
+                                required: entry.function.parameters.required,
+                                additionalProperties: false,
+                                $defs: entry.function.parameters.$defs,
+                            },
+                        };
+                    }),
+                    // Existing McpServer tools
+                    ...Object.entries(existingTools)
+                        .filter((pair) => !registry.has(pair[0]) && pair[1].enabled)
+                        .map((pair) => {
+                        return {
+                            name: pair[0],
+                            description: pair[1].description,
+                            inputSchema: convertZodToJsonSchema(pair[1].inputSchema),
+                        };
+                    }),
+                ],
+            };
+        }));
+        // tools/call handler
+        server.setRequestHandler(types_js_1.CallToolRequestSchema, (request, extra) => __awaiter(this, void 0, void 0, function* () {
+            const name = request.params.name;
+            const args = request.params.arguments;
+            // Check typia registry first
+            const entry = registry.get(name);
+            if (entry !== undefined) {
+                return handleToolCall(entry, args);
+            }
+            // Fall back to existing McpServer tools
+            const existingTools = getExistingTools();
+            const existingTool = existingTools[name];
+            if (existingTool && existingTool.enabled) {
+                return existingTool.handler(args, extra);
+            }
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+        }));
+        // Mark handlers as initialized to prevent McpServer from overwriting
+        if (mcpServer) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mcpServer._toolHandlersInitialized = true;
+        }
+    };
+    const registerClassController = (registry, controller) => {
+        const execute = controller.execute;
+        for (const func of controller.application.functions) {
+            const existing = registry.get(func.name);
+            if (existing !== undefined) {
+                throw new Error(`Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`);
+            }
+            const method = execute[func.name];
+            if (typeof method !== "function") {
+                throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
+            }
+            registry.set(func.name, {
+                controller: controller.name,
+                function: func,
+                execute: (args) => __awaiter(this, void 0, void 0, function* () { return method.call(execute, args); }),
+            });
+        }
+    };
+    const registerHttpController = (registry, controller) => {
+        const application = controller.application;
+        const connection = controller.connection;
+        for (const func of application.functions) {
+            const existing = registry.get(func.name);
+            if (existing !== undefined) {
+                throw new Error(`Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`);
+            }
+            registry.set(func.name, {
+                controller: controller.name,
+                function: func,
+                execute: (args) => __awaiter(this, void 0, void 0, function* () {
+                    if (controller.execute !== undefined) {
+                        const response = yield controller.execute({
+                            connection,
+                            application,
+                            function: func,
+                            arguments: args,
+                        });
+                        return response.body;
+                    }
+                    return utils_1.HttpLlm.execute({
+                        application,
+                        function: func,
+                        connection,
+                        input: args,
+                    });
+                }),
+            });
+        }
+    };
+    const handleToolCall = (entry, args) => __awaiter(this, void 0, void 0, function* () {
+        const validation = entry.function.validate(args);
+        if (!validation.success) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: (0, utils_1.stringifyValidationFailure)(validation),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = yield entry.execute(validation.data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result === undefined
+                            ? "Success"
+                            : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: error instanceof Error
+                            ? `${error.name}: ${error.message}`
+                            : String(error),
+                    },
+                ],
+            };
+        }
+    });
+    const convertZodToJsonSchema = (zodSchema) => {
+        if (zodSchema === undefined) {
+            return { type: "object", properties: {} };
+        }
+        // @todo: error TS2589: Type instantiation is excessively deep and possibly infinite.
+        const converted = zod_to_json_schema_1.zodToJsonSchema(zodSchema);
+        if (typeof converted === "object" &&
+            "type" in converted &&
+            converted.type === "object") {
+            return converted;
+        }
+        return { type: "object", properties: {} };
+    };
+})(McpControllerRegistrar || (exports.McpControllerRegistrar = McpControllerRegistrar = {}));
+//# sourceMappingURL=McpControllerRegistrar.js.map

package/lib/internal/McpControllerRegistrar.js.map

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

package/lib/internal/McpControllerRegistrar.mjs

@@ -0,0 +1,247 @@
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { HttpLlm, stringifyValidationFailure } from '@typia/utils';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+
+var McpControllerRegistrar;
+(function (McpControllerRegistrar) {
+    McpControllerRegistrar.register = (props) => {
+        // McpServer wraps raw Server - we need raw Server for JSON Schema support
+        const server = "server" in props.server
+            ? props.server.server
+            : props.server;
+        // Build tool registry from controllers
+        const registry = new Map();
+        for (const controller of props.controllers) {
+            if (controller.protocol === "class") {
+                registerClassController(registry, controller);
+            }
+            else {
+                registerHttpController(registry, controller);
+            }
+        }
+        // Determine preserve mode (default: false)
+        const preserve = props.preserve ?? false;
+        if (preserve) {
+            // PRESERVE MODE: Coexist with McpServer.registerTool()
+            // Uses MCP SDK internal API (_registeredTools, _toolHandlersInitialized)
+            registerWithPreserve(server, registry, props.server);
+        }
+        else {
+            // STANDALONE MODE: Typia tools only, no private API dependency
+            registerStandalone(server, registry);
+        }
+    };
+    /**
+     * Standalone registration without private API. Typia tools completely replace
+     * any existing tool handlers.
+     */
+    const registerStandalone = (server, registry) => {
+        // tools/list handler
+        server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: Array.from(registry.values()).map((entry) => ({
+                name: entry.function.name,
+                description: entry.function.description,
+                inputSchema: {
+                    type: "object",
+                    properties: entry.function.parameters.properties,
+                    required: entry.function.parameters.required,
+                    additionalProperties: false,
+                    $defs: entry.function.parameters.$defs,
+                },
+            })),
+        }));
+        // tools/call handler
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const name = request.params.name;
+            const args = request.params.arguments;
+            const entry = registry.get(name);
+            if (entry !== undefined) {
+                return handleToolCall(entry, args);
+            }
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+        });
+    };
+    /**
+     * Preserve mode registration with private API. Coexists with tools registered
+     * via McpServer.registerTool().
+     */
+    const registerWithPreserve = (server, registry, originalServer) => {
+        // Get McpServer reference for coexistence with McpServer.registerTool()
+        const mcpServer = "server" in originalServer ? originalServer : null;
+        // Helper to get existing tools dynamically (supports tools registered after this call)
+        const getExistingTools = () => 
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        mcpServer ? (mcpServer._registeredTools ?? {}) : {};
+        // Check for conflicts with existing McpServer tools at registration time
+        for (const pair of Object.entries(getExistingTools())) {
+            if (pair[1].enabled && registry.has(pair[0])) {
+                throw new Error(`Duplicate function name "${pair[0]}" between McpServer.registerTool() and controller "${registry.get(pair[0]).controller}"`);
+            }
+        }
+        // tools/list handler
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const existingTools = getExistingTools();
+            return {
+                tools: [
+                    // Typia controller tools
+                    ...Array.from(registry.values()).map((entry) => {
+                        return {
+                            name: entry.function.name,
+                            description: entry.function.description,
+                            inputSchema: {
+                                type: "object",
+                                properties: entry.function.parameters.properties,
+                                required: entry.function.parameters.required,
+                                additionalProperties: false,
+                                $defs: entry.function.parameters.$defs,
+                            },
+                        };
+                    }),
+                    // Existing McpServer tools
+                    ...Object.entries(existingTools)
+                        .filter((pair) => !registry.has(pair[0]) && pair[1].enabled)
+                        .map((pair) => {
+                        return {
+                            name: pair[0],
+                            description: pair[1].description,
+                            inputSchema: convertZodToJsonSchema(pair[1].inputSchema),
+                        };
+                    }),
+                ],
+            };
+        });
+        // tools/call handler
+        server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+            const name = request.params.name;
+            const args = request.params.arguments;
+            // Check typia registry first
+            const entry = registry.get(name);
+            if (entry !== undefined) {
+                return handleToolCall(entry, args);
+            }
+            // Fall back to existing McpServer tools
+            const existingTools = getExistingTools();
+            const existingTool = existingTools[name];
+            if (existingTool && existingTool.enabled) {
+                return existingTool.handler(args, extra);
+            }
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            };
+        });
+        // Mark handlers as initialized to prevent McpServer from overwriting
+        if (mcpServer) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            mcpServer._toolHandlersInitialized = true;
+        }
+    };
+    const registerClassController = (registry, controller) => {
+        const execute = controller.execute;
+        for (const func of controller.application.functions) {
+            const existing = registry.get(func.name);
+            if (existing !== undefined) {
+                throw new Error(`Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`);
+            }
+            const method = execute[func.name];
+            if (typeof method !== "function") {
+                throw new Error(`Method "${func.name}" not found on controller "${controller.name}"`);
+            }
+            registry.set(func.name, {
+                controller: controller.name,
+                function: func,
+                execute: async (args) => method.call(execute, args),
+            });
+        }
+    };
+    const registerHttpController = (registry, controller) => {
+        const application = controller.application;
+        const connection = controller.connection;
+        for (const func of application.functions) {
+            const existing = registry.get(func.name);
+            if (existing !== undefined) {
+                throw new Error(`Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`);
+            }
+            registry.set(func.name, {
+                controller: controller.name,
+                function: func,
+                execute: async (args) => {
+                    if (controller.execute !== undefined) {
+                        const response = await controller.execute({
+                            connection,
+                            application,
+                            function: func,
+                            arguments: args,
+                        });
+                        return response.body;
+                    }
+                    return HttpLlm.execute({
+                        application,
+                        function: func,
+                        connection,
+                        input: args,
+                    });
+                },
+            });
+        }
+    };
+    const handleToolCall = async (entry, args) => {
+        const validation = entry.function.validate(args);
+        if (!validation.success) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: stringifyValidationFailure(validation),
+                    },
+                ],
+            };
+        }
+        try {
+            const result = await entry.execute(validation.data);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result === undefined
+                            ? "Success"
+                            : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: error instanceof Error
+                            ? `${error.name}: ${error.message}`
+                            : String(error),
+                    },
+                ],
+            };
+        }
+    };
+    const convertZodToJsonSchema = (zodSchema) => {
+        if (zodSchema === undefined) {
+            return { type: "object", properties: {} };
+        }
+        // @todo: error TS2589: Type instantiation is excessively deep and possibly infinite.
+        const converted = zodToJsonSchema(zodSchema);
+        if (typeof converted === "object" &&
+            "type" in converted &&
+            converted.type === "object") {
+            return converted;
+        }
+        return { type: "object", properties: {} };
+    };
+})(McpControllerRegistrar || (McpControllerRegistrar = {}));
+
+export { McpControllerRegistrar };
+//# sourceMappingURL=McpControllerRegistrar.mjs.map

package/lib/internal/McpControllerRegistrar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpControllerRegistrar.mjs","sources":["../../src/internal/McpControllerRegistrar.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@typia/mcp",
+  "version": "12.0.0-dev.20260225",
+  "description": "MCP (Model Context Protocol) integration for typia",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.mjs",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/typia"
+  },
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/typia/issues"
+  },
+  "homepage": "https://typia.io",
+  "dependencies": {
+    "zod-to-json-schema": ">=3.24.0",
+    "@typia/interface": "^12.0.0-dev.20260225",
+    "@typia/utils": "^12.0.0-dev.20260225"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rimraf": "^6.1.2",
+    "rollup": "^4.56.0",
+    "rollup-plugin-auto-external": "^2.0.0",
+    "rollup-plugin-node-externals": "^8.1.2",
+    "tinyglobby": "^0.2.12",
+    "typescript": "~5.9.3",
+    "zod": "^3.25.0"
+  },
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "README.md",
+    "package.json",
+    "lib",
+    "src"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typia",
+    "llm",
+    "llm-function-calling",
+    "ai",
+    "claude",
+    "openai",
+    "chatgpt",
+    "gemini",
+    "validation",
+    "json-schema",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf lib && tsc && rollup -c",
+    "dev": "rimraf lib && tsc --watch"
+  },
+  "module": "lib/index.mjs",
+  "types": "lib/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,67 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IHttpLlmController, ILlmController } from "@typia/interface";
+
+import { McpControllerRegistrar } from "./internal/McpControllerRegistrar";
+
+/**
+ * Register MCP tools from controllers.
+ *
+ * Registers TypeScript class methods via `typia.llm.controller<Class>()` or
+ * OpenAPI operations via `HttpLlm.controller()` as MCP tools.
+ *
+ * Every tool call is validated by typia. If LLM provides invalid arguments,
+ * returns {@link IValidation.IFailure} formatted by
+ * {@link stringifyValidationFailure} so that LLM can correct them automatically.
+ * Below is an example of the validation error format:
+ *
+ * ```json
+ * {
+ *   "name": "John",
+ *   "age": "twenty", // ❌ [{"path":"$input.age","expected":"number & Type<\"uint32\">"}]
+ *   "email": "not-an-email", // ❌ [{"path":"$input.email","expected":"string & Format<\"email\">"}]
+ *   "hobbies": "reading" // ❌ [{"path":"$input.hobbies","expected":"Array<string>"}]
+ * }
+ * ```
+ *
+ * If you use `McpServer.registerTool()` instead, you have to define Zod schema,
+ * function name, and description string manually for each tool. Also, without
+ * typia's validation feedback, LLM cannot auto-correct its mistakes, which
+ * significantly degrades tool calling performance.
+ *
+ * @param props Registration properties
+ */
+export function registerMcpControllers(props: {
+  /**
+   * Target MCP server to register tools.
+   *
+   * Both {@link McpServer} and raw {@link Server} are supported. To combine with
+   * `McpServer.registerTool()`, set `preserve: true`.
+   */
+  server: McpServer | Server;
+
+  /**
+   * List of controllers to register as MCP tools.
+   *
+   * - {@link ILlmController}: from `typia.llm.controller<Class>()`, registers all
+   *   methods of the class as tools
+   * - {@link IHttpLlmController}: from `HttpLlm.controller()`, registers all
+   *   operations from OpenAPI document as tools
+   */
+  controllers: Array<ILlmController | IHttpLlmController>;
+
+  /**
+   * Preserve existing tools registered via `McpServer.registerTool()`.
+   *
+   * If `true`, typia tools coexist with existing McpServer tools. This uses MCP
+   * SDK's internal (private) API which may break on SDK updates.
+   *
+   * If `false`, typia tools completely replace the tool handlers, ignoring any
+   * tools registered via `McpServer.registerTool()`.
+   *
+   * @default false
+   */
+  preserve?: boolean | undefined;
+}): void {
+  return McpControllerRegistrar.register(props);
+}

package/src/internal/McpControllerRegistrar.ts

@@ -0,0 +1,329 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import {
+  CallToolRequestSchema,
+  CallToolResult,
+  ListToolsRequestSchema,
+  Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+import {
+  IHttpLlmController,
+  IHttpLlmFunction,
+  ILlmController,
+  ILlmFunction,
+  IValidation,
+} from "@typia/interface";
+import { HttpLlm, stringifyValidationFailure } from "@typia/utils";
+import { ZodObject, ZodType } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+
+export namespace McpControllerRegistrar {
+  export const register = (props: {
+    server: McpServer | Server;
+    controllers: Array<ILlmController | IHttpLlmController>;
+    preserve?: boolean | undefined;
+  }): void => {
+    // McpServer wraps raw Server - we need raw Server for JSON Schema support
+    const server: Server =
+      "server" in props.server
+        ? (props.server as McpServer).server
+        : (props.server as Server);
+
+    // Build tool registry from controllers
+    const registry: Map<string, IToolEntry> = new Map();
+
+    for (const controller of props.controllers) {
+      if (controller.protocol === "class") {
+        registerClassController(registry, controller);
+      } else {
+        registerHttpController(registry, controller);
+      }
+    }
+
+    // Determine preserve mode (default: false)
+    const preserve: boolean = props.preserve ?? false;
+
+    if (preserve) {
+      // PRESERVE MODE: Coexist with McpServer.registerTool()
+      // Uses MCP SDK internal API (_registeredTools, _toolHandlersInitialized)
+      registerWithPreserve(server, registry, props.server);
+    } else {
+      // STANDALONE MODE: Typia tools only, no private API dependency
+      registerStandalone(server, registry);
+    }
+  };
+
+  /**
+   * Standalone registration without private API. Typia tools completely replace
+   * any existing tool handlers.
+   */
+  const registerStandalone = (
+    server: Server,
+    registry: Map<string, IToolEntry>,
+  ): void => {
+    // tools/list handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+      tools: Array.from(registry.values()).map((entry: IToolEntry) => ({
+        name: entry.function.name,
+        description: entry.function.description,
+        inputSchema: {
+          type: "object" as const,
+          properties: entry.function.parameters.properties,
+          required: entry.function.parameters.required,
+          additionalProperties: false,
+          $defs: entry.function.parameters.$defs,
+        },
+      })),
+    }));
+
+    // tools/call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const name: string = request.params.name;
+      const args: Record<string, unknown> | undefined =
+        request.params.arguments;
+
+      const entry: IToolEntry | undefined = registry.get(name);
+      if (entry !== undefined) {
+        return handleToolCall(entry, args);
+      }
+
+      return {
+        isError: true,
+        content: [{ type: "text" as const, text: `Unknown tool: ${name}` }],
+      };
+    });
+  };
+
+  /**
+   * Preserve mode registration with private API. Coexists with tools registered
+   * via McpServer.registerTool().
+   */
+  const registerWithPreserve = (
+    server: Server,
+    registry: Map<string, IToolEntry>,
+    originalServer: McpServer | Server,
+  ): void => {
+    // Get McpServer reference for coexistence with McpServer.registerTool()
+    const mcpServer: McpServer | null =
+      "server" in originalServer ? (originalServer as McpServer) : null;
+
+    // Helper to get existing tools dynamically (supports tools registered after this call)
+    const getExistingTools = (): Record<string, any> =>
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      mcpServer ? ((mcpServer as any)._registeredTools ?? {}) : {};
+
+    // Check for conflicts with existing McpServer tools at registration time
+    for (const pair of Object.entries(getExistingTools())) {
+      if (pair[1].enabled && registry.has(pair[0])) {
+        throw new Error(
+          `Duplicate function name "${pair[0]}" between McpServer.registerTool() and controller "${registry.get(pair[0])!.controller}"`,
+        );
+      }
+    }
+
+    // tools/list handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+      const existingTools: Record<string, any> = getExistingTools();
+      return {
+        tools: [
+          // Typia controller tools
+          ...Array.from(registry.values()).map((entry: IToolEntry) => {
+            return {
+              name: entry.function.name,
+              description: entry.function.description,
+              inputSchema: {
+                type: "object" as const,
+                properties: entry.function.parameters.properties,
+                required: entry.function.parameters.required,
+                additionalProperties: false,
+                $defs: entry.function.parameters.$defs,
+              },
+            } satisfies Tool;
+          }),
+          // Existing McpServer tools
+          ...Object.entries(existingTools)
+            .filter(
+              (pair: [string, any]) =>
+                !registry.has(pair[0]) && pair[1].enabled,
+            )
+            .map((pair: [string, any]) => {
+              return {
+                name: pair[0],
+                description: pair[1].description,
+                inputSchema: convertZodToJsonSchema(pair[1].inputSchema),
+              } satisfies Tool;
+            }),
+        ],
+      };
+    });
+
+    // tools/call handler
+    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+      const name: string = request.params.name;
+      const args: Record<string, unknown> | undefined =
+        request.params.arguments;
+
+      // Check typia registry first
+      const entry: IToolEntry | undefined = registry.get(name);
+      if (entry !== undefined) {
+        return handleToolCall(entry, args);
+      }
+
+      // Fall back to existing McpServer tools
+      const existingTools: Record<string, any> = getExistingTools();
+      const existingTool: any = existingTools[name];
+      if (existingTool && existingTool.enabled) {
+        return existingTool.handler(args, extra);
+      }
+
+      return {
+        isError: true,
+        content: [{ type: "text" as const, text: `Unknown tool: ${name}` }],
+      };
+    });
+
+    // Mark handlers as initialized to prevent McpServer from overwriting
+    if (mcpServer) {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      (mcpServer as any)._toolHandlersInitialized = true;
+    }
+  };
+
+  const registerClassController = (
+    registry: Map<string, IToolEntry>,
+    controller: ILlmController,
+  ): void => {
+    const execute: Record<string, unknown> = controller.execute;
+    for (const func of controller.application.functions) {
+      const existing: IToolEntry | undefined = registry.get(func.name);
+      if (existing !== undefined) {
+        throw new Error(
+          `Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`,
+        );
+      }
+
+      const method: unknown = execute[func.name];
+      if (typeof method !== "function") {
+        throw new Error(
+          `Method "${func.name}" not found on controller "${controller.name}"`,
+        );
+      }
+
+      registry.set(func.name, {
+        controller: controller.name,
+        function: func,
+        execute: async (args: unknown) => method.call(execute, args),
+      });
+    }
+  };
+
+  const registerHttpController = (
+    registry: Map<string, IToolEntry>,
+    controller: IHttpLlmController,
+  ): void => {
+    const application: IHttpLlmController["application"] =
+      controller.application;
+    const connection: IHttpLlmController["connection"] = controller.connection;
+
+    for (const func of application.functions) {
+      const existing: IToolEntry | undefined = registry.get(func.name);
+      if (existing !== undefined) {
+        throw new Error(
+          `Duplicate function name "${func.name}" between controllers "${existing.controller}" and "${controller.name}"`,
+        );
+      }
+      registry.set(func.name, {
+        controller: controller.name,
+        function: func,
+        execute: async (args: unknown) => {
+          if (controller.execute !== undefined) {
+            const response = await controller.execute({
+              connection,
+              application,
+              function: func,
+              arguments: args as object,
+            });
+            return response.body;
+          }
+          return HttpLlm.execute({
+            application,
+            function: func,
+            connection,
+            input: args as object,
+          });
+        },
+      });
+    }
+  };
+
+  const handleToolCall = async (
+    entry: IToolEntry,
+    args: unknown,
+  ): Promise<CallToolResult> => {
+    const validation: IValidation<unknown> = entry.function.validate(args);
+    if (!validation.success) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text" as const,
+            text: stringifyValidationFailure(validation),
+          },
+        ],
+      };
+    }
+
+    try {
+      const result: unknown = await entry.execute(validation.data);
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text:
+              result === undefined
+                ? "Success"
+                : JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      return {
+        isError: true,
+        content: [
+          {
+            type: "text" as const,
+            text:
+              error instanceof Error
+                ? `${error.name}: ${error.message}`
+                : String(error),
+          },
+        ],
+      };
+    }
+  };
+
+  const convertZodToJsonSchema = (
+    zodSchema: ZodType | ZodObject<any> | undefined,
+  ): Tool["inputSchema"] => {
+    if (zodSchema === undefined) {
+      return { type: "object", properties: {} };
+    }
+
+    // @todo: error TS2589: Type instantiation is excessively deep and possibly infinite.
+    const converted: object = (zodToJsonSchema as any)(zodSchema);
+    if (
+      typeof converted === "object" &&
+      "type" in converted &&
+      converted.type === "object"
+    ) {
+      return converted as Tool["inputSchema"];
+    }
+    return { type: "object", properties: {} };
+  };
+}
+
+interface IToolEntry {
+  controller: string;
+  function: ILlmFunction | IHttpLlmFunction;
+  execute: (args: unknown) => Promise<unknown>;
+}