@rudderjs/mcp 0.0.1 → 1.0.0

package/dist/commands/make-mcp-server.js

@@ -0,0 +1,28 @@
+export const makeMcpServerSpec = {
+    command: 'make:mcp-server',
+    description: 'Create a new MCP server class',
+    label: 'MCP server created',
+    suffix: 'Server',
+    directory: 'app/Mcp/Servers',
+    stub: (className) => `import { McpServer } from '@rudderjs/mcp'
+import { Name, Version, Instructions } from '@rudderjs/mcp'
+
+@Name('${className.replace(/Server$/, '')} Server')
+@Version('1.0.0')
+@Instructions('Provide a description of this MCP server.')
+export class ${className} extends McpServer {
+  protected tools = [
+    // Add your tool classes here
+  ]
+
+  protected resources = [
+    // Add your resource classes here
+  ]
+
+  protected prompts = [
+    // Add your prompt classes here
+  ]
+}
+`,
+};
+//# sourceMappingURL=make-mcp-server.js.map

package/dist/commands/make-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mcp-server.js","sourceRoot":"","sources":["../../src/commands/make-mcp-server.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,OAAO,EAAM,iBAAiB;IAC9B,WAAW,EAAE,+BAA+B;IAC5C,KAAK,EAAQ,oBAAoB;IACjC,MAAM,EAAO,QAAQ;IACrB,SAAS,EAAI,iBAAiB;IAC9B,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;;;SAGd,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;;;eAG1B,SAAS;;;;;;;;;;;;;CAavB;CACA,CAAA"}

package/dist/commands/make-mcp-tool.d.ts

@@ -0,0 +1,3 @@
+import type { MakeSpec } from '@rudderjs/rudder';
+export declare const makeMcpToolSpec: MakeSpec;
+//# sourceMappingURL=make-mcp-tool.d.ts.map

package/dist/commands/make-mcp-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mcp-tool.d.ts","sourceRoot":"","sources":["../../src/commands/make-mcp-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD,eAAO,MAAM,eAAe,EAAE,QAuB7B,CAAA"}

package/dist/commands/make-mcp-tool.js

@@ -0,0 +1,25 @@
+export const makeMcpToolSpec = {
+    command: 'make:mcp-tool',
+    description: 'Create a new MCP tool class',
+    label: 'MCP tool created',
+    suffix: 'Tool',
+    directory: 'app/Mcp/Tools',
+    stub: (className) => `import { McpTool, McpResponse, Description } from '@rudderjs/mcp'
+import { z } from 'zod'
+
+@Description('Describe what this tool does.')
+export class ${className} extends McpTool {
+  schema() {
+    return z.object({
+      // Define your input parameters here
+    })
+  }
+
+  async handle(input: Record<string, unknown>) {
+    // Implement your tool logic here
+    return McpResponse.text('Hello from ${className.replace(/Tool$/, '')}')
+  }
+}
+`,
+};
+//# sourceMappingURL=make-mcp-tool.js.map

package/dist/commands/make-mcp-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-mcp-tool.js","sourceRoot":"","sources":["../../src/commands/make-mcp-tool.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,OAAO,EAAM,eAAe;IAC5B,WAAW,EAAE,6BAA6B;IAC1C,KAAK,EAAQ,kBAAkB;IAC/B,MAAM,EAAO,MAAM;IACnB,SAAS,EAAI,eAAe;IAC5B,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;;;;eAIR,SAAS;;;;;;;;;0CASkB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;;;CAGvE;CACA,CAAA"}

package/dist/decorators.d.ts

@@ -9,4 +9,21 @@ export declare function getServerMetadata(target: Function): {
     instructions: string | undefined;
 };
 export declare function getDescription(target: Function): string | undefined;
