trpc-to-mcp 1.0.0

package/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.github/workflows/main.yml

@@ -0,0 +1,21 @@
+name: CI
+on:
+  push:
+    branches:
+      - "**"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 9
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20.x
+          cache: "pnpm"
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm run lint && pnpm run build

package/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish
+on:
+  workflow_run:
+    workflows: [CI]
+    branches: [main]
+    types: [completed]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  publish:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 9
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20.x
+          cache: "pnpm"
+
+      - run: pnpm install --frozen-lockfile
+      - name: Create Release Pull Request or Publish
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          publish: pnpm run release --access public
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# trpc-to-mcp
+
+## 1.0.0
+
+### Major Changes
+
+- 7341e0f: Release package

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 iboughtbed
+
+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/dist/index.d.mts

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,113 @@
+"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

@@ -0,0 +1,87 @@
+// 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
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "trpc-to-mcp",
+  "license": "MIT",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "devDependencies": {
+    "@changesets/cli": "^2.29.5",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "@trpc/server": "^11.4.4",
+    "zod": "^4.0.15"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.2"
+  },
+  "scripts": {
+    "build": "tsup ./src/index.ts --format cjs,esm --dts",
+    "release": "pnpm run build && changeset publish",
+    "lint": "tsc"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./server";
+export * from "./tools";

package/src/server.ts

@@ -0,0 +1,63 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  type Implementation,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import type {
+  AnyProcedure,
+  AnyRootTypes,
+  Router,
+  RouterRecord,
+} from "@trpc/server/unstable-core-do-not-import";
+
+import { extractToolsFromProcedures } from "./tools";
+
+type MaybePromise<T> = Promise<T> | T;
+
+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: {},
+    },
+  });
+
+  // List all of the available tools
+  server.setRequestHandler(ListToolsRequestSchema, () => ({ tools }));
+
+  // Handle tool calls
+  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" }] };
+    }
+
+    // @ts-expect-error path in router
+    const procedure: AnyProcedure = tool.pathInRouter.reduce(
+      // @ts-expect-error path in router
+      (acc, part) => acc?.[part],
+      trpcCaller
+    );
+
+    // @ts-expect-error path in router
+    const result = await procedure(args);
+
+    return {
+      content: [{ type: "text", text: JSON.stringify(result) }],
+    };
+  });
+}

package/src/tools.ts

@@ -0,0 +1,74 @@
+// Credits to https://github.com/Jacse/trpc-mcp for the helpful code
+
+import type {
+  AnyRootTypes,
+  Router,
+  RouterRecord,
+} from "@trpc/server/unstable-core-do-not-import";
+import { z } from "zod/v4";
+
+import type { McpMeta } from "./types";
+
+export type McpTool = {
+  name: string;
+  description: string;
+  pathInRouter: string[];
+  inputSchema?: z.core.JSONSchema.JSONSchema;
+};
+
+export function mergeInputs(inputs: z.ZodObject[]) {
+  return inputs.reduce((acc, input) => {
+    return acc.extend(input.shape);
+  }, z.object());
+}
+
+export function extractToolsFromProcedures<
+  TRoot extends AnyRootTypes,
+  TRecord extends RouterRecord
+>(appRouter: Router<TRoot, TRecord>, currentPath: string[] = []) {
+  const tools: McpTool[] = [];
+  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 as z.ZodObject[];
+      const schema = inputs.length > 1 ? mergeInputs(inputs) : inputs[0];
+
+      const meta = procedure._def.meta as McpMeta;
+      if (!meta || !meta?.mcp?.enabled) {
+        continue;
+      }
+
+      const pathInRouter = [...currentPath, ...name.split(".")];
+      const tool: McpTool = {
+        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 {
+        // If there is not schema, we have to pass an empty object for JSON schema compatibility
+        const jsonSchema = z.toJSONSchema(z.object());
+        tool.inputSchema = jsonSchema;
+      }
+
+      tools.push(tool);
+    }
+  }
+
+  return tools;
+}

package/src/types.ts

@@ -0,0 +1,7 @@
+export type McpMeta = {
+  mcp?: {
+    enabled?: boolean;
+    description?: string;
+    name?: string;
+  };
+};

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true
+  }
+}