@candide/nestjs-mcp-server 1.1.0

package/dist/decorators/index.d.ts

@@ -0,0 +1,5 @@
+export * from './prompt.decorator';
+export * from './resolver.decorator';
+export * from './resource.decorator';
+export * from './tool.decorator';
+export * from './user-guard.decorator';

package/dist/decorators/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./prompt.decorator"), exports);
+__exportStar(require("./resolver.decorator"), exports);
+__exportStar(require("./resource.decorator"), exports);
+__exportStar(require("./tool.decorator"), exports);
+__exportStar(require("./user-guard.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,mDAAiC;AACjC,yDAAuC"}

package/dist/decorators/prompt.decorator.d.ts

@@ -0,0 +1,15 @@
+import { PromptArgsRawShape } from '../mcp.types';
+export interface PromptBaseOptions {
+    name: string;
+}
+export interface PromptWithDescriptionOptions extends PromptBaseOptions {
+    description: string;
+}
+export interface PromptWithArgsSchemaOptions extends PromptBaseOptions {
+    argsSchema: PromptArgsRawShape;
+}
+export interface PromptWithDescriptionAndArgsSchemaOptions extends PromptWithDescriptionOptions, PromptWithArgsSchemaOptions {
+}
+export type PromptOptions = PromptBaseOptions | PromptWithDescriptionOptions | PromptWithArgsSchemaOptions | PromptWithDescriptionAndArgsSchemaOptions;
+export declare const MCP_PROMPT = "__mcp_prompt__";
+export declare function Prompt(options: PromptOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/prompt.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_PROMPT = void 0;
+exports.Prompt = Prompt;
+const common_1 = require("@nestjs/common");
+exports.MCP_PROMPT = '__mcp_prompt__';
+function Prompt(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_PROMPT, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=prompt.decorator.js.map

package/dist/decorators/prompt.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.decorator.js","sourceRoot":"","sources":["../../src/decorators/prompt.decorator.ts"],"names":[],"mappings":";;;AA+CA,wBAaC;AA5DD,2CAA6C;AA0BhC,QAAA,UAAU,GAAG,gBAAgB,CAAC;AAqB3C,SAAgB,MAAM,CAAC,OAAsB;IAC3C,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,kBAAU,EAAE;YACtB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAEpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/resolver.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const MCP_RESOLVER = "__mcp_resolver__";
+export declare function Resolver(workspace?: string): ClassDecorator;

package/dist/decorators/resolver.decorator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_RESOLVER = void 0;
+exports.Resolver = Resolver;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@nestjs/common");
+exports.MCP_RESOLVER = '__mcp_resolver__';
+function Resolver(workspace) {
+    return function (target) {
+        (0, common_1.Injectable)()(target);
+        (0, common_2.SetMetadata)(exports.MCP_RESOLVER, workspace || true)(target);
+    };
+}
+//# sourceMappingURL=resolver.decorator.js.map

package/dist/decorators/resolver.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.decorator.js","sourceRoot":"","sources":["../../src/decorators/resolver.decorator.ts"],"names":[],"mappings":";;;AAkBA,4BAKC;AAvBD,2CAA4C;AAE5C,2CAA6C;AAKhC,QAAA,YAAY,GAAG,kBAAkB,CAAC;AAW/C,SAAgB,QAAQ,CAAC,SAAkB;IACzC,OAAO,UAAU,MAAW;QAC1B,IAAA,mBAAU,GAAE,CAAC,MAAM,CAAC,CAAC;QACrB,IAAA,oBAAW,EAAC,oBAAY,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/resource.decorator.d.ts

@@ -0,0 +1,18 @@
+export interface ResourceBaseOptions {
+    name: string;
+}
+export interface ResourceUriOptions extends ResourceBaseOptions {
+    uri: string;
+}
+export interface ResourceUriWithMetadataOptions extends ResourceUriOptions {
+    metadata: Record<string, any>;
+}
+export interface ResourceTemplateOptions extends ResourceBaseOptions {
+    template: string;
+}
+export interface ResourceTemplateWithMetadataOptions extends ResourceTemplateOptions {
+    metadata: Record<string, any>;
+}
+export type ResourceOptions = ResourceUriOptions | ResourceUriWithMetadataOptions | ResourceTemplateOptions | ResourceTemplateWithMetadataOptions;
+export declare const MCP_RESOURCE = "__mcp_resource__";
+export declare function Resource(options: ResourceOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/resource.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_RESOURCE = void 0;
+exports.Resource = Resource;
+const common_1 = require("@nestjs/common");
+exports.MCP_RESOURCE = '__mcp_resource__';
+function Resource(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_RESOURCE, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=resource.decorator.js.map

package/dist/decorators/resource.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.decorator.js","sourceRoot":"","sources":["../../src/decorators/resource.decorator.ts"],"names":[],"mappings":";;;AAqDA,4BAYC;AAjED,2CAA6C;AA4BhC,QAAA,YAAY,GAAG,kBAAkB,CAAC;AAyB/C,SAAgB,QAAQ,CAAC,OAAwB;IAC/C,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,oBAAY,EAAE;YACxB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/tool.decorator.d.ts

@@ -0,0 +1,30 @@
+import { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
+import { ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+export interface ToolBaseOptions {
+    name: string;
+}
+export interface ToolWithDescriptionOptions extends ToolBaseOptions {
+    description: string;
+}
+export interface ToolWithParamsSchemaOptions extends ToolBaseOptions {
+    paramsSchema: ZodRawShapeCompat;
+}
+export interface ToolWithParamsSchemaAndDescriptionOptions extends ToolWithParamsSchemaOptions {
+    description: string;
+}
+export interface ToolWithAnnotationsOptions extends ToolBaseOptions {
+    annotations: ToolAnnotations;
+}
+export interface ToolWithAnnotationsAndDescriptionOptions extends ToolWithAnnotationsOptions {
+    description: string;
+}
+export interface ToolWithParamsSchemaAndAnnotationsOptions extends ToolBaseOptions {
+    paramsSchema: ZodRawShapeCompat;
+    annotations: ToolAnnotations;
+}
+export interface ToolWithParamsSchemaAndAnnotationsAndDescriptionOptions extends ToolWithParamsSchemaAndAnnotationsOptions {
+    description: string;
+}
+export type ToolOptions = ToolBaseOptions | ToolWithDescriptionOptions | ToolWithParamsSchemaOptions | ToolWithParamsSchemaAndDescriptionOptions | ToolWithAnnotationsOptions | ToolWithAnnotationsAndDescriptionOptions | ToolWithParamsSchemaAndAnnotationsOptions | ToolWithParamsSchemaAndAnnotationsAndDescriptionOptions;
+export declare const MCP_TOOL = "__mcp_tool__";
+export declare function Tool(options: ToolOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/tool.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_TOOL = void 0;
+exports.Tool = Tool;
+const common_1 = require("@nestjs/common");
+exports.MCP_TOOL = '__mcp_tool__';
+function Tool(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_TOOL, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=tool.decorator.js.map

package/dist/decorators/tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAiEA,oBAaC;AA5ED,2CAA6C;AA6ChC,QAAA,QAAQ,GAAG,cAAc,CAAC;AAkBvC,SAAgB,IAAI,CAAC,OAAoB;IACvC,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,gBAAQ,EAAE;YACpB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAEpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/user-guard.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const MCP_GUARDS = "__mcp_guards__";
+export declare function UseGuards(...guards: any[]): ClassDecorator & MethodDecorator;

package/dist/decorators/user-guard.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_GUARDS = void 0;
+exports.UseGuards = UseGuards;
+const common_1 = require("@nestjs/common");
+exports.MCP_GUARDS = '__mcp_guards__';
+function UseGuards(...guards) {
+    return (0, common_1.SetMetadata)(exports.MCP_GUARDS, guards);
+}
+//# sourceMappingURL=user-guard.decorator.js.map

package/dist/decorators/user-guard.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-guard.decorator.js","sourceRoot":"","sources":["../../src/decorators/user-guard.decorator.ts"],"names":[],"mappings":";;;AAiBA,8BAEC;AAnBD,2CAA6C;AAKhC,QAAA,UAAU,GAAG,gBAAgB,CAAC;AAY3C,SAAgB,SAAS,CAAC,GAAG,MAAa;IACxC,OAAO,IAAA,oBAAW,EAAC,kBAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './mcp.module';
+export * from './mcp.types';
+export * from './interfaces';
+export * from './types/handler-args.types';
+export * from './services';
+export * from './decorators';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp.module"), exports);
+__exportStar(require("./mcp.types"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./types/handler-args.types"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./decorators"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,+CAA6B;AAC7B,8CAA4B;AAG5B,+CAA6B;AAG7B,6DAA2C;AAG3C,6CAA2B;AAG3B,+CAA6B"}

package/dist/interfaces/context.interface.d.ts

@@ -0,0 +1,11 @@
+import type { Type } from '@nestjs/common';
+import type { Request } from 'express';
+import type { McpHandlerArgs } from '../types/handler-args.types';
+export interface McpExecutionContext {
+    getType(): 'mcp';
+    getHandler(): (...args: any[]) => any;
+    getClass(): Type<any>;
+    getSessionId(): string;
+    getArgs<T = McpHandlerArgs>(): T;
+    getRequest<R = Request>(): R;
+}

package/dist/interfaces/context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context.interface.js.map

package/dist/interfaces/context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.interface.js","sourceRoot":"","sources":["../../src/interfaces/context.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './context.interface';

package/dist/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./context.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/mcp-core.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { McpFeatureOptions, McpModuleAsyncOptions, McpModuleOptions } from './mcp.types';
+export declare class McpCoreModule {
+    private static getActiveTransportControllersAndProviders;
+    private static buildServerConfig;
+    private static createAsyncOptionsProvider;
+    private static createAsyncProviders;
+    static forRoot(options: McpModuleOptions): DynamicModule;
+    static forRootAsync(options: McpModuleAsyncOptions): DynamicModule;
+    static forFeature(_options?: McpFeatureOptions): DynamicModule;
+}

package/dist/mcp-core.module.js

@@ -0,0 +1,218 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var McpCoreModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpCoreModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const async_hooks_1 = require("async_hooks");
+const mcp_constants_1 = require("./mcp.constants");
+const discovery_service_1 = require("./services/discovery.service");
+const logger_service_1 = require("./services/logger.service");
+const registry_service_1 = require("./services/registry.service");
+const session_manager_1 = require("./services/session.manager");
+const sse_1 = require("./transports/sse");
+const streamable_1 = require("./transports/streamable");
+let McpCoreModule = McpCoreModule_1 = class McpCoreModule {
+    static getActiveTransportControllersAndProviders(transports, endpoints) {
+        const controllers = new Set();
+        const providers = new Set();
+        const STREAMABLE_TRANSPORT = {
+            controller: (0, streamable_1.createStreamableController)(endpoints?.mcpEndpoint || 'mcp'),
+            service: streamable_1.StreamableService,
+        };
+        const SSE_TRANSPORT = {
+            controller: (0, sse_1.createSseController)(endpoints?.sseEndpoint || 'sse', endpoints?.messagesEndpoint || 'messages'),
+            service: sse_1.SseService,
+        };
+        const defaultTransports = {
+            streamable: { enabled: true },
+            sse: { enabled: true },
+        };
+        const config = {
+            streamable: {
+                ...defaultTransports.streamable,
+                ...(transports?.streamable ?? {}),
+            },
+            sse: {
+                ...defaultTransports.sse,
+                ...(transports?.sse ?? {}),
+            },
+        };
+        if (config.streamable.enabled) {
+            controllers.add(STREAMABLE_TRANSPORT.controller);
+            providers.add(STREAMABLE_TRANSPORT.service);
+        }
+        if (config.sse.enabled) {
+            controllers.add(SSE_TRANSPORT.controller);
+            providers.add(SSE_TRANSPORT.service);
+        }
+        return {
+            controllers: Array.from(controllers),
+            providers: Array.from(providers),
+        };
+    }
+    static buildServerConfig(options) {
+        const serverInfo = {
+            name: options.name,
+            version: options.version,
+        };
+        const serverOptions = {
+            instructions: options?.instructions,
+            capabilities: options?.capabilities,
+            ...(options?.protocolOptions || {}),
+        };
+        const loggingOptions = {
+            enabled: options.logging?.enabled !== false,
+            level: options.logging?.level || 'verbose',
+        };
+        return { serverInfo, serverOptions, loggingOptions };
+    }
+    static createAsyncOptionsProvider(options) {
+        return {
+            provide: mcp_constants_1.MCP_MODULE_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject || [],
+        };
+    }
+    static createAsyncProviders(options) {
+        return [
+            this.createAsyncOptionsProvider(options),
+            {
+                provide: mcp_constants_1.MCP_LOGGING_OPTIONS,
+                useFactory: (mcpOptions) => ({
+                    enabled: mcpOptions.logging?.enabled !== false,
+                    level: mcpOptions.logging?.level || 'verbose',
+                }),
+                inject: [mcp_constants_1.MCP_MODULE_OPTIONS],
+            },
+            {
+                provide: mcp_constants_1.MCP_TRANSPORT_OPTIONS,
+                useFactory: (mcpOptions) => mcpOptions.transports,
+                inject: [mcp_constants_1.MCP_MODULE_OPTIONS],
+            },
+            {
+                provide: mcp_constants_1.MCP_SESSION_OPTIONS,
+                useFactory: (mcpOptions) => ({
+                    sessionTimeoutMs: mcpOptions.session?.sessionTimeoutMs ?? 1800000,
+                    cleanupIntervalMs: mcpOptions.session?.cleanupIntervalMs ?? 300000,
+                    maxConcurrentSessions: mcpOptions.session?.maxConcurrentSessions ?? 1000,
+                }),
+                inject: [mcp_constants_1.MCP_MODULE_OPTIONS],
+            },
+            {
+                provide: mcp_constants_1.MCP_SERVER_OPTIONS,
+                useFactory: (mcpOptions) => {
+                    const { serverInfo, serverOptions, loggingOptions } = McpCoreModule_1.buildServerConfig(mcpOptions);
+                    return {
+                        serverInfo,
+                        options: serverOptions,
+                        logging: loggingOptions,
+                    };
+                },
+                inject: [mcp_constants_1.MCP_MODULE_OPTIONS],
+            },
+        ];
+    }
+    static forRoot(options) {
+        const imports = options.imports || [];
+        const { controllers, providers } = this.getActiveTransportControllersAndProviders(options.transports, {
+            mcpEndpoint: options.mcpEndpoint,
+            sseEndpoint: options.sseEndpoint,
+            messagesEndpoint: options.messagesEndpoint,
+        });
+        const allProviders = [...(options.providers || []), ...providers];
+        const { serverInfo, serverOptions, loggingOptions } = this.buildServerConfig(options);
+        return {
+            module: McpCoreModule_1,
+            imports,
+            controllers,
+            providers: [
+                ...allProviders,
+                {
+                    provide: mcp_constants_1.MCP_SERVER_OPTIONS,
+                    useValue: {
+                        serverInfo,
+                        options: serverOptions,
+                        logging: loggingOptions,
+                    },
+                },
+                {
+                    provide: mcp_constants_1.MCP_LOGGING_OPTIONS,
+                    useValue: loggingOptions,
+                },
+                {
+                    provide: mcp_constants_1.MCP_TRANSPORT_OPTIONS,
+                    useValue: options.transports,
+                },
+                {
+                    provide: mcp_constants_1.MCP_SESSION_OPTIONS,
+                    useValue: {
+                        sessionTimeoutMs: options.session?.sessionTimeoutMs ?? 1800000,
+                        cleanupIntervalMs: options.session?.cleanupIntervalMs ?? 300000,
+                        maxConcurrentSessions: options.session?.maxConcurrentSessions ?? 1000,
+                    },
+                },
+                {
+                    provide: mcp_constants_1.MCP_WORKSPACE,
+                    useValue: options.workspace ?? null,
+                },
+            ],
+            global: true,
+        };
+    }
+    static forRootAsync(options) {
+        const { imports = [] } = options;
+        const asyncProviders = this.createAsyncProviders(options);
+        const { controllers, providers } = McpCoreModule_1.getActiveTransportControllersAndProviders({
+            sse: { enabled: true },
+            streamable: { enabled: true },
+        });
+        return {
+            module: McpCoreModule_1,
+            imports,
+            controllers,
+            providers: [
+                ...asyncProviders,
+                ...providers,
+                registry_service_1.RegistryService,
+                discovery_service_1.DiscoveryService,
+                logger_service_1.McpLoggerService,
+                session_manager_1.SessionManager,
+                {
+                    provide: async_hooks_1.AsyncLocalStorage,
+                    useValue: new async_hooks_1.AsyncLocalStorage(),
+                },
+            ],
+            global: true,
+        };
+    }
+    static forFeature(_options) {
+        return {
+            module: McpCoreModule_1,
+        };
+    }
+};
+exports.McpCoreModule = McpCoreModule;
+exports.McpCoreModule = McpCoreModule = McpCoreModule_1 = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [
+            registry_service_1.RegistryService,
+            discovery_service_1.DiscoveryService,
+            {
+                provide: async_hooks_1.AsyncLocalStorage,
+                useValue: new async_hooks_1.AsyncLocalStorage(),
+            },
+            logger_service_1.McpLoggerService,
+            session_manager_1.SessionManager,
+        ],
+        exports: [session_manager_1.SessionManager],
+    })
+], McpCoreModule);
+//# sourceMappingURL=mcp-core.module.js.map

package/dist/mcp-core.module.js.map

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

package/dist/mcp.constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MCP_MODULE_OPTIONS: unique symbol;
+export declare const MCP_SERVER_OPTIONS: unique symbol;
+export declare const MCP_LOGGING_OPTIONS: unique symbol;
+export declare const MCP_TRANSPORT_OPTIONS: unique symbol;
+export declare const MCP_SESSION_OPTIONS: unique symbol;
+export declare const MCP_WORKSPACE: unique symbol;

package/dist/mcp.constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_WORKSPACE = exports.MCP_SESSION_OPTIONS = exports.MCP_TRANSPORT_OPTIONS = exports.MCP_LOGGING_OPTIONS = exports.MCP_SERVER_OPTIONS = exports.MCP_MODULE_OPTIONS = void 0;
+exports.MCP_MODULE_OPTIONS = Symbol('MCP_MODULE_OPTIONS');
+exports.MCP_SERVER_OPTIONS = Symbol('MCP_SERVER_OPTIONS');
+exports.MCP_LOGGING_OPTIONS = Symbol('MCP_LOGGING_OPTIONS');
+exports.MCP_TRANSPORT_OPTIONS = Symbol('MCP_TRANSPORT_OPTIONS');
+exports.MCP_SESSION_OPTIONS = Symbol('MCP_SESSION_OPTIONS');
+exports.MCP_WORKSPACE = Symbol('MCP_WORKSPACE');
+//# sourceMappingURL=mcp.constants.js.map

package/dist/mcp.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.constants.js","sourceRoot":"","sources":["../src/mcp.constants.ts"],"names":[],"mappings":";;;AAMa,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAGlD,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAGlD,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAGpD,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAGxD,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAGpD,QAAA,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC"}

package/dist/mcp.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { McpFeatureOptions, McpModuleOptions } from './mcp.types';
+export declare class McpModule {
+    static forRoot(options: McpModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<McpModuleOptions> | McpModuleOptions;
+        inject?: any[];
+    }): DynamicModule;
+    static forFeature(options?: McpFeatureOptions): DynamicModule;
+}

package/dist/mcp.module.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var McpModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpModule = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_core_module_1 = require("./mcp-core.module");
+let McpModule = McpModule_1 = class McpModule {
+    static forRoot(options) {
+        return {
+            module: McpModule_1,
+            imports: [mcp_core_module_1.McpCoreModule.forRoot(options)],
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: McpModule_1,
+            imports: [mcp_core_module_1.McpCoreModule.forRootAsync(options)],
+        };
+    }
+    static forFeature(options) {
+        const coreFeatureModule = mcp_core_module_1.McpCoreModule.forFeature(options);
+        return {
+            module: McpModule_1,
+            imports: coreFeatureModule.imports ?? [],
+            providers: coreFeatureModule.providers,
+            exports: coreFeatureModule.exports,
+        };
+    }
+};
+exports.McpModule = McpModule;
+exports.McpModule = McpModule = McpModule_1 = __decorate([
+    (0, common_1.Module)({})
+], McpModule);
+//# sourceMappingURL=mcp.module.js.map

package/dist/mcp.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AAEvD,uDAAkD;AAI3C,IAAM,SAAS,iBAAf,MAAM,SAAS;IAIpB,MAAM,CAAC,OAAO,CAAC,OAAyB;QACtC,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE,CAAC,+BAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SAC1C,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,YAAY,CAAC,OAMnB;QACC,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE,CAAC,+BAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;SAC/C,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,UAAU,CAAC,OAA2B;QAC3C,MAAM,iBAAiB,GAAG,+BAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE,iBAAiB,CAAC,OAAO,IAAI,EAAE;YACxC,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,OAAO,EAAE,iBAAiB,CAAC,OAAO;SACnC,CAAC;IACJ,CAAC;CACF,CAAA;AAvCY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAuCrB"}