+type InjectToken = (new (...args: any[]) => unknown) | string | symbol;
+/**
+ * Marks a method (typically `handle`) as wanting DI-resolved parameters beyond
+ * the first one. Pass the tokens explicitly — one per extra parameter:
+ *
+ * ```ts
+ * @Handle(GreetingService, Logger)
+ * async handle(input, greeter: GreetingService, logger: Logger) { ... }
+ * ```
+ *
+ * If called with no arguments, the runtime falls back to `design:paramtypes`
+ * metadata (which requires `emitDecoratorMetadata: true` AND a build tool that
+ * honours it — plain `tsc` does, but esbuild/Vite typically do not).
+ */
+export declare function Handle(...tokens: InjectToken[]): MethodDecorator;
+export declare function getInjectTokens(target: object, propertyKey: string | symbol): InjectToken[] | undefined;
+export type { InjectToken };
 //# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAQzB,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;AAGD,KAAK,WAAW,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,CAIhE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,EAAE,GAAG,SAAS,CAEvG;AAED,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/decorators.js

@@ -3,6 +3,7 @@ const NAME_KEY = Symbol('mcp:name');
 const VERSION_KEY = Symbol('mcp:version');
 const INSTRUCTIONS_KEY = Symbol('mcp:instructions');
 const DESCRIPTION_KEY = Symbol('mcp:description');
+const INJECT_KEY = Symbol('mcp:inject');
 export function Name(name) {
     return (target) => { Reflect.defineMetadata(NAME_KEY, name, target); };
 }
@@ -27,4 +28,25 @@ export function getServerMetadata(target) {
 export function getDescription(target) {
     return Reflect.getMetadata(DESCRIPTION_KEY, target);
 }
+/**
+ * Marks a method (typically `handle`) as wanting DI-resolved parameters beyond
+ * the first one. Pass the tokens explicitly — one per extra parameter:
+ *
+ * ```ts
+ * @Handle(GreetingService, Logger)
+ * async handle(input, greeter: GreetingService, logger: Logger) { ... }
+ * ```
+ *
+ * If called with no arguments, the runtime falls back to `design:paramtypes`
+ * metadata (which requires `emitDecoratorMetadata: true` AND a build tool that
+ * honours it — plain `tsc` does, but esbuild/Vite typically do not).
+ */
+export function Handle(...tokens) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(INJECT_KEY, tokens, target, propertyKey);
+    };
+}
+export function getInjectTokens(target, propertyKey) {
+    return Reflect.getMetadata(INJECT_KEY, target, propertyKey);
+}
 //# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -1 +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"}
+{"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;AACjD,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAEvC,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;AAKD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAC,GAAG,MAAqB;IAC7C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;IACjE,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,WAA4B;IAC1E,OAAO,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAA8B,CAAA;AAC1F,CAAC"}

package/dist/index.d.ts

@@ -7,8 +7,14 @@ 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 type { McpWebEntry, McpWebBuilder } from './Mcp.js';
+export { Name, Version, Instructions, Description, Handle } from './decorators.js';
+export type { InjectToken } from './decorators.js';
+export { createSdkServer, startStdio, mountHttpTransport } from './runtime.js';
+export type { HttpTransportOptions } from './runtime.js';
+export { oauth2McpMiddleware, registerOAuth2Metadata } from './auth/oauth2.js';
+export type { OAuth2McpOptions } from './auth/oauth2.js';
+export { McpProvider } from './provider.js';
 export { McpTestClient } from './testing.js';
+export type { McpObserverEvent, McpObserver, McpObserverRegistry } from './observers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC9E,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -4,8 +4,9 @@ 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 { Name, Version, Instructions, Description, Handle } from './decorators.js';
+export { createSdkServer, startStdio, mountHttpTransport } from './runtime.js';
+export { oauth2McpMiddleware, registerOAuth2Metadata } from './auth/oauth2.js';
+export { McpProvider } from './provider.js';
 export { McpTestClient } from './testing.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAE9B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAElF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE9E,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/observers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MCP observer registry — Telescope and other collectors subscribe here to
