MCP 도구로 선택한 tRPC 절차를 켭니다.

• tRPC v11 및 @modelcontextprotocol/server v2, MCP TypeScript SDK 사용
• stdio 또는 HTTP를 통한 도구
• 모든 도구 호출에 tRPC 컨텍스트 및 미들웨어 사용
• 텍스트, 이미지, 기타 MCP 콘텐츠로 변환
• 산출 schema를 가진 절차에서 구조화된 내용을 돌려보내십시오
• 다음에 마운트.js 및 mcp 핸들러와 다른 프레임 워크

왜 당신이 선택하는 절차?

MCP 도구는 언어 모델이 스스로 호출하기로 결정하는 것입니다. 그래서 모델을 사용하려는 절차 만 노출. 모델은 이름, 설명 및 입력 스키마를 기반으로 도구를 선택합니다. 각 노출된 절차에 대해 명확한 이름, 그것을 사용할 때의 설명, 그리고 .describe() 각 입력 필드에.

설치

@trpc/server 11 및 @modelcontextprotocol/server 2는 피어 의존성입니다. mcp-handler] 2를 설치하면 mcp 핸들러 어댑터를 사용합니다. Node.js 20 이상이 필요합니다.

사용법

1. tRPC 인스턴스에 McpMeta을 추가합니다.

2. 도구로 원하는 절차에 mcp를 사용.

입력은 zod 4.와 같은 Standard JSON Schema를 구현하는 validator의 객체 스키마가 있어야 합니다.

trpc-to-mcp

Turn the tRPC procedures you choose into MCP tools.

• Works with tRPC v11 and @modelcontextprotocol/server v2, the MCP TypeScript SDK
• Serve tools over stdio or HTTP
• Use the tRPC context and middlewares on every tool call
• Transform outputs into text, images, or other MCP content
• Return structured content from procedures with an output schema
• Mount on Next.js and other frameworks with mcp-handler

Install

pnpm add trpc-to-mcp @modelcontextprotocol/server

@trpc/server 11 and @modelcontextprotocol/server 2 are peer dependencies. Install mcp-handler 2 only if you use the mcp-handler adapter. Node.js 20 or later is required.

Usage

1. Add McpMeta to your tRPC instance.

import { initTRPC } from "@trpc/server";
import { type McpMeta } from "trpc-to-mcp";

const t = initTRPC.context().meta().create();

2. Enable mcp on the procedures you want as tools.

import { z } from "zod";

export const appRouter = t.router({
  hello: t.procedure
    .meta({
      mcp: {
        enabled: true,
        description: "Say hello to someone",
        // Optional. Defaults to the procedure path with dots replaced by
        // underscores, e.g. "hello" or "user_byId".
        name: "say_hello",
      },
    })
    .input(z.object({ name: z.string().describe("Who to greet") }))
    .query(({ input }) => `Hello ${input.name}`),
});

Inputs must be object schemas from a validator that implements Standard JSON Schema, such as zod 4.2 or later, ArkType, or Valibot with toStandardJsonSchema(). Chained .input() calls are merged into one tool input schema. Subscriptions can’t be tools.

tRPC validates input on every call, so your zod transforms and refinements run as usual. Errors thrown by a procedure, including TRPCError, come back to the client as a tool result with isError: true.

meta.mcp also takes title and annotations. Queries get readOnlyHint: true unless you set it yourself.

Serve your tools

createMcpServer returns an McpServer with your tools registered. You can register more tools, prompts, and resources on it.

Over stdio:

import { serveStdio } from "@modelcontextprotocol/server/stdio";
import { createMcpServer } from "trpc-to-mcp";

serveStdio(() =>
  createMcpServer({ name: "my-app", version: "1.0.0" }, appRouter, { db }),
);