@rudderjs/mcp 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+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,152 @@
+# @rudderjs/mcp
+
+MCP (Model Context Protocol) server framework for RudderJS. Build custom MCP servers that expose your application's functionality to AI agents.
+
+## Installation
+
+```bash
+pnpm add @rudderjs/mcp
+```
+
+## Setup
+
+Add to your providers:
+
+```ts
+// bootstrap/providers.ts
+import { mcp } from '@rudderjs/mcp'
+
+export default [..., mcp()]
+```
+
+## Defining a Server
+
+```ts
+// app/Mcp/Servers/WeatherServer.ts
+import { McpServer, Name, Version, Instructions } from '@rudderjs/mcp'
+
+@Name('Weather Server')
+@Version('1.0.0')
+@Instructions('Provide weather information and forecasts.')
+export class WeatherServer extends McpServer {
+  protected tools = [CurrentWeatherTool]
+  protected resources = [WeatherGuidelinesResource]
+  protected prompts = [DescribeWeatherPrompt]
+}
+```
+
+## Tools
+
+```ts
+// app/Mcp/Tools/CurrentWeatherTool.ts
+import { McpTool, McpResponse, Description } from '@rudderjs/mcp'
+import { z } from 'zod'
+
+@Description('Get current weather for a location.')
+export class CurrentWeatherTool extends McpTool {
+  schema() {
+    return z.object({
+      location: z.string().describe('City name'),
+    })
+  }
+
+  async handle(input: Record<string, unknown>) {
+    const location = input.location as string
+    return McpResponse.text(`Weather in ${location}: sunny, 22C`)
+  }
+}
+```
+
+## Resources
+
+```ts
+import { McpResource, Description } from '@rudderjs/mcp'
+
+@Description('Weather usage guidelines')
+export class WeatherGuidelinesResource extends McpResource {
+  uri() { return 'weather://guidelines' }
+  async handle() { return 'Always check conditions before...' }
+}
+```
+
+## Prompts
+
+```ts
+import { McpPrompt, Description } from '@rudderjs/mcp'
+import type { McpPromptMessage } from '@rudderjs/mcp'
+import { z } from 'zod'
+
+@Description('Describe weather poetically')
+export class DescribeWeatherPrompt extends McpPrompt {
+  arguments() {
+    return z.object({ location: z.string() })
+  }
+
+  async handle(args: Record<string, unknown>): Promise<McpPromptMessage[]> {
+    return [{ role: 'user', content: `Describe the weather in ${args.location} poetically.` }]
+  }
+}
+```
+
+## Registration
+
+```ts
+// routes/ai.ts
+import { Mcp } from '@rudderjs/mcp'
+import { WeatherServer } from '../app/Mcp/Servers/WeatherServer.js'
+
+// HTTP endpoint (Streamable HTTP transport)
+Mcp.web('/mcp/weather', WeatherServer)
+
+// Local CLI command (stdio transport)
+Mcp.local('weather', WeatherServer)
+```
+
+## CLI Commands
+
+```bash
+rudder mcp:start weather    # Start a local server via stdio
+rudder mcp:list             # List all registered MCP servers
+```
+
+## Scaffolding
+
+```bash
+rudder make:mcp-server Weather
+rudder make:mcp-tool CurrentWeather
+rudder make:mcp-resource WeatherGuidelines
+rudder make:mcp-prompt DescribeWeather
+```
+
+## Testing
+
+```ts
+import { McpTestClient } from '@rudderjs/mcp'
+import { WeatherServer } from '../app/Mcp/Servers/WeatherServer.js'
+
+const client = new McpTestClient(WeatherServer)
+
+// Call a tool
+const result = await client.callTool('current-weather', { location: 'London' })
+
+// Assertions
+client.assertToolExists('current-weather')
+client.assertToolCount(1)
+client.assertResourceExists('weather://guidelines')
+client.assertPromptExists('describe-weather')
+
+// List
+const tools = await client.listTools()
+const resources = await client.listResources()
+const prompts = await client.listPrompts()
+```
+
+## Response Helpers
+
+```ts
+import { McpResponse } from '@rudderjs/mcp'
+
+McpResponse.text('Plain text output')
+McpResponse.json({ key: 'value' })
+McpResponse.error('Something went wrong')
+```

