trpc-to-mcp 1.0.0 → 1.1.0

package/.github/workflows/publish.yml

@@ -30,7 +30,7 @@ jobs:
         id: changesets
         uses: changesets/action@v1
         with:
-          publish: pnpm run release --access public
+          publish: pnpm run release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.prettierrc

@@ -0,0 +1,12 @@
+{
+  "importOrder": [
+    "<BUILTIN_MODULES>",
+    "<THIRD_PARTY_MODULES>",
+    "",
+    "^[../]",
+    "^[./]"
+  ],
+  "importOrderParserPlugins": ["typescript", "jsx", "decorators-legacy"],
+  "importOrderCaseSensitive": true,
+  "plugins": ["@ianvs/prettier-plugin-sort-imports"]
+}

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # trpc-to-mcp
 
+## 1.1.0
+
+### Minor Changes
+
+- a9f1c69: Implement @vercel/mcp-handler adapter for trpc-to-mcp
+
 ## 1.0.0
 
 ### Major Changes

package/package.json

@@ -1,25 +1,72 @@
 {
   "name": "trpc-to-mcp",
   "license": "MIT",
-  "version": "1.0.0",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
+  "version": "1.1.0",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./server": {
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.mjs"
+      },
+      "require": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      }
+    },
+    "./tools": {
+      "import": {
+        "types": "./dist/tools.d.ts",
+        "default": "./dist/tools.mjs"
+      },
+      "require": {
+        "types": "./dist/tools.d.ts",
+        "default": "./dist/tools.js"
+      }
+    },
+    "./adapter/vercel-mcp-adapter": {
+      "import": {
+        "types": "./dist/adapter/vercel-mcp-adapter.d.ts",
+        "default": "./dist/adapter/vercel-mcp-adapter.mjs"
+      },
+      "require": {
+        "types": "./dist/adapter/vercel-mcp-adapter.d.ts",
+        "default": "./dist/adapter/vercel-mcp-adapter.js"
+      }
+    }
+  },
   "devDependencies": {
     "@changesets/cli": "^2.29.5",
+    "@ianvs/prettier-plugin-sort-imports": "^4.6.0",
+    "prettier": "^3.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
     "@trpc/server": "^11.4.4",
+    "better-auth": "^1.3.4",
+    "mcp-handler": "^1.0.1",
     "zod": "^4.0.15"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.2"
   },
   "scripts": {
-    "build": "tsup ./src/index.ts --format cjs,esm --dts",
+    "build": "tsup --config tsup.config.ts",
     "release": "pnpm run build && changeset publish",
+    "format": "prettier --write \"**/*.{ts,tsx,css,md}\"",
     "lint": "tsc"
   }
 }

package/src/adapters/vercel-mcp-adapter.ts

@@ -0,0 +1,53 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type {
+  AnyRootTypes,
+  MaybePromise,
+  Router,
+  RouterRecord,
+} from "@trpc/server/unstable-core-do-not-import";
+import { createMcpHandler } from "mcp-handler";
+
+import { setRequestHandler } from "../server";
+import { extractToolsFromProcedures } from "../tools";
+
+export type VercelMcpHandler = ReturnType<typeof createMcpHandler>;
+export type McpServerOptions = Parameters<typeof createMcpHandler>[1];
+export type McpHandlerConfig = Parameters<typeof createMcpHandler>[2];
+
+export function trpcToMcpHandler<
+  TRoot extends AnyRootTypes,
+  TRecord extends RouterRecord,
+>(
+  appRouter: Router<TRoot, TRecord>,
+  ctx: TRoot["ctx"] | (() => MaybePromise<TRoot["ctx"]>),
+  handlerOptions: {
+    config: McpHandlerConfig;
+    serverOptions?: McpServerOptions;
+    callback?: (server: Server) => unknown;
+  },
+) {
+  const { serverOptions, config, callback } = handlerOptions;
+
+  const tools = extractToolsFromProcedures(appRouter);
+  const trpcCaller = appRouter.createCaller(ctx);
+
+  const handler = createMcpHandler(
+    (server) => {
+      setRequestHandler(server.server, tools, trpcCaller);
+
+      if (typeof callback === "function") {
+        callback(server.server);
+      }
+    },
+    {
+      // Leave it empty because we list tools manually
+      capabilities: {
+        tools: {},
+      },
+      ...serverOptions,
+    },
+    config,
+  );
+
+  return handler;
+}

