@iludolf/mcp-adapter 1.0.0

package/README.md

@@ -0,0 +1,168 @@
+# @iludolf/mcp-adapter
+
+NestJS module for Model Context Protocol (MCP) integration. Enables your NestJS application to act as an MCP server, exposing tools, resources, and prompts to AI assistants.
+
+## Installation
+
+```bash
+npm install @iludolf/mcp-adapter
+# or
+pnpm add @iludolf/mcp-adapter
+# or  
+yarn add @iludolf/mcp-adapter
+```
+
+## Peer Dependencies
+
+Make sure you have these peer dependencies installed:
+
+```bash
+npm install @modelcontextprotocol/sdk @nestjs/common @nestjs/core reflect-metadata rxjs zod
+```
+
+## Quick Start
+
+### 1. Import the module
+
+```typescript
+import { Module } from "@nestjs/common"
+import { McpModule, TransportType } from "@iludolf/mcp-adapter"
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      serverInfo: {
+        name: "my-mcp-server",
+        version: "1.0.0",
+      },
+      transport: TransportType.SSE, // or TransportType.STDIO
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 2. Create MCP handlers
+
+```typescript
+import { Injectable } from "@nestjs/common"
+import { McpTool, McpResource, McpPrompt } from "@iludolf/mcp-adapter"
+import { z } from "zod"
+
+@Injectable()
+export class MyMcpHandlers {
+  @McpTool({
+    name: "calculator",
+    description: "Performs basic arithmetic",
+    paramsSchema: {
+      operation: z.enum(["add", "subtract"]),
+      a: z.number(),
+      b: z.number(),
+    },
+  })
+  async calculate(args: { operation: string; a: number; b: number }) {
+    const result = args.operation === "add" 
+      ? args.a + args.b 
+      : args.a - args.b
+    return { content: [{ type: "text", text: String(result) }] }
+  }
+
+  @McpResource({
+    name: "config",
+    uri: "config://app",
+    description: "Application configuration",
+  })
+  async getConfig() {
+    return {
+      contents: [{
+        uri: "config://app",
+        mimeType: "application/json",
+        text: JSON.stringify({ version: "1.0.0" }),
+      }],
+    }
+  }
+
+  @McpPrompt({
+    name: "greeting",
+    description: "Generate a greeting",
+    arguments: [{ name: "name", required: true }],
+  })
+  async generateGreeting(params: { arguments: { name: string } }) {
+    return {
+      messages: [{
+        role: "assistant",
+        content: { type: "text", text: `Hello, ${params.arguments.name}!` },
+      }],
+    }
+  }
+}
+```
+
+### 3. Register the handlers provider
+
+```typescript
+@Module({
+  imports: [McpModule.forRoot({ /* ... */ })],
+  providers: [MyMcpHandlers],
+})
+export class AppModule {}
+```
+
+## Configuration Options
+
+### McpModuleOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `serverInfo` | `Implementation` | required | Server name and version |
+| `serverOptions` | `ServerOptions` | - | MCP SDK server options |
+| `transport` | `TransportType` | `STDIO` | Transport type (STDIO, SSE, HTTP, NONE) |
+| `logger` | `McpLogger` | `DefaultMcpLogger` | Custom logger |
+| `basePath` | `string` | `"mcp"` | Base path for HTTP endpoints |
+| `global` | `boolean` | `false` | Register module globally |
+
+### Async Configuration
+
+```typescript
+McpModule.forRootAsync({
+  imports: [ConfigModule],
+  useFactory: (config: ConfigService) => ({
+    serverInfo: {
+      name: config.get("MCP_NAME"),
+      version: config.get("MCP_VERSION"),
+    },
+    transport: TransportType.SSE,
+  }),
+  inject: [ConfigService],
+})
+```
+
+## HTTP Endpoints (SSE/HTTP transport)
+
+When using SSE or HTTP transport, the following endpoints are available:
+
+- `GET /{basePath}/sse` - SSE connection endpoint
+- `POST /{basePath}/messages` - Message handling endpoint  
+- `GET /{basePath}/health` - Health check endpoint
+
+## Custom Logger
+
+```typescript
+import { McpLogger } from "@iludolf/mcp-adapter"
+
+class MyLogger implements McpLogger {
+  info(message: string, context?: string) { /* ... */ }
+  warn(message: string, context?: string) { /* ... */ }
+  error(message: string, context?: string, trace?: string) { /* ... */ }
+  debug(message: string, context?: string) { /* ... */ }
+}
+
+McpModule.forRoot({
+  serverInfo: { name: "my-server", version: "1.0.0" },
+  logger: new MyLogger(),
+})
+```
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const MCP_MODULE_OPTIONS = "MCP_MODULE_OPTIONS";
+export declare const MCP_LOGGER = "MCP_LOGGER";
+export declare const MCP_SERVER_INSTANCE = "MCP_SERVER_INSTANCE";
+export declare const DEFAULT_MCP_PATH = "mcp";
+export declare const MCP_LOGGER_CONTEXT = "Mcp-server";

package/dist/constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_LOGGER_CONTEXT = exports.DEFAULT_MCP_PATH = exports.MCP_SERVER_INSTANCE = exports.MCP_LOGGER = exports.MCP_MODULE_OPTIONS = void 0;
+exports.MCP_MODULE_OPTIONS = "MCP_MODULE_OPTIONS";
+exports.MCP_LOGGER = "MCP_LOGGER";
+exports.MCP_SERVER_INSTANCE = "MCP_SERVER_INSTANCE";
+exports.DEFAULT_MCP_PATH = "mcp";
+exports.MCP_LOGGER_CONTEXT = "Mcp-server";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAGa,QAAA,kBAAkB,GAAG,oBAAoB,CAAA;AAKzC,QAAA,UAAU,GAAG,YAAY,CAAA;AAKzB,QAAA,mBAAmB,GAAG,qBAAqB,CAAA;AAK3C,QAAA,gBAAgB,GAAG,KAAK,CAAA;AAKxB,QAAA,kBAAkB,GAAG,YAAY,CAAA"}

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

@@ -0,0 +1 @@
+export declare const createMcpDecorator: <T = any>(metadataKey: string, options?: T) => MethodDecorator;

package/dist/decorators/base.decorator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpDecorator = void 0;
+const common_1 = require("@nestjs/common");
+const createMcpDecorator = (metadataKey, options) => {
+    return (target, key, descriptor) => {
+        const metadata = {
+            methodName: key,
+            options,
+        };
+        (0, common_1.SetMetadata)(metadataKey, metadata)(target, key, descriptor);
+    };
+};
+exports.createMcpDecorator = createMcpDecorator;
+//# sourceMappingURL=base.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.decorator.js","sourceRoot":"","sources":["../../src/decorators/base.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAWrC,MAAM,kBAAkB,GAAG,CAChC,WAAmB,EACnB,OAAW,EACM,EAAE;IACnB,OAAO,CACL,MAAc,EACd,GAAoB,EACpB,UAA8B,EAC9B,EAAE;QACF,MAAM,QAAQ,GAAkB;YAC9B,UAAU,EAAE,GAAa;YACzB,OAAO;SACR,CAAA;QACD,IAAA,oBAAW,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAA;IAC7D,CAAC,CAAA;AACH,CAAC,CAAA;AAfY,QAAA,kBAAkB,sBAe9B"}

package/dist/decorators/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const MCP_RESOURCE_METADATA = "mcp:resource";
+export declare const MCP_TOOL_METADATA = "mcp:tool";
+export declare const MCP_PROMPT_METADATA = "mcp:prompt";

package/dist/decorators/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_PROMPT_METADATA = exports.MCP_TOOL_METADATA = exports.MCP_RESOURCE_METADATA = void 0;
+exports.MCP_RESOURCE_METADATA = "mcp:resource";
+exports.MCP_TOOL_METADATA = "mcp:tool";
+exports.MCP_PROMPT_METADATA = "mcp:prompt";
+//# sourceMappingURL=constants.js.map

package/dist/decorators/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAGa,QAAA,qBAAqB,GAAG,cAAc,CAAA;AAKtC,QAAA,iBAAiB,GAAG,UAAU,CAAA;AAK9B,QAAA,mBAAmB,GAAG,YAAY,CAAA"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./constants";
+export * from "./base.decorator";
+export * from "./mcp-resource.decorator";
+export * from "./mcp-tool.decorator";
+export * from "./mcp-prompt.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("./constants"), exports);
+__exportStar(require("./base.decorator"), exports);
+__exportStar(require("./mcp-resource.decorator"), exports);
+__exportStar(require("./mcp-tool.decorator"), exports);
+__exportStar(require("./mcp-prompt.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,8CAA2B;AAC3B,mDAAgC;AAChC,2DAAwC;AACxC,uDAAoC;AACpC,yDAAsC"}

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

@@ -0,0 +1,2 @@
+import { Prompt as PromptType } from "@modelcontextprotocol/sdk/types.js";
+export declare const McpPrompt: (options: PromptType) => MethodDecorator;

package/dist/decorators/mcp-prompt.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPrompt = void 0;
+const base_decorator_1 = require("./base.decorator");
+const constants_1 = require("./constants");
+const McpPrompt = (options) => (0, base_decorator_1.createMcpDecorator)(constants_1.MCP_PROMPT_METADATA, options);
+exports.McpPrompt = McpPrompt;
+//# sourceMappingURL=mcp-prompt.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-prompt.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-prompt.decorator.ts"],"names":[],"mappings":";;;AAEA,qDAAqD;AACrD,2CAAiD;AA2C1C,MAAM,SAAS,GAAG,CAAC,OAAmB,EAAmB,EAAE,CAChE,IAAA,mCAAkB,EAAC,+BAAmB,EAAE,OAAO,CAAC,CAAA;AADrC,QAAA,SAAS,aAC4B"}

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

@@ -0,0 +1,2 @@
+import { ResourceOptions } from "../interfaces";
+export declare const McpResource: (options: ResourceOptions) => MethodDecorator;

package/dist/decorators/mcp-resource.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpResource = void 0;
+const base_decorator_1 = require("./base.decorator");
+const constants_1 = require("./constants");
+const McpResource = (options) => (0, base_decorator_1.createMcpDecorator)(constants_1.MCP_RESOURCE_METADATA, options);
+exports.McpResource = McpResource;
+//# sourceMappingURL=mcp-resource.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-resource.decorator.ts"],"names":[],"mappings":";;;AACA,qDAAqD;AACrD,2CAAmD;AAiC5C,MAAM,WAAW,GAAG,CAAC,OAAwB,EAAmB,EAAE,CACvE,IAAA,mCAAkB,EAAC,iCAAqB,EAAE,OAAO,CAAC,CAAA;AADvC,QAAA,WAAW,eAC4B"}

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

@@ -0,0 +1,2 @@
+import { ToolOptions } from "../interfaces";
+export declare const McpTool: (options: ToolOptions) => MethodDecorator;

package/dist/decorators/mcp-tool.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpTool = void 0;
+const base_decorator_1 = require("./base.decorator");
+const constants_1 = require("./constants");
+const McpTool = (options) => (0, base_decorator_1.createMcpDecorator)(constants_1.MCP_TOOL_METADATA, options);
+exports.McpTool = McpTool;
+//# sourceMappingURL=mcp-tool.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;;AACA,qDAAqD;AACrD,2CAA+C;AA8BxC,MAAM,OAAO,GAAG,CAAC,OAAoB,EAAmB,EAAE,CAC/D,IAAA,mCAAkB,EAAC,6BAAiB,EAAE,OAAO,CAAC,CAAA;AADnC,QAAA,OAAO,WAC4B"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./mcp.module";
+export * from "./constants";
+export * from "./interfaces";
+export * from "./decorators";
+export * from "./services";
+export * from "./mcp.controller";

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("./constants"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./mcp.controller"), 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,+CAA4B;AAG5B,8CAA2B;AAG3B,+CAA4B;AAG5B,+CAA4B;AAG5B,6CAA0B;AAG1B,mDAAgC"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./mcp-logger.interface";
+export * from "./mcp-module-options.interface";

package/dist/interfaces/index.js

@@ -0,0 +1,19 @@
+"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-logger.interface"), exports);
+__exportStar(require("./mcp-module-options.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,yDAAsC;AACtC,iEAA8C"}

package/dist/interfaces/mcp-logger.interface.d.ts

@@ -0,0 +1,12 @@
+export interface McpLogger {
+    info(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    error(message: string, context?: string, trace?: string): void;
+    debug(message: string, context?: string): void;
+}
+export declare class DefaultMcpLogger implements McpLogger {
+    info(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    error(message: string, context?: string, trace?: string): void;
+    debug(message: string, context?: string): void;
+}

package/dist/interfaces/mcp-logger.interface.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultMcpLogger = void 0;
+class DefaultMcpLogger {
+    info(message, context) {
+        console.log(`[INFO] ${context ? `[${context}] ` : ""}${message}`);
+    }
+    warn(message, context) {
+        console.warn(`[WARN] ${context ? `[${context}] ` : ""}${message}`);
+    }
+    error(message, context, trace) {
+        console.error(`[ERROR] ${context ? `[${context}] ` : ""}${message}`);
+        if (trace) {
+            console.error(trace);
+        }
+    }
+    debug(message, context) {
+        console.debug(`[DEBUG] ${context ? `[${context}] ` : ""}${message}`);
+    }
+}
+exports.DefaultMcpLogger = DefaultMcpLogger;
+//# sourceMappingURL=mcp-logger.interface.js.map

package/dist/interfaces/mcp-logger.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-logger.interface.js","sourceRoot":"","sources":["../../src/interfaces/mcp-logger.interface.ts"],"names":[],"mappings":";;;AA8BA,MAAa,gBAAgB;IAC3B,IAAI,CAAC,OAAe,EAAE,OAAgB;QACpC,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAgB;QACpC,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACpE,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAgB,EAAE,KAAc;QACrD,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;QACpE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAgB;QACrC,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAA;IACtE,CAAC;CACF;AAnBD,4CAmBC"}

package/dist/interfaces/mcp-module-options.interface.d.ts

@@ -0,0 +1,49 @@
+import { ServerOptions } from "@modelcontextprotocol/sdk/server/index.js";
+import { ResourceMetadata, ResourceTemplate as ResourceTemplateClass } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Implementation, Resource } from "@modelcontextprotocol/sdk/types.js";
+import { ModuleMetadata, Type } from "@nestjs/common";
+import { ZodRawShape } from "zod";
+import { McpLogger } from "./mcp-logger.interface";
+export declare enum TransportType {
+    STDIO = "stdio",
+    SSE = "sse",
+    HTTP = "http",
+    NONE = "none"
+}
+export interface McpModuleOptions {
+    serverInfo: Implementation;
+    serverOptions?: ServerOptions;
+    transport?: TransportType;
+    logger?: McpLogger;
+    basePath?: string;
+    global?: boolean;
+}
+export interface McpOptionsFactory {
+    createMcpOptions(): Promise<McpModuleOptions> | McpModuleOptions;
+}
+export interface McpModuleAsyncOptions extends Pick<ModuleMetadata, "imports"> {
+    useExisting?: Type<McpOptionsFactory>;
+    useClass?: Type<McpOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<McpModuleOptions> | McpModuleOptions;
+    inject?: any[];
+    global?: boolean;
+}
+export interface FixedResourceOptions extends Resource {
+    metadata?: ResourceMetadata;
+}
+export interface TemplateResourceOptions {
+    name: string;
+    uriTemplate: string | ResourceTemplateClass;
+    description?: string;
+    metadata?: ResourceMetadata;
+}
+export type ResourceOptions = FixedResourceOptions | TemplateResourceOptions;
+export interface ToolOptions {
+    name: string;
+    description?: string;
+    paramsSchema?: ZodRawShape;
+}
+export interface IMetadataBase {
+    methodName: string;
+    options?: any;
+}

package/dist/interfaces/mcp-module-options.interface.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportType = void 0;
+var TransportType;
+(function (TransportType) {
+    TransportType["STDIO"] = "stdio";
+    TransportType["SSE"] = "sse";
+    TransportType["HTTP"] = "http";
+    TransportType["NONE"] = "none";
+})(TransportType || (exports.TransportType = TransportType = {}));
+//# sourceMappingURL=mcp-module-options.interface.js.map

package/dist/interfaces/mcp-module-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-module-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/mcp-module-options.interface.ts"],"names":[],"mappings":";;;AAcA,IAAY,aASX;AATD,WAAY,aAAa;IAEvB,gCAAe,CAAA;IAEf,4BAAW,CAAA;IAEX,8BAAa,CAAA;IAEb,8BAAa,CAAA;AACf,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB"}

package/dist/mcp.controller.d.ts

@@ -0,0 +1,13 @@
+import { Request, Response } from "express";
+import { McpLogger, McpModuleOptions } from "./interfaces";
+import { McpHttpService } from "./services/mcp-http.service";
+export declare class McpHttpController {
+    private readonly mcpHttpService;
+    private readonly logger;
+    private readonly loggerCtx;
+    private readonly basePath;
+    constructor(mcpHttpService: McpHttpService, options: McpModuleOptions, logger: McpLogger);
+    handleSSE(req: Request, res: Response): Promise<void>;
+    handleMessages(req: Request, res: Response): Promise<void>;
+    healthCheck(req: Request, res: Response): void;
+}

package/dist/mcp.controller.js

@@ -0,0 +1,85 @@
+"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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpHttpController = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("./constants");
+const mcp_http_service_1 = require("./services/mcp-http.service");
+let McpHttpController = class McpHttpController {
+    constructor(mcpHttpService, options, logger) {
+        this.mcpHttpService = mcpHttpService;
+        this.logger = logger;
+        this.loggerCtx = "McpHttpController";
+        this.basePath = options.basePath || constants_1.DEFAULT_MCP_PATH;
+    }
+    async handleSSE(req, res) {
+        if (!req.path.includes(this.basePath)) {
+            res.status(404).send("Not found");
+            return;
+        }
+        this.logger.debug("SSE connection request received", this.loggerCtx);
+        return this.mcpHttpService.handleSSE(res);
+    }
+    async handleMessages(req, res) {
+        if (!req.path.includes(this.basePath)) {
+            res.status(404).send("Not found");
+            return;
+        }
+        this.logger.debug("MCP message received", this.loggerCtx);
+        return this.mcpHttpService.handleMessage(req, res);
+    }
+    healthCheck(req, res) {
+        if (!req.path.includes(this.basePath)) {
+            res.status(404).send("Not found");
+            return;
+        }
+        this.logger.debug("Health check request received", this.loggerCtx);
+        res.json({
+            status: "ok",
+            timestamp: new Date().toISOString(),
+        });
+    }
+};
+exports.McpHttpController = McpHttpController;
+__decorate([
+    (0, common_1.Get)("*/sse"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], McpHttpController.prototype, "handleSSE", null);
+__decorate([
+    (0, common_1.Post)("*/messages"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], McpHttpController.prototype, "handleMessages", null);
+__decorate([
+    (0, common_1.Get)("*/health"),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", void 0)
+], McpHttpController.prototype, "healthCheck", null);
+exports.McpHttpController = McpHttpController = __decorate([
+    (0, common_1.Controller)(),
+    __param(1, (0, common_1.Inject)(constants_1.MCP_MODULE_OPTIONS)),
+    __param(2, (0, common_1.Inject)(constants_1.MCP_LOGGER)),
+    __metadata("design:paramtypes", [mcp_http_service_1.McpHttpService, Object, Object])
+], McpHttpController);
+//# sourceMappingURL=mcp.controller.js.map

package/dist/mcp.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.controller.js","sourceRoot":"","sources":["../src/mcp.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAOuB;AAGvB,2CAA8E;AAE9E,kEAA4D;AAWrD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAI5B,YACmB,cAA8B,EACnB,OAAyB,EACjC,MAAkC;QAFrC,mBAAc,GAAd,cAAc,CAAgB;QAEV,WAAM,GAAN,MAAM,CAAW;QANvC,cAAS,GAAG,mBAAmB,CAAA;QAQ9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,4BAAgB,CAAA;IACtD,CAAC;IAMK,AAAN,KAAK,CAAC,SAAS,CAAQ,GAAY,EAAS,GAAa;QACvD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACjC,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACpE,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAC3C,CAAC;IAMK,AAAN,KAAK,CAAC,cAAc,CACX,GAAY,EACZ,GAAa;QAEpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACjC,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACzD,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IACpD,CAAC;IAMD,WAAW,CAAQ,GAAY,EAAS,GAAa;QACnD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;YACjC,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAClE,GAAG,CAAC,IAAI,CAAC;YACP,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAxDY,8CAAiB;AAgBtB;IADL,IAAA,YAAG,EAAC,OAAO,CAAC;IACI,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,YAAG,GAAE,CAAA;;;;kDAO1C;AAMK;IADL,IAAA,aAAI,EAAC,YAAY,CAAC;IAEhB,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,YAAG,GAAE,CAAA;;;;uDAQP;AAMD;IADC,IAAA,YAAG,EAAC,UAAU,CAAC;IACH,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,YAAG,GAAE,CAAA;;;;oDAUtC;4BAvDU,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;IAOR,WAAA,IAAA,eAAM,EAAC,8BAAkB,CAAC,CAAA;IAC1B,WAAA,IAAA,eAAM,EAAC,sBAAU,CAAC,CAAA;qCAFc,iCAAc;GALtC,iBAAiB,CAwD7B"}

package/dist/mcp.module.d.ts

@@ -0,0 +1,16 @@
+import { DynamicModule, OnApplicationBootstrap } from "@nestjs/common";
+import { McpLogger, McpModuleAsyncOptions, McpModuleOptions } from "./interfaces";
+import { ExplorerService, McpService } from "./services";
+export declare class McpModule implements OnApplicationBootstrap {
+    private readonly explorerService;
+    private readonly mcpService;
+    private readonly logger;
+    constructor(explorerService: ExplorerService, mcpService: McpService, logger: McpLogger);
+    static forRoot(options: McpModuleOptions): DynamicModule;
+    static forRootAsync(options: McpModuleAsyncOptions): DynamicModule;
+    private static createAsyncProviders;
+    private static createAsyncOptionsProvider;
+    private static createAsyncLoggerProvider;
+    onApplicationBootstrap(): Promise<void>;
+    private registerMcpHandlers;
+}