+ * receive structured events when tools, resources, and prompts are invoked.
+ *
+ * Same architecture as `@rudderjs/ai/observers`: a singleton stored on
+ * `globalThis` so state survives Vite SSR module re-evaluation, and a
+ * try/catch around dispatch so an observer error never breaks an MCP
+ * server.
+ */
+export interface McpObserverEvent {
+    kind: 'tool.called' | 'tool.failed' | 'resource.read' | 'resource.failed' | 'prompt.rendered' | 'prompt.failed';
+    serverName: string;
+    /** Tool name, resource URI, or prompt name */
+    name: string;
+    /** Tool args, resource URI params, or prompt args */
+    input: unknown;
+    /** Tool result, resource content, or prompt messages (null on failure) */
+    output: unknown;
+    /** Wall-clock duration in ms */
+    duration: number;
+    /** Present on `*.failed` events */
+    error?: string;
+}
+export type McpObserver = (event: McpObserverEvent) => void;
+export declare class McpObserverRegistry {
+    private observers;
+    subscribe(fn: McpObserver): () => void;
+    emit(event: McpObserverEvent): void;
+    reset(): void;
+}
+export declare const mcpObservers: McpObserverRegistry;
+//# sourceMappingURL=observers.d.ts.map

package/dist/observers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../src/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EACA,aAAa,GAAG,aAAa,GAC7B,eAAe,GAAG,iBAAiB,GACnC,iBAAiB,GAAG,eAAe,CAAA;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,IAAI,EAAQ,MAAM,CAAA;IAClB,qDAAqD;IACrD,KAAK,EAAO,OAAO,CAAA;IACnB,0EAA0E;IAC1E,MAAM,EAAM,OAAO,CAAA;IACnB,gCAAgC;IAChC,QAAQ,EAAI,MAAM,CAAA;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAM,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE3D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAoB;IAErC,SAAS,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,IAAI;IAKtC,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAMnC,KAAK,IAAI,IAAI;CACd;AAMD,eAAO,MAAM,YAAY,EAAuC,mBAAmB,CAAA"}

package/dist/observers.js

@@ -0,0 +1,31 @@
+/**
+ * MCP observer registry — Telescope and other collectors subscribe here to
+ * receive structured events when tools, resources, and prompts are invoked.
+ *
+ * Same architecture as `@rudderjs/ai/observers`: a singleton stored on
+ * `globalThis` so state survives Vite SSR module re-evaluation, and a
+ * try/catch around dispatch so an observer error never breaks an MCP
+ * server.
+ */
+export class McpObserverRegistry {
+    observers = [];
+    subscribe(fn) {
+        this.observers.push(fn);
+        return () => { this.observers = this.observers.filter((o) => o !== fn); };
+    }
+    emit(event) {
+        for (const observer of this.observers) {
+            try {
+                observer(event);
+            }
+            catch { /* observer errors must not break MCP servers */ }
+        }
+    }
+    reset() { this.observers = []; }
+}
+const _g = globalThis;
+if (!_g['__rudderjs_mcp_observers__']) {
+    _g['__rudderjs_mcp_observers__'] = new McpObserverRegistry();
+}
+export const mcpObservers = _g['__rudderjs_mcp_observers__'];
+//# sourceMappingURL=observers.js.map

package/dist/observers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.js","sourceRoot":"","sources":["../src/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH,MAAM,OAAO,mBAAmB;IACtB,SAAS,GAAkB,EAAE,CAAA;IAErC,SAAS,CAAC,EAAe;QACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACvB,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,gDAAgD,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,KAAK,KAAW,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA,CAAC,CAAC;CACtC;AAED,MAAM,EAAE,GAAG,UAAqC,CAAA;AAChD,IAAI,CAAC,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC;IACtC,EAAE,CAAC,4BAA4B,CAAC,GAAG,IAAI,mBAAmB,EAAE,CAAA;AAC9D,CAAC;AACD,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC,4BAA4B,CAAwB,CAAA"}

package/dist/provider.d.ts

@@ -1,4 +1,6 @@
-import type { Application } from '@rudderjs/core';
 import { ServiceProvider } from '@rudderjs/core';
-export declare function mcp(): new (app: Application) => ServiceProvider;
+export declare class McpProvider extends ServiceProvider {
+    register(): void;
+    boot(): Promise<void>;
+}
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhD,qBAAa,WAAY,SAAQ,eAAe;IAC9C,QAAQ,IAAI,IAAI;IAIV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA4F5B"}

package/dist/provider.js