package/dist/Mcp.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from './McpServer.js';
+type ServerClass = new () => McpServer;
+export declare class Mcp {
+    private static webServers;
+    private static localServers;
+    /** Register an MCP server on an HTTP endpoint (Streamable HTTP transport) */
+    static web(path: string, server: ServerClass, middleware?: unknown[]): void;
+    /** Register an MCP server as a local CLI command (stdio transport) */
+    static local(name: string, server: ServerClass): void;
+    static getWebServers(): Map<string, {
+        server: ServerClass;
+        middleware: unknown[];
+    }>;
+    static getLocalServers(): Map<string, ServerClass>;
+}
+export {};
+//# sourceMappingURL=Mcp.d.ts.map

package/dist/Mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mcp.d.ts","sourceRoot":"","sources":["../src/Mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,KAAK,WAAW,GAAG,UAAU,SAAS,CAAA;AAEtC,qBAAa,GAAG;IACd,OAAO,CAAC,MAAM,CAAC,UAAU,CAAyE;IAClG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAsC;IAEjE,6EAA6E;IAC7E,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,GAAE,OAAO,EAAO,GAAG,IAAI;IAI/E,sEAAsE;IACtE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAIrD,MAAM,CAAC,aAAa;gBAb6B,WAAW;oBAAc,OAAO,EAAE;;IAcnF,MAAM,CAAC,eAAe;CACvB"}

package/dist/Mcp.js

@@ -0,0 +1,15 @@
+export class Mcp {
+    static webServers = new Map();
+    static localServers = new Map();
+    /** Register an MCP server on an HTTP endpoint (Streamable HTTP transport) */
+    static web(path, server, middleware = []) {
+        this.webServers.set(path, { server, middleware });
+    }
+    /** Register an MCP server as a local CLI command (stdio transport) */
+    static local(name, server) {
+        this.localServers.set(name, server);
+    }
+    static getWebServers() { return this.webServers; }
+    static getLocalServers() { return this.localServers; }
+}
+//# sourceMappingURL=Mcp.js.map

package/dist/Mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mcp.js","sourceRoot":"","sources":["../src/Mcp.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,GAAG;IACN,MAAM,CAAC,UAAU,GAAgE,IAAI,GAAG,EAAE,CAAA;IAC1F,MAAM,CAAC,YAAY,GAA6B,IAAI,GAAG,EAAE,CAAA;IAEjE,6EAA6E;IAC7E,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,MAAmB,EAAE,aAAwB,EAAE;QACtE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,MAAmB;QAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,MAAM,CAAC,aAAa,KAAK,OAAO,IAAI,CAAC,UAAU,CAAA,CAAC,CAAC;IACjD,MAAM,CAAC,eAAe,KAAK,OAAO,IAAI,CAAC,YAAY,CAAA,CAAC,CAAC"}

package/dist/McpPrompt.d.ts

@@ -0,0 +1,16 @@
+import type { z } from 'zod';
+export interface McpPromptMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export declare abstract class McpPrompt {
+    /** Prompt name */
+    name(): string;
+    /** Description */
+    description(): string;
+    /** Arguments schema */
+    arguments?(): z.ZodObject<z.ZodRawShape>;
+    /** Generate prompt messages */
+    abstract handle(args: Record<string, unknown>): Promise<McpPromptMessage[]>;
+}
+//# sourceMappingURL=McpPrompt.d.ts.map

package/dist/McpPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpPrompt.d.ts","sourceRoot":"","sources":["../src/McpPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAI5B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,8BAAsB,SAAS;IAC7B,kBAAkB;IAClB,IAAI,IAAI,MAAM;IAId,kBAAkB;IAClB,WAAW,IAAI,MAAM;IAIrB,uBAAuB;IACvB,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAExC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAC5E"}

package/dist/McpPrompt.js

