@typia/mcp

MCP (Model Context Protocol) integration for typia.

Registers typia controllers as MCP tools with automatic validation.

Setup

npm install @typia/mcp @modelcontextprotocol/sdk
npm install typia
npx typia setup
Copy

Usage

From TypeScript class

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()),
  ],
});
Copy

From OpenAPI document

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" },
    }),
  ],
});
Copy

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()