@@ -1,51 +1,89 @@
 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() {
+export class McpProvider extends ServiceProvider {
+    register() {
+        this.app.instance('mcp', Mcp);
+    }
+    async boot() {
+        const webServers = Mcp.getWebServers();
+        if (webServers.size > 0) {
             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}`);
-                        }
+                const { mountHttpTransport } = await import('./runtime.js');
+                const { oauth2McpMiddleware, registerOAuth2Metadata } = await import('./auth/oauth2.js');
+                let router;
+                try {
+                    const { resolveOptionalPeer } = await import('@rudderjs/core');
+                    const mod = await resolveOptionalPeer('@rudderjs/router');
+                    router = mod.router;
+                }
+                catch { /* no router */ }
+                for (const [path, entry] of webServers) {
+                    const server = new entry.server();
+                    const middleware = [...entry.middleware];
+                    if (entry.oauth2) {
+                        middleware.unshift(oauth2McpMiddleware(path, entry.oauth2));
+                        if (router)
+                            registerOAuth2Metadata(router, path, entry.oauth2);
                     }
-                }).description('List registered MCP servers');
+                    await mountHttpTransport(server, path, { middleware });
+                }
             }
             catch {
-                // rudder not available
+                // router or transport not available — skip web mounting
             }
         }
+        try {
+            const { resolveOptionalPeer } = await import('@rudderjs/core');
+            const { registerMakeSpecs } = await resolveOptionalPeer('@rudderjs/rudder');
+            const { makeMcpServerSpec } = await import('./commands/make-mcp-server.js');
+            const { makeMcpToolSpec } = await import('./commands/make-mcp-tool.js');
+            const { makeMcpResourceSpec } = await import('./commands/make-mcp-resource.js');
+            const { makeMcpPromptSpec } = await import('./commands/make-mcp-prompt.js');
+            registerMakeSpecs(makeMcpServerSpec, makeMcpToolSpec, makeMcpResourceSpec, makeMcpPromptSpec);
+        }
+        catch { /* rudder not available */ }
+        try {
+            const { rudder } = await import('@rudderjs/core');
+            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)');
+            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');
+            rudder.command('mcp:inspector', async (args) => {
+                const portIdx = args.indexOf('--port');
+                const port = portIdx >= 0 && args[portIdx + 1] ? Number.parseInt(args[portIdx + 1], 10) : 9100;
+                const { startInspector } = await import('./commands/inspector.js');
+                await startInspector({ port });
+            }).description('Launch a web UI for interactively testing registered MCP servers');
+        }
+        catch {
+            // rudder not available
+        }
     }
-    return McpServiceProvider;
 }
 //# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/runtime.d.ts

@@ -1,6 +1,36 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import type { McpServer } from './McpServer.js';
+/**
+ * Read `design:paramtypes` for the given method and resolve all parameters
+ * beyond index 0 from the DI container. Index 0 is reserved for the tool
+ * input (or resource params / prompt arguments).
+ *
+ * Returns an empty array if:
+ *   - the method wasn't decorated (no metadata emitted by TS)
+ *   - the framework container isn't available
+ *   - no extra parameters were declared
+ */
+export declare function resolveHandleDeps(instance: object, propertyKey: string): unknown[];
 export declare function createSdkServer(server: McpServer): Server;
 /** Start a server with stdio transport */
 export declare function startStdio(server: McpServer): Promise<void>;
+export interface HttpTransportOptions {
+    /** Middleware to apply before MCP request handling */
+    middleware?: unknown[];
+    /** Generate session IDs for stateful mode. Set to undefined for stateless. */
+    sessionIdGenerator?: (() => string) | undefined;
+}
+/**
+ * Mount an MCP server on the framework's router at the given path.
+ *
+ * Uses the MCP SDK's `WebStandardStreamableHTTPServerTransport` which
+ * accepts Web Standard `Request` objects and returns `Response` — a
+ * natural fit for Hono (the framework's server adapter).
+ *
+ * The transport handles all three HTTP methods:
+ * - POST — JSON-RPC messages (initialization + ongoing)
+ * - GET  — SSE stream for server-initiated notifications
+ * - DELETE — session termination
+ */
+export declare function mountHttpTransport(server: McpServer, path: string, options?: HttpTransportOptions): Promise<void>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAWlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAwE/C;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,EAAE,CAmClF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA6JzD;AAED,0CAA0C;AAC1C,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjE;AAID,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;IACtB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAA;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAuEf"}