@muzikanto/nestjs-mcp 1.7.1 → 1.7.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @muzikanto/nestjs-mcp
 
+## 1.7.3
+
+### Patch Changes
+
+- fix dynamic tools filters
+
+## 1.7.2
+
+### Patch Changes
+
+- add transports selection
+
 ## 1.7.1
 
 ### Patch Changes

package/README.md

@@ -50,6 +50,13 @@ NestJS MCP (Model Context Protocol) module — allows you to create “tools”,
 - Full TypeScript typing
 - Support `@UseGuards`, `@UseInterceptors`, `@UseFilters`
 
+## Examples
+
+- [Example server](https://github.com/Muzikanto/nestjs-mcp/tree/main/example)
+- [Example librechat](https://github.com/Muzikanto/nestjs-mcp/tree/main/example/librechat)
+- [Example openai request](https://github.com/Muzikanto/nestjs-mcp/blob/main/example/src/openai/openai.service.ts)
+- [Example mcp handlers](https://github.com/Muzikanto/nestjs-mcp/tree/main/example/src/mcp-server/handlers)
+
 ---
 
 ## Installation
@@ -74,6 +81,10 @@ import { TelegramAutoReplyPrompt } from "./prompts/telegram-auto-reply.prompt";
   imports: [
     McpModule.forRoot({
       providers: [TelegramSendMessageTool, TelegramAutoReplyPrompt],
+      transports: {
+        sse: true, // SSE endpoints for mcp
+        http: true, // HTTP endpoints for custom server
+      },
     }),
   ],
 })

package/dist/mcp-server/config.d.ts

@@ -3,6 +3,11 @@ export declare const MCP_CONFIG_TOKEN = "mcl:config-token";
 export type IMcpConfig = {
     name?: string;
     version?: string;
+    description?: string;
+    title?: string;
+    icons?: {
+        src: string;
+    }[];
     httpAdapter: IHttpAdapter;
 };
 export declare const InjectMcpConfig: () => PropertyDecorator & ParameterDecorator;

package/dist/mcp-server/dto/McpToolResultMessage.dto.d.ts

@@ -1,4 +1,4 @@
 export declare class McpToolResultMessageDto {
-    type: 'text';
+    type: "text";
     text: string;
 }

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

@@ -1,10 +1,22 @@
 import { CanActivate, DynamicModule, ModuleMetadata, Provider } from "@nestjs/common";
 import { IHttpAdapter } from "./utils/http-adapter";
 type Metadata = Pick<ModuleMetadata, "providers" | "imports" | "exports"> & {
-    guard?: Provider<CanActivate>;
     name?: string;
+    description?: string;
+    title?: string;
+    icons?: {
+        src: string;
+    }[];
     version?: string;
+    /**
+     * @default { sse: true, http: true }
+     */
+    transports?: {
+        sse?: boolean;
+        http?: boolean;
+    };
     httpAdapter?: IHttpAdapter;
+    guard?: Provider<CanActivate>;
 };
 export declare class McpModule {
     static forRoot(metadata?: Metadata): DynamicModule;

package/dist/mcp-server/mcp.module.js

@@ -22,11 +22,16 @@ const mcp_sse_service_1 = require("./services/mcp.sse.service");
 const publicGuard = { canActivate: () => Promise.resolve(true) };
 let McpModule = McpModule_1 = class McpModule {
     static forRoot(metadata = {}) {
+        // TODO remove defaut in next major version
+        const transports = metadata.transports || { sse: true, http: true };
         const configProviver = {
             provide: config_1.MCP_CONFIG_TOKEN,
             useValue: {
                 name: metadata.name,
                 version: metadata.version,
+                description: metadata.description,
+                title: metadata.title,
+                icons: metadata.icons,
                 httpAdapter: metadata.httpAdapter || http_adapter_1.DEFAULT_FASTIFY_ADAPTER,
             },
         };
@@ -41,7 +46,7 @@ let McpModule = McpModule_1 = class McpModule {
             imports: [core_1.DiscoveryModule, ...(metadata.imports || [])],
             providers: [
                 mcp_service_1.McpService,
-                mcp_sse_service_1.McpSseService,
+                ...(transports.sse ? [mcp_sse_service_1.McpSseService] : []),
                 mcp_explorer_1.McpExplorer,
                 mcp_dynamic_service_1.McpDynamicService,
                 configProviver,
@@ -50,7 +55,10 @@ let McpModule = McpModule_1 = class McpModule {
                 ...(metadata.providers || []),
             ],
             exports: [mcp_dynamic_service_1.McpDynamicService, ...(metadata.exports || [])],
-            controllers: [mcp_controller_1.McpController, mcp_sse_controller_1.McpSseController],
+            controllers: [
+                ...(transports.http ? [mcp_controller_1.McpController] : []),
+                ...(transports.sse ? [mcp_sse_controller_1.McpSseController] : []),
+            ],
         };
     }
 };

package/dist/mcp-server/services/mcp-dynamic.service.d.ts

@@ -1,4 +1,4 @@
-import { CanActivate, NestInterceptor, Type } from "@nestjs/common";
+import { CanActivate, ExceptionFilter, NestInterceptor, Type } from "@nestjs/common";
 import { ModuleRef } from "@nestjs/core";
 import { McpService } from "../services/mcp.service";
 import { IMcpTool } from "../decorators/mcp-tool.decorator";
@@ -7,14 +7,17 @@ import { IMcpPrompt } from "../decorators/mcp-prompt.decorator";
 export type IMcpDynamicTool<Input, Result extends Record<string, unknown>> = IMcpTool<Input, Result> & {
     guards?: Type<CanActivate>[];
     interceptors?: Type<NestInterceptor>[];
+    filters?: Type<ExceptionFilter>[];
 };
 export type IMcpDynamicPrompt<Input> = IMcpPrompt<Input> & {
     guards?: Type<CanActivate>[];
     interceptors?: Type<NestInterceptor>[];
+    filters?: Type<ExceptionFilter>[];
 };
 export type IMcpDynamicResource<Input> = IMcpResource<Input> & {
     guards?: Type<CanActivate>[];
     interceptors?: Type<NestInterceptor>[];
+    filters?: Type<ExceptionFilter>[];
 };
 export declare class McpDynamicService {
     private readonly moduleRef;
@@ -28,4 +31,5 @@ export declare class McpDynamicService {
     registerResource<Input>(resource: IMcpDynamicResource<Input>): Promise<void>;
     protected applyGuards(item: Function, guards: Type<CanActivate>[]): void;
     protected applyInterceptors(item: Function, interceptors: Type<NestInterceptor>[]): void;
+    protected applyFilters(item: Function, filters: Type<ExceptionFilter>[]): void;
 }

package/dist/mcp-server/services/mcp-dynamic.service.js

@@ -39,6 +39,9 @@ let McpDynamicService = class McpDynamicService {
         if (tool.interceptors) {
             this.applyInterceptors(DynamicToolClass, tool.interceptors);
         }
+        if (tool.filters) {
+            this.applyFilters(DynamicToolClass, tool.filters);
+        }
         const instance = await this.moduleRef.create(DynamicToolClass);
         this.mcpService.registerTool(instance.name, {
             instance,
@@ -60,6 +63,9 @@ let McpDynamicService = class McpDynamicService {
         if (prompt.interceptors) {
             this.applyInterceptors(DynamicPromptClass, prompt.interceptors);
         }
+        if (prompt.filters) {
+            this.applyFilters(DynamicPromptClass, prompt.filters);
+        }
         const instance = await this.moduleRef.create(DynamicPromptClass);
         this.mcpService.registerPrompt(instance.name, {
             instance,
@@ -84,6 +90,9 @@ let McpDynamicService = class McpDynamicService {
         if (resource.interceptors) {
             this.applyInterceptors(DynamicResourceClass, resource.interceptors);
         }
+        if (resource.filters) {
+            this.applyFilters(DynamicResourceClass, resource.filters);
+        }
         const instance = await this.moduleRef.create(DynamicResourceClass);
         this.mcpService.registerResource(instance.name, {
             instance,
@@ -96,6 +105,9 @@ let McpDynamicService = class McpDynamicService {
     applyInterceptors(item, interceptors) {
         Reflect.defineMetadata(constants_1.INTERCEPTORS_METADATA, interceptors, item);
     }
+    applyFilters(item, filters) {
+        Reflect.defineMetadata(constants_1.EXCEPTION_FILTERS_METADATA, filters, item);
+    }
 };
 exports.McpDynamicService = McpDynamicService;
 exports.McpDynamicService = McpDynamicService = __decorate([

package/dist/mcp-server/services/mcp.sse.service.js

@@ -63,7 +63,22 @@ let McpSseService = class McpSseService {
         const server = new mcp_js_1.McpServer({
             version: this.config.version || "1",
             name: this.config.name || "MCP server",
-        }, {});
+            description: this.config.description,
+            title: this.config.title,
+            icons: this.config.icons,
+        }, {
+            capabilities: {
+                prompts: {
+                    listChanged: true,
+                },
+                tools: {
+                    listChanged: true,
+                },
+                resources: {
+                    listChanged: true,
+                },
+            },
+        });
         this.registerTools(server, context);
         this.registerPrompts(server, context);
         this.registerResources(server, context);

package/dist/mcp-server/utils/run-fillters.js

@@ -22,8 +22,11 @@ async function runFilters(moduleRef, metatype, exception, host) {
     const filters = Reflect.getMetadata(constants_1.EXCEPTION_FILTERS_METADATA, metatype) || [];
     for (const Filter of filters) {
         const filterInstance = await resolveFilter(Filter);
-        const filterExceptions = (Reflect.getMetadata(constants_1.FILTER_CATCH_EXCEPTIONS, Filter) || []);
-        if (!filterExceptions ||
+        const filterExceptions = (Reflect.getMetadata(constants_1.FILTER_CATCH_EXCEPTIONS, Filter));
+        if (!filterExceptions) {
+            continue;
+        }
+        if (filterExceptions.length > 0 &&
             !filterExceptions.some((ex) => exception instanceof ex)) {
             continue;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muzikanto/nestjs-mcp",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "NestJS MCP (Model Context Protocol) module for creating tools for LLM or HTTP with validation, decorators, and OpenAI Function Calls integration.",
   "keywords": [
     "nestjs",