@@ -0,0 +1,13 @@
+import { toKebabCase } from './utils.js';
+import { getDescription } from './decorators.js';
+export class McpPrompt {
+    /** Prompt name */
+    name() {
+        return toKebabCase(this.constructor.name.replace(/Prompt$/, ''));
+    }
+    /** Description */
+    description() {
+        return getDescription(this.constructor) ?? '';
+    }
+}
+//# sourceMappingURL=McpPrompt.js.map

package/dist/McpPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpPrompt.js","sourceRoot":"","sources":["../src/McpPrompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,OAAgB,SAAS;IAC7B,kBAAkB;IAClB,IAAI;QACF,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;IAClE,CAAC;IAED,kBAAkB;IAClB,WAAW;QACT,OAAO,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;IAC/C,CAAC;CAOF"}

package/dist/McpResource.d.ts

@@ -0,0 +1,11 @@
+export declare abstract class McpResource {
+    /** Resource URI pattern */
+    abstract uri(): string;
+    /** MIME type */
+    mimeType(): string;
+    /** Resource description */
+    description(): string;
+    /** Handle resource read */
+    abstract handle(): Promise<string>;
+}
+//# sourceMappingURL=McpResource.d.ts.map

package/dist/McpResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpResource.d.ts","sourceRoot":"","sources":["../src/McpResource.ts"],"names":[],"mappings":"AAEA,8BAAsB,WAAW;IAC/B,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,IAAI,MAAM;IAEtB,gBAAgB;IAChB,QAAQ,IAAI,MAAM;IAIlB,2BAA2B;IAC3B,WAAW,IAAI,MAAM;IAIrB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CACnC"}

package/dist/McpResource.js

@@ -0,0 +1,12 @@
+import { getDescription } from './decorators.js';
+export class McpResource {
+    /** MIME type */
+    mimeType() {
+        return 'text/plain';
+    }
+    /** Resource description */
+    description() {
+        return getDescription(this.constructor) ?? '';
+    }
+}
+//# sourceMappingURL=McpResource.js.map

package/dist/McpResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpResource.js","sourceRoot":"","sources":["../src/McpResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,OAAgB,WAAW;IAI/B,gBAAgB;IAChB,QAAQ;QACN,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,2BAA2B;IAC3B,WAAW;QACT,OAAO,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;IAC/C,CAAC;CAIF"}

package/dist/McpResponse.d.ts

@@ -0,0 +1,7 @@
+import type { McpToolResult } from './McpTool.js';
+export declare class McpResponse {
+    static text(content: string): McpToolResult;
+    static json(data: unknown): McpToolResult;
+    static error(message: string): McpToolResult;
+}
+//# sourceMappingURL=McpResponse.d.ts.map

package/dist/McpResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpResponse.d.ts","sourceRoot":"","sources":["../src/McpResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,qBAAa,WAAW;IACtB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAI3C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa;IAIzC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;CAG7C"}

package/dist/McpResponse.js

@@ -0,0 +1,12 @@
+export class McpResponse {
+    static text(content) {
+        return { content: [{ type: 'text', text: content }] };
+    }
+    static json(data) {
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    }
+    static error(message) {
+        return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+    }
+}
+//# sourceMappingURL=McpResponse.js.map

package/dist/McpResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpResponse.js","sourceRoot":"","sources":["../src/McpResponse.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;IACvD,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAa;QACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAe;QAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAClF,CAAC;CACF"}

package/dist/McpServer.d.ts

@@ -0,0 +1,19 @@
+import type { McpTool } from './McpTool.js';
+import type { McpResource } from './McpResource.js';
+import type { McpPrompt } from './McpPrompt.js';
+export interface McpServerMetadata {
+    name?: string;
+    version?: string;
+    instructions?: string;
+}
+export declare abstract class McpServer {
+    /** Tool classes to register */
+    protected tools: (new () => McpTool)[];
+    /** Resource classes to register */
+    protected resources: (new () => McpResource)[];
+    /** Prompt classes to register */
+    protected prompts: (new () => McpPrompt)[];
+    /** Server metadata — override or use decorators */
+    metadata(): Required<Pick<McpServerMetadata, 'name' | 'version'>> & Pick<McpServerMetadata, 'instructions'>;
+}
+//# sourceMappingURL=McpServer.d.ts.map