package/src/server.ts

@@ -1,38 +1,25 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import {
   CallToolRequestSchema,
-  type Implementation,
   ListToolsRequestSchema,
+  type Implementation,
 } from "@modelcontextprotocol/sdk/types.js";
 import type {
   AnyProcedure,
   AnyRootTypes,
+  DecorateRouterRecord,
+  MaybePromise,
   Router,
   RouterRecord,
 } from "@trpc/server/unstable-core-do-not-import";
 
-import { extractToolsFromProcedures } from "./tools";
-
-type MaybePromise<T> = Promise<T> | T;
+import { extractToolsFromProcedures, type McpTool } from "./tools";
 
-export function createMcpServer<
-  TRoot extends AnyRootTypes,
-  TRecord extends RouterRecord
->(
-  implementation: Implementation,
-  appRouter: Router<TRoot, TRecord>,
-  ctx: TRoot["ctx"] | (() => MaybePromise<TRoot["ctx"]>)
+export function setRequestHandler<TRecord extends RouterRecord>(
+  server: Server,
+  tools: McpTool[],
+  trpcCaller: DecorateRouterRecord<TRecord>,
 ) {
-  const tools = extractToolsFromProcedures(appRouter);
-  const trpcCaller = appRouter.createCaller(ctx);
-
-  const server = new Server(implementation, {
-    capabilities: {
-      // Leave it empty because we list tools manually
-      tools: {},
-    },
-  });
-
   // List all of the available tools
   server.setRequestHandler(ListToolsRequestSchema, () => ({ tools }));
 
@@ -50,7 +37,7 @@ export function createMcpServer<
     const procedure: AnyProcedure = tool.pathInRouter.reduce(
       // @ts-expect-error path in router
       (acc, part) => acc?.[part],
-      trpcCaller
+      trpcCaller,
     );
 
     // @ts-expect-error path in router
@@ -61,3 +48,26 @@ export function createMcpServer<
     };
   });
 }
+
+export function createMcpServer<
+  TRoot extends AnyRootTypes,
+  TRecord extends RouterRecord,
+>(
+  implementation: Implementation,
+  appRouter: Router<TRoot, TRecord>,
+  ctx: TRoot["ctx"] | (() => MaybePromise<TRoot["ctx"]>),
+) {
+  const tools = extractToolsFromProcedures(appRouter);
+  const trpcCaller = appRouter.createCaller(ctx);
+
+  const server = new Server(implementation, {
+    capabilities: {
+      // Leave it empty because we list tools manually
+      tools: {},
+    },
+  });
+
+  setRequestHandler(server, tools, trpcCaller);
+
+  return server;
+}

package/src/tools.ts

@@ -24,7 +24,7 @@ export function mergeInputs(inputs: z.ZodObject[]) {
 
 export function extractToolsFromProcedures<
   TRoot extends AnyRootTypes,
-  TRecord extends RouterRecord
+  TRecord extends RouterRecord,
 >(appRouter: Router<TRoot, TRecord>, currentPath: string[] = []) {
   const tools: McpTool[] = [];
   const procedures = Object.entries(appRouter._def.procedures);
@@ -57,7 +57,7 @@ export function extractToolsFromProcedures<
         } else {
           console.error(
             "[TRPC-TO-MCP] Procedure has no object schema",
-            pathInRouter
+            pathInRouter,
           );
         }
       } else {

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: [
+    "src/index.ts",
+    "src/server.ts",
+    "src/tools.ts",
+    "src/adapters/vercel-mcp-adapter.ts",
+  ],
+  format: ["esm", "cjs"],
+  dts: true,
+});

package/dist/index.d.mts