package/dist/McpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.d.ts","sourceRoot":"","sources":["../src/McpServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG/C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,8BAAsB,SAAS;IAC7B,+BAA+B;IAC/B,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,OAAO,CAAC,EAAE,CAAK;IAE3C,mCAAmC;IACnC,SAAS,CAAC,SAAS,EAAE,CAAC,UAAU,WAAW,CAAC,EAAE,CAAK;IAEnD,iCAAiC;IACjC,SAAS,CAAC,OAAO,EAAE,CAAC,UAAU,SAAS,CAAC,EAAE,CAAK;IAE/C,mDAAmD;IACnD,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC;CAQ5G"}

package/dist/McpServer.js

@@ -0,0 +1,19 @@
+import { getServerMetadata } from './decorators.js';
+export class McpServer {
+    /** Tool classes to register */
+    tools = [];
+    /** Resource classes to register */
+    resources = [];
+    /** Prompt classes to register */
+    prompts = [];
+    /** Server metadata — override or use decorators */
+    metadata() {
+        const meta = getServerMetadata(this.constructor);
+        return {
+            name: meta.name ?? this.constructor.name,
+            version: meta.version ?? '1.0.0',
+            ...(meta.instructions != null ? { instructions: meta.instructions } : {}),
+        };
+    }
+}
+//# sourceMappingURL=McpServer.js.map

package/dist/McpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../src/McpServer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAQnD,MAAM,OAAgB,SAAS;IAC7B,+BAA+B;IACrB,KAAK,GAA0B,EAAE,CAAA;IAE3C,mCAAmC;IACzB,SAAS,GAA8B,EAAE,CAAA;IAEnD,iCAAiC;IACvB,OAAO,GAA4B,EAAE,CAAA;IAE/C,mDAAmD;IACnD,QAAQ;QACN,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAChD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI;YACxC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;YAChC,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAA;IACH,CAAC;CACF"}

package/dist/McpTool.d.ts

@@ -0,0 +1,23 @@
+import type { z } from 'zod';
+export interface McpToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'image';
+        data: string;
+        mimeType: string;
+    }>;
+    isError?: boolean;
+}
+export declare abstract class McpTool {
+    /** Tool name — derived from class name if not overridden. ClassName -> kebab-case minus "Tool" suffix */
+    name(): string;
+    /** Tool description — override or use @Description decorator */
+    description(): string;
+    /** Input schema using Zod */
+    abstract schema(): z.ZodObject<z.ZodRawShape>;
+    /** Handle the tool call */
+    abstract handle(input: Record<string, unknown>): Promise<McpToolResult>;
+}
+//# sourceMappingURL=McpTool.d.ts.map

package/dist/McpTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpTool.d.ts","sourceRoot":"","sources":["../src/McpTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAI5B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClG,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,8BAAsB,OAAO;IAC3B,yGAAyG;IACzG,IAAI,IAAI,MAAM;IAId,gEAAgE;IAChE,WAAW,IAAI,MAAM;IAIrB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAE7C,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CACxE"}

package/dist/McpTool.js

@@ -0,0 +1,13 @@
+import { toKebabCase } from './utils.js';
+import { getDescription } from './decorators.js';
+export class McpTool {
+    /** Tool name — derived from class name if not overridden. ClassName -> kebab-case minus "Tool" suffix */
+    name() {
+        return toKebabCase(this.constructor.name.replace(/Tool$/, ''));
+    }
+    /** Tool description — override or use @Description decorator */
+    description() {
+        return getDescription(this.constructor) ?? '';
+    }
+}
+//# sourceMappingURL=McpTool.js.map

package/dist/McpTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpTool.js","sourceRoot":"","sources":["../src/McpTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAOhD,MAAM,OAAgB,OAAO;IAC3B,yGAAyG;IACzG,IAAI;QACF,OAAO,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,gEAAgE;IAChE,WAAW;QACT,OAAO,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;IAC/C,CAAC;CAOF"}

package/dist/decorators.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+export declare function Name(name: string): ClassDecorator;
+export declare function Version(version: string): ClassDecorator;
+export declare function Instructions(instructions: string): ClassDecorator;
+export declare function Description(description: string): ClassDecorator;
+export declare function getServerMetadata(target: Function): {
+    name: string | undefined;
+    version: string | undefined;
+    instructions: string | undefined;
+};
+export declare function getDescription(target: Function): string | undefined;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAOzB,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEjD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAEvD;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAE/D;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAM/I;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAEnE"}

package/dist/decorators.js

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+const NAME_KEY = Symbol('mcp:name');
+const VERSION_KEY = Symbol('mcp:version');
+const INSTRUCTIONS_KEY = Symbol('mcp:instructions');
+const DESCRIPTION_KEY = Symbol('mcp:description');
+export function Name(name) {
+    return (target) => { Reflect.defineMetadata(NAME_KEY, name, target); };
+}
+export function Version(version) {
+    return (target) => { Reflect.defineMetadata(VERSION_KEY, version, target); };
+}
+export function Instructions(instructions) {
+    return (target) => { Reflect.defineMetadata(INSTRUCTIONS_KEY, instructions, target); };
+}
+export function Description(description) {
+    return (target) => { Reflect.defineMetadata(DESCRIPTION_KEY, description, target); };
+}
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export function getServerMetadata(target) {
+    return {
+        name: Reflect.getMetadata(NAME_KEY, target),
+        version: Reflect.getMetadata(VERSION_KEY, target),
+        instructions: Reflect.getMetadata(INSTRUCTIONS_KEY, target),
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+export function getDescription(target) {
+    return Reflect.getMetadata(DESCRIPTION_KEY, target);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAEzB,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;AACnC,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AACzC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAA;AACnD,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAEjD,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;AACvF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;AACrF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IAChD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAuB;QACjE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAuB;QACvE,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,MAAM,CAAuB;KAClF,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAuB,CAAA;AAC3E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { McpServer } from './McpServer.js';
+export type { McpServerMetadata } from './McpServer.js';
+export { McpTool } from './McpTool.js';
+export type { McpToolResult } from './McpTool.js';
+export { McpResource } from './McpResource.js';
+export { McpPrompt } from './McpPrompt.js';
+export type { McpPromptMessage } from './McpPrompt.js';
+export { McpResponse } from './McpResponse.js';
+export { Mcp } from './Mcp.js';
+export { Name, Version, Instructions, Description } from './decorators.js';
+export { createSdkServer, startStdio } from './runtime.js';
+export { mcp } from './provider.js';
+export { McpTestClient } from './testing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { McpServer } from './McpServer.js';
+export { McpTool } from './McpTool.js';
+export { McpResource } from './McpResource.js';
+export { McpPrompt } from './McpPrompt.js';
+export { McpResponse } from './McpResponse.js';
+export { Mcp } from './Mcp.js';
+export { Name, Version, Instructions, Description } from './decorators.js';
+export { createSdkServer, startStdio } from './runtime.js';
+export { mcp } from './provider.js';
+export { McpTestClient } from './testing.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,4 @@
+import type { Application } from '@rudderjs/core';
+import { ServiceProvider } from '@rudderjs/core';
+export declare function mcp(): new (app: Application) => ServiceProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,GAAG,IAAI,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAoD/D"}

package/dist/provider.js

@@ -0,0 +1,51 @@
+import { ServiceProvider } from '@rudderjs/core';
+import { Mcp } from './Mcp.js';
+export function mcp() {
+    class McpServiceProvider extends ServiceProvider {
+        register() {
+            this.app.instance('mcp', Mcp);
+        }
+        async boot() {
+            try {
+                const { rudder } = await import('@rudderjs/core');
+                // mcp:start <name> — start a local server via stdio
+                rudder.command('mcp:start', async (args) => {
+                    const name = args[0];
+                    const ServerClass = name != null ? Mcp.getLocalServers().get(name) : undefined;
+                    if (!ServerClass) {
+                        console.error(`MCP server "${name}" not found. Available: ${[...Mcp.getLocalServers().keys()].join(', ')}`);
+                        process.exit(1);
+                    }
+                    const { startStdio } = await import('./runtime.js');
+                    await startStdio(new ServerClass());
+                }).description('Start an MCP server (stdio)');
+                // mcp:list — list all registered servers
+                rudder.command('mcp:list', () => {
+                    const web = [...Mcp.getWebServers().entries()];
+                    const local = [...Mcp.getLocalServers().entries()];
+                    if (web.length === 0 && local.length === 0) {
+                        console.log('No MCP servers registered.');
+                        return;
+                    }
+                    if (web.length > 0) {
+                        console.log('\nWeb Servers:');
+                        for (const [path, { server }] of web) {
+                            console.log(`  ${path} -> ${server.name}`);
+                        }
+                    }
+                    if (local.length > 0) {
+                        console.log('\nLocal Servers:');
+                        for (const [serverName, server] of local) {
+                            console.log(`  ${serverName} -> ${server.name}`);
+                        }
+                    }
+                }).description('List registered MCP servers');
+            }
+            catch {
+                // rudder not available
+            }
+        }
+    }
+    return McpServiceProvider;
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,MAAM,UAAU,GAAG;IACjB,MAAM,kBAAmB,SAAQ,eAAe;QAC9C,QAAQ;YACN,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC/B,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;gBAEjD,oDAAoD;gBACpD,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,IAAc,EAAE,EAAE;oBACnD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;oBACpB,MAAM,WAAW,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;oBAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,OAAO,CAAC,KAAK,CAAC,eAAe,IAAI,2BAA2B,CAAC,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;wBAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACjB,CAAC;oBACD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAA;oBACnD,MAAM,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,CAAA;gBACrC,CAAC,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAA;gBAE7C,yCAAyC;gBACzC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE;oBAC9B,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;oBAC9C,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;oBAElD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC3C,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;wBACzC,OAAM;oBACR,CAAC;oBAED,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACnB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;wBAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC;4BACrC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;wBAC5C,CAAC;oBACH,CAAC;oBAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;wBAC/B,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;4BACzC,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;wBAClD,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAA;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;KACF;IACD,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,6 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { McpServer } from './McpServer.js';
+export declare function createSdkServer(server: McpServer): Server;
+/** Start a server with stdio transport */
+export declare function startStdio(server: McpServer): Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAUlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAU/C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgFzD;AAED,0CAA0C;AAC1C,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjE"}

package/dist/runtime.js

@@ -0,0 +1,86 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, ListResourcesRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { zodToJsonSchema } from './zod-to-json-schema.js';
+function getProtected(server, key, fallback) {
+    return (server[key]) ?? fallback;
+}
+export function createSdkServer(server) {
+    const meta = server.metadata();
+    const sdk = new Server({ name: meta.name, version: meta.version }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+    const toolClasses = getProtected(server, 'tools', []);
+    const resourceClasses = getProtected(server, 'resources', []);
+    const promptClasses = getProtected(server, 'prompts', []);
+    const tools = toolClasses.map((T) => new T());
+    const resources = resourceClasses.map((R) => new R());
+    const prompts = promptClasses.map((P) => new P());
+    // ── Tools ────────────────────────────────────────────────
+    sdk.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name(),
+            description: t.description(),
+            inputSchema: zodToJsonSchema(t.schema()),
+        })),
+    }));
+    sdk.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const tool = tools.find((t) => t.name() === request.params.name);
+        if (!tool) {
+            return { content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }], isError: true };
+        }
+        try {
+            const result = await tool.handle((request.params.arguments ?? {}));
+            return { ...result };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
+        }
+    });
+    // ── Resources ────────────────────────────────────────────
+    sdk.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: resources.map((r) => ({
+            uri: r.uri(),
+            name: r.uri(),
+            description: r.description(),
+            mimeType: r.mimeType(),
+        })),
+    }));
+    sdk.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const resource = resources.find((r) => r.uri() === request.params.uri);
+        if (!resource) {
+            throw new Error(`Unknown resource: ${request.params.uri}`);
+        }
+        return {
+            contents: [{
+                    uri: resource.uri(),
+                    text: await resource.handle(),
+                    mimeType: resource.mimeType(),
+                }],
+        };
+    });
+    // ── Prompts ──────────────────────────────────────────────
+    sdk.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: prompts.map((p) => ({
+            name: p.name(),
+            description: p.description(),
+            ...(p.arguments ? { arguments: Object.keys(p.arguments().shape).map((k) => ({ name: k, required: true })) } : {}),
+        })),
+    }));
+    sdk.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const prompt = prompts.find((p) => p.name() === request.params.name);
+        if (!prompt) {
+            throw new Error(`Unknown prompt: ${request.params.name}`);
+        }
+        return { messages: await prompt.handle((request.params.arguments ?? {})) };
+    });
+    return sdk;
+}
+/** Start a server with stdio transport */
+export async function startStdio(server) {
+    const sdk = createSdkServer(server);
+    const transport = new StdioServerTransport();
+    await sdk.connect(transport);
+}
+// TODO: Add createHttpHandler once StreamableHTTPServerTransport / SSEServerTransport
+// integration pattern is finalized. The low-level Server class requires manual transport wiring.
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,31 @@
+import type { McpServer } from './McpServer.js';
+import type { McpToolResult } from './McpTool.js';
+import type { McpPromptMessage } from './McpPrompt.js';
+export declare class McpTestClient {
+    private tools;
+    private resources;
+    private prompts;
+    constructor(ServerClass: new () => McpServer);
+    callTool(name: string, input?: Record<string, unknown>): Promise<McpToolResult>;
+    listTools(): Promise<Array<{
+        name: string;
+        description: string;
+    }>>;
+    listResources(): Promise<Array<{
+        uri: string;
+        description: string;
+    }>>;
+    listPrompts(): Promise<Array<{
+        name: string;
+        description: string;
+    }>>;
+    readResource(uri: string): Promise<string>;
+    getPrompt(name: string, args?: Record<string, unknown>): Promise<McpPromptMessage[]>;
+    assertToolExists(name: string): void;
+    assertToolCount(expected: number): void;
+    assertResourceExists(uri: string): void;
+    assertResourceCount(expected: number): void;
+    assertPromptExists(name: string): void;
+    assertPromptCount(expected: number): void;
+}
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAW,aAAa,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjE,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,OAAO,CAAa;gBAEhB,WAAW,EAAE,UAAU,SAAS;IAiBtC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMnF,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAIlE,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAIrE,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAIpE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM9F,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMvC,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM3C,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAK1C"}