@@ -1,17 +0,0 @@
-import { Implementation } from '@modelcontextprotocol/sdk/types.js';
-import { AnyRootTypes, RouterRecord, Router } from '@trpc/server/unstable-core-do-not-import';
-import { z } from 'zod/v4';
-
-type MaybePromise<T> = Promise<T> | T;
-declare function createMcpServer<TRoot extends AnyRootTypes, TRecord extends RouterRecord>(implementation: Implementation, appRouter: Router<TRoot, TRecord>, ctx: TRoot["ctx"] | (() => MaybePromise<TRoot["ctx"]>)): void;
-
-type McpTool = {
-    name: string;
-    description: string;
-    pathInRouter: string[];
-    inputSchema?: z.core.JSONSchema.JSONSchema;
-};
-declare function mergeInputs(inputs: z.ZodObject[]): z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>;
-declare function extractToolsFromProcedures<TRoot extends AnyRootTypes, TRecord extends RouterRecord>(appRouter: Router<TRoot, TRecord>, currentPath?: string[]): McpTool[];
-
-export { type McpTool, createMcpServer, extractToolsFromProcedures, mergeInputs };

package/dist/index.d.ts

@@ -1,17 +0,0 @@
-import { Implementation } from '@modelcontextprotocol/sdk/types.js';
-import { AnyRootTypes, RouterRecord, Router } from '@trpc/server/unstable-core-do-not-import';
-import { z } from 'zod/v4';
-
-type MaybePromise<T> = Promise<T> | T;
-declare function createMcpServer<TRoot extends AnyRootTypes, TRecord extends RouterRecord>(implementation: Implementation, appRouter: Router<TRoot, TRecord>, ctx: TRoot["ctx"] | (() => MaybePromise<TRoot["ctx"]>)): void;
-
-type McpTool = {
-    name: string;
-    description: string;
-    pathInRouter: string[];
-    inputSchema?: z.core.JSONSchema.JSONSchema;
-};
-declare function mergeInputs(inputs: z.ZodObject[]): z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>;
-declare function extractToolsFromProcedures<TRoot extends AnyRootTypes, TRecord extends RouterRecord>(appRouter: Router<TRoot, TRecord>, currentPath?: string[]): McpTool[];
-
-export { type McpTool, createMcpServer, extractToolsFromProcedures, mergeInputs };

package/dist/index.js

@@ -1,113 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  createMcpServer: () => createMcpServer,
-  extractToolsFromProcedures: () => extractToolsFromProcedures,
-  mergeInputs: () => mergeInputs
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/server.ts
-var import_server = require("@modelcontextprotocol/sdk/server/index.js");
-var import_types = require("@modelcontextprotocol/sdk/types.js");
-
-// src/tools.ts
-var import_v4 = require("zod/v4");
-function mergeInputs(inputs) {
-  return inputs.reduce((acc, input) => {
-    return acc.extend(input.shape);
-  }, import_v4.z.object());
-}
-function extractToolsFromProcedures(appRouter, currentPath = []) {
-  const tools = [];
-  const procedures = Object.entries(appRouter._def.procedures);
-  for (const [name, procedure] of procedures) {
-    if (procedure._def && "inputs" in procedure._def) {
-      const inputs = procedure._def.inputs;
-      const schema = inputs.length > 1 ? mergeInputs(inputs) : inputs[0];
-      const meta = procedure._def.meta;
-      if (!meta || !meta?.mcp?.enabled) {
-        continue;
-      }
-      const pathInRouter = [...currentPath, ...name.split(".")];
-      const tool = {
-        name: meta?.mcp?.name ?? name.replace(/\./g, "_"),
-        description: meta?.mcp?.description ?? "",
-        pathInRouter
-      };
-      if (schema) {
-        const jsonSchema = import_v4.z.toJSONSchema(schema, {
-          unrepresentable: "any"
-        });
-        if (jsonSchema.type === "object") {
-          const { type, properties = {}, required = [] } = jsonSchema;
-          tool.inputSchema = { type, properties, required };
-        } else {
-          console.error(
-            "[TRPC-TO-MCP] Procedure has no object schema",
-            pathInRouter
-          );
-        }
-      } else {
-        const jsonSchema = import_v4.z.toJSONSchema(import_v4.z.object());
-        tool.inputSchema = jsonSchema;
-      }
-      tools.push(tool);
-    }
-  }
-  return tools;
-}
-
-// src/server.ts
-function createMcpServer(implementation, appRouter, ctx) {
-  const tools = extractToolsFromProcedures(appRouter);
-  const trpcCaller = appRouter.createCaller(ctx);
-  const server = new import_server.Server(implementation, {
-    capabilities: {
-      // Leave it empty because we list tools manually
-      tools: {}
-    }
-  });
-  server.setRequestHandler(import_types.ListToolsRequestSchema, () => ({ tools }));
-  server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    const tool = tools.find((t) => t.name === name);
-    if (!tool) {
-      return { content: [{ type: "text", text: "Could not find tool" }] };
-    }
-    const procedure = tool.pathInRouter.reduce(
-      // @ts-expect-error path in router
-      (acc, part) => acc?.[part],
-      trpcCaller
-    );
-    const result = await procedure(args);
-    return {
-      content: [{ type: "text", text: JSON.stringify(result) }]
-    };
-  });
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  createMcpServer,
-  extractToolsFromProcedures,
-  mergeInputs
-});