package/dist/testing.js

@@ -0,0 +1,70 @@
+export class McpTestClient {
+    tools;
+    resources;
+    prompts;
+    constructor(ServerClass) {
+        const server = new ServerClass();
+        const record = server;
+        this.tools = (record['tools'] ?? []).map((T) => new T());
+        this.resources = (record['resources'] ?? []).map((R) => new R());
+        this.prompts = (record['prompts'] ?? []).map((P) => new P());
+    }
+    async callTool(name, input = {}) {
+        const tool = this.tools.find((t) => t.name() === name);
+        if (!tool)
+            throw new Error(`Tool "${name}" not found`);
+        return tool.handle(input);
+    }
+    async listTools() {
+        return this.tools.map((t) => ({ name: t.name(), description: t.description() }));
+    }
+    async listResources() {
+        return this.resources.map((r) => ({ uri: r.uri(), description: r.description() }));
+    }
+    async listPrompts() {
+        return this.prompts.map((p) => ({ name: p.name(), description: p.description() }));
+    }
+    async readResource(uri) {
+        const resource = this.resources.find((r) => r.uri() === uri);
+        if (!resource)
+            throw new Error(`Resource "${uri}" not found`);
+        return resource.handle();
+    }
+    async getPrompt(name, args = {}) {
+        const prompt = this.prompts.find((p) => p.name() === name);
+        if (!prompt)
+            throw new Error(`Prompt "${name}" not found`);
+        return prompt.handle(args);
+    }
+    assertToolExists(name) {
+        if (!this.tools.some((t) => t.name() === name)) {
+            throw new Error(`Expected tool "${name}" to exist, but it was not found`);
+        }
+    }
+    assertToolCount(expected) {
+        if (this.tools.length !== expected) {
+            throw new Error(`Expected ${expected} tools, but found ${this.tools.length}`);
+        }
+    }
+    assertResourceExists(uri) {
+        if (!this.resources.some((r) => r.uri() === uri)) {
+            throw new Error(`Expected resource "${uri}" to exist, but it was not found`);
+        }
+    }
+    assertResourceCount(expected) {
+        if (this.resources.length !== expected) {
+            throw new Error(`Expected ${expected} resources, but found ${this.resources.length}`);
+        }
+    }
+    assertPromptExists(name) {
+        if (!this.prompts.some((p) => p.name() === name)) {
+            throw new Error(`Expected prompt "${name}" to exist, but it was not found`);
+        }
+    }
+    assertPromptCount(expected) {
+        if (this.prompts.length !== expected) {
+            throw new Error(`Expected ${expected} prompts, but found ${this.prompts.length}`);
+        }
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function toKebabCase(str: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/utils.js

@@ -0,0 +1,7 @@
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAA;AAClB,CAAC"}

package/dist/zod-to-json-schema.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+/**
+ * Minimal Zod-to-JSON-Schema converter for MCP tool input schemas.
+ * Handles the common primitive types used in tool parameters.
+ */
+export declare function zodToJsonSchema(schema: z.ZodObject<z.ZodRawShape>): Record<string, unknown>;
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/zod-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../src/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB3F"}

package/dist/zod-to-json-schema.js

@@ -0,0 +1,53 @@
+/**
+ * Minimal Zod-to-JSON-Schema converter for MCP tool input schemas.
+ * Handles the common primitive types used in tool parameters.
+ */
+export function zodToJsonSchema(schema) {
+    const shape = schema.shape;
+    const properties = {};
+    const required = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const field = value;
+        properties[key] = zodTypeToJson(field);
+        // If the field is not optional, mark as required
+        if (!isOptional(field)) {
+            required.push(key);
+        }
+    }
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+    };
+}
+function zodTypeToJson(field) {
+    const def = field._def;
+    const typeName = def['typeName'];
+    switch (typeName) {
+        case 'ZodString':
+            return { type: 'string', ...(def['description'] ? { description: def['description'] } : {}) };
+        case 'ZodNumber':
+            return { type: 'number', ...(def['description'] ? { description: def['description'] } : {}) };
+        case 'ZodBoolean':
+            return { type: 'boolean', ...(def['description'] ? { description: def['description'] } : {}) };
+        case 'ZodArray':
+            return { type: 'array', items: zodTypeToJson(def['type']), ...(def['description'] ? { description: def['description'] } : {}) };
+        case 'ZodOptional':
+            return zodTypeToJson(def['innerType']);
+        case 'ZodDefault':
+            return zodTypeToJson(def['innerType']);
+        case 'ZodEnum':
+            return { type: 'string', enum: def['values'], ...(def['description'] ? { description: def['description'] } : {}) };
+        default:
+            return { type: 'string' };
+    }
+}
+function isOptional(field) {
+    const typeName = field._def['typeName'];
+    if (typeName === 'ZodOptional')
+        return true;
+    if (typeName === 'ZodDefault')
+        return true;
+    return false;
+}
+//# sourceMappingURL=zod-to-json-schema.js.map

package/dist/zod-to-json-schema.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@rudderjs/mcp",
+  "version": "0.0.1",
+  "description": "MCP (Model Context Protocol) server framework for RudderJS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rudderjs/rudder",
+    "directory": "packages/mcp"
+  },
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "reflect-metadata": "^0.2.0",
+    "zod": "^3.23.0",
+    "@rudderjs/core": "0.0.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "author": "Suleiman Shahbari",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "tsc -p tsconfig.test.json && node --test dist-test/*.test.js; EXIT=$?; rm -rf dist-test; exit $EXIT"
+  }
+}