package/dist/index.mjs

@@ -1,87 +0,0 @@
-// src/server.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
-
-// src/tools.ts
-import { z } from "zod/v4";
-function mergeInputs(inputs) {
-  return inputs.reduce((acc, input) => {
-    return acc.extend(input.shape);
-  }, z.object());
-}
-function extractToolsFromProcedures(appRouter, currentPath = []) {
-  const tools = [];
-  const procedures = Object.entries(appRouter._def.procedures);
-  for (const [name, procedure] of procedures) {
-    if (procedure._def && "inputs" in procedure._def) {
-      const inputs = procedure._def.inputs;
-      const schema = inputs.length > 1 ? mergeInputs(inputs) : inputs[0];
-      const meta = procedure._def.meta;
-      if (!meta || !meta?.mcp?.enabled) {
-        continue;
-      }
-      const pathInRouter = [...currentPath, ...name.split(".")];
-      const tool = {
-        name: meta?.mcp?.name ?? name.replace(/\./g, "_"),
-        description: meta?.mcp?.description ?? "",
-        pathInRouter
-      };
-      if (schema) {
-        const jsonSchema = z.toJSONSchema(schema, {
-          unrepresentable: "any"
-        });
-        if (jsonSchema.type === "object") {
-          const { type, properties = {}, required = [] } = jsonSchema;
-          tool.inputSchema = { type, properties, required };
-        } else {
-          console.error(
-            "[TRPC-TO-MCP] Procedure has no object schema",
-            pathInRouter
-          );
-        }
-      } else {
-        const jsonSchema = z.toJSONSchema(z.object());
-        tool.inputSchema = jsonSchema;
-      }
-      tools.push(tool);
-    }
-  }
-  return tools;
-}
-
-// src/server.ts
-function createMcpServer(implementation, appRouter, ctx) {
-  const tools = extractToolsFromProcedures(appRouter);
-  const trpcCaller = appRouter.createCaller(ctx);
-  const server = new Server(implementation, {
-    capabilities: {
-      // Leave it empty because we list tools manually
-      tools: {}
-    }
-  });
-  server.setRequestHandler(ListToolsRequestSchema, () => ({ tools }));
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    const tool = tools.find((t) => t.name === name);
-    if (!tool) {
-      return { content: [{ type: "text", text: "Could not find tool" }] };
-    }
-    const procedure = tool.pathInRouter.reduce(
-      // @ts-expect-error path in router
-      (acc, part) => acc?.[part],
-      trpcCaller
-    );
-    const result = await procedure(args);
-    return {
-      content: [{ type: "text", text: JSON.stringify(result) }]
-    };
-  });
-}
-export {
-  createMcpServer,
-  extractToolsFromProcedures,
-  mergeInputs
-};