@muzikanto/nestjs-mcp 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @muzikanto/nestjs-mcp
 
+## 1.5.1
+
+### Patch Changes
+
+- custom mcp errors for filters
+
 ## 1.5.0
 
 ### Minor Changes

package/README.md

@@ -456,23 +456,23 @@ import { APP_INTERCEPTOR } from "@nestjs/core";
 export class TestModule {}
 ```
 
-### Fitlers
+### Filters
 
 ```ts
-import { IMcpTool, McpTool } from "@muzikanto/nestjs-mcp";
+import { IMcpTool, McpTool, McpUnauthorizedException } from "@muzikanto/nestjs-mcp";
 import {
   ExceptionFilter,
   Catch,
   ArgumentsHost,
-  NotImplementedException,
   UseFilters,
 } from "@nestjs/common";
 
-@Catch(NotImplementedException)
+@Catch(McpUnauthorizedException)
 class ExampleFilter implements ExceptionFilter {
   catch(exception: unknown, host: ArgumentsHost) {
     return {
-      message: (exception as Error).message,
+      isError: true,
+      text: (exception as Error).message,
     };
   }
 }

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from "./mcp-server/decorators/mcp-resource.decorator";
 export * from "./mcp-client/mcp-client.module";
 export * from "./mcp-client/mcp-client.service";
 export * from "./mcp-server/mcp-dynamic.service";
+export * from "./mcp-server/exceptions";

package/dist/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./mcp-server/decorators/mcp-resource.decorator"), exports)
 __exportStar(require("./mcp-client/mcp-client.module"), exports);
 __exportStar(require("./mcp-client/mcp-client.service"), exports);
 __exportStar(require("./mcp-server/mcp-dynamic.service"), exports);
+__exportStar(require("./mcp-server/exceptions"), exports);

package/dist/mcp-server/exceptions/index.d.ts

@@ -0,0 +1,31 @@
+import { HttpException, HttpStatus } from "@nestjs/common";
+export declare class McpException extends HttpException {
+    constructor(message: string, status?: HttpStatus, options?: {
+        cause?: unknown;
+    });
+}
+export declare class McpBadRequestException extends McpException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class McpNotFoundException extends McpException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class McpInternalServerErrorException extends McpException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class McpUnauthorizedException extends McpException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class McpNotImplementedException extends McpException {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/mcp-server/exceptions/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpNotImplementedException = exports.McpUnauthorizedException = exports.McpInternalServerErrorException = exports.McpNotFoundException = exports.McpBadRequestException = exports.McpException = void 0;
+const common_1 = require("@nestjs/common");
+class McpException extends common_1.HttpException {
+    constructor(message, status = common_1.HttpStatus.INTERNAL_SERVER_ERROR, options) {
+        super({ message, ...(options?.cause ? { cause: options.cause } : {}) }, status);
+    }
+}
+exports.McpException = McpException;
+class McpBadRequestException extends McpException {
+    constructor(message, options) {
+        super(message, common_1.HttpStatus.BAD_REQUEST, options);
+    }
+}
+exports.McpBadRequestException = McpBadRequestException;
+class McpNotFoundException extends McpException {
+    constructor(message, options) {
+        super(message, common_1.HttpStatus.NOT_FOUND, options);
+    }
+}
+exports.McpNotFoundException = McpNotFoundException;
+class McpInternalServerErrorException extends McpException {
+    constructor(message, options) {
+        super(message, common_1.HttpStatus.INTERNAL_SERVER_ERROR, options);
+    }
+}
+exports.McpInternalServerErrorException = McpInternalServerErrorException;
+class McpUnauthorizedException extends McpException {
+    constructor(message, options) {
+        super(message, common_1.HttpStatus.UNAUTHORIZED, options);
+    }
+}
+exports.McpUnauthorizedException = McpUnauthorizedException;
+class McpNotImplementedException extends McpException {
+    constructor(message, options) {
+        super(message, common_1.HttpStatus.NOT_IMPLEMENTED, options);
+    }
+}
+exports.McpNotImplementedException = McpNotImplementedException;

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

@@ -20,6 +20,7 @@ const core_1 = require("@nestjs/core");
 const run_interceptors_1 = require("./utils/run-interceptors");
 const rxjs_1 = require("rxjs");
 const run_fillters_1 = require("./utils/run-fillters");
+const exceptions_1 = require("./exceptions");
 let McpService = class McpService {
     moduleRef;
     tools = new Map();
@@ -88,23 +89,20 @@ let McpService = class McpService {
     }
     async executePrompt(name, payload, context) {
         if (!this.prompts.has(name)) {
-            throw new common_1.NotFoundException("Not found prompt");
-        }
-        const { instance: prompt, metatype } = this.prompts.get(name) || {};
-        if (!prompt || !metatype) {
-            throw new common_1.NotFoundException(`Unknown prompt: "${name}"`);
-        }
-        await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
-        // Валидация через AJV, если есть inputSchema
-        if (prompt.inputSchema) {
-            const zodSchema = (0, zod_1.zodToJsonSchema)(prompt.inputSchema);
-            const validate = this.ajv.compile(zodSchema);
-            const valid = validate(payload);
-            if (!valid) {
-                throw new common_1.NotFoundException("Invalid prompt arguments");
-            }
+            throw new exceptions_1.McpNotFoundException("Not found prompt");
         }
+        const { instance: prompt, metatype } = this.prompts.get(name);
         try {
+            await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
+            // Валидация через AJV, если есть inputSchema
+            if (prompt.inputSchema) {
+                const zodSchema = (0, zod_1.zodToJsonSchema)(prompt.inputSchema);
+                const validate = this.ajv.compile(zodSchema);
+                const valid = validate(payload);
+                if (!valid) {
+                    throw new exceptions_1.McpBadRequestException("Invalid prompt arguments");
+                }
+            }
             // const result = await prompt.execute(payload);
             const stream = await (0, run_interceptors_1.runInterceptors)(this.moduleRef, metatype, context, () => {
                 return (0, rxjs_1.from)(prompt.execute(payload));
@@ -112,28 +110,33 @@ let McpService = class McpService {
             return stream.pipe((0, rxjs_1.catchError)((err) => (0, rxjs_1.from)((0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context))));
         }
         catch (err) {
-            throw new common_1.InternalServerErrorException("Failed to execute prompt");
+            const result = await (0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context);
+            if (result) {
+                return (0, rxjs_1.of)(result);
+            }
+            // Пробрасываем дальше, чтобы Observable корректно завершился
+            return (0, rxjs_1.throwError)(() => err);
         }
     }
     /**
      * Отправить сообщение в MCP "сервер"
      */
     async executeTool(msg, context) {
-        const { instance: tool, metatype } = this.tools.get(msg.type) || {};
-        if (!tool || !metatype) {
-            throw new common_1.NotFoundException(`Unknown tool: "${msg.type}"`);
-        }
-        await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
-        // Валидация через AJV, если есть inputSchema
-        if (tool.inputSchema) {
-            const zodSchema = (0, zod_1.zodToJsonSchema)(tool.inputSchema);
-            const validate = this.ajv.compile(zodSchema);
-            const valid = validate(msg.payload);
-            if (!valid) {
-                throw new common_1.BadRequestException(this.ajv.errorsText(validate.errors));
-            }
+        if (!this.tools.has(msg.type)) {
+            throw new exceptions_1.McpNotFoundException("Not found tool");
         }
+        const { instance: tool, metatype } = this.tools.get(msg.type);
         try {
+            await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
+            // Валидация через AJV, если есть inputSchema
+            if (tool.inputSchema) {
+                const zodSchema = (0, zod_1.zodToJsonSchema)(tool.inputSchema);
+                const validate = this.ajv.compile(zodSchema);
+                const valid = validate(msg.payload);
+                if (!valid) {
+                    throw new exceptions_1.McpBadRequestException(this.ajv.errorsText(validate.errors));
+                }
+            }
             // const result = await tool.execute(msg.payload);
             const stream = await (0, run_interceptors_1.runInterceptors)(this.moduleRef, metatype, context, () => {
                 return (0, rxjs_1.from)(tool.execute(msg.payload));
@@ -141,16 +144,21 @@ let McpService = class McpService {
             return stream.pipe((0, rxjs_1.catchError)((err) => (0, rxjs_1.from)((0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context))));
         }
         catch (err) {
-            throw new common_1.InternalServerErrorException("Failed to execute tool");
+            const result = await (0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context);
+            if (result) {
+                return (0, rxjs_1.of)(result);
+            }
+            // Пробрасываем дальше, чтобы Observable корректно завершился
+            return (0, rxjs_1.throwError)(() => err);
         }
     }
     async executeResource(name, uri, vars, context) {
-        const { instance: resource, metatype } = this.resources.get(name) || {};
-        if (!resource || !metatype) {
-            throw new common_1.NotFoundException(`Unknown resource: "${name}"`);
+        if (!this.resources.has(name)) {
+            throw new exceptions_1.McpNotFoundException("Not found prompt");
         }
-        await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
+        const { instance: resource, metatype } = this.resources.get(name);
         try {
+            await (0, run_guards_1.runGuards)(this.moduleRef, metatype, context);
             // const result = await resource.execute(uri, vars);
             const stream = await (0, run_interceptors_1.runInterceptors)(this.moduleRef, metatype, context, () => {
                 return (0, rxjs_1.from)(resource.execute(uri, vars));
@@ -158,7 +166,12 @@ let McpService = class McpService {
             return stream.pipe((0, rxjs_1.catchError)((err) => (0, rxjs_1.from)((0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context))));
         }
         catch (err) {
-            throw new common_1.InternalServerErrorException("Failed to execute tool");
+            const result = await (0, run_fillters_1.runFilters)(this.moduleRef, metatype, err, context);
+            if (result) {
+                return (0, rxjs_1.of)(result);
+            }
+            // Пробрасываем дальше, чтобы Observable корректно завершился
+            return (0, rxjs_1.throwError)(() => err);
         }
     }
     createServer(context) {
@@ -182,8 +195,9 @@ let McpService = class McpService {
                     };
                 }
                 catch (e) {
-                    console.error(e);
-                    throw new Error(`Faild to execute tool ${tool.name}`);
+                    throw new exceptions_1.McpInternalServerErrorException(`Faild to execute tool ${tool.name}`, {
+                        cause: e,
+                    });
                 }
             });
         }
@@ -209,7 +223,9 @@ let McpService = class McpService {
                     return { messages: messages };
                 }
                 catch (e) {
-                    throw new Error(`Faild to execute tool ${prompt.name}`);
+                    throw new exceptions_1.McpInternalServerErrorException(`Faild to execute tool ${prompt.name}`, {
+                        cause: e,
+                    });
                 }
             });
         }
@@ -234,7 +250,9 @@ let McpService = class McpService {
                     return { contents: result };
                 }
                 catch (e) {
-                    throw new Error(`Faild to execute tool ${prompt.name}`);
+                    throw new exceptions_1.McpInternalServerErrorException(`Faild to execute tool ${prompt.name}`, {
+                        cause: e,
+                    });
                 }
             });
         }

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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runGuards = runGuards;
-const common_1 = require("@nestjs/common");
 const constants_1 = require("@nestjs/common/constants");
+const exceptions_1 = require("../exceptions");
 /**
  * Универсальный helper для проверки массивов NestJS Guards
  */
@@ -28,7 +28,7 @@ async function runGuards(moduleRef, metatype, context) {
         const guardInstance = await resolveGuard(Guard);
         const can = await guardInstance.canActivate(context);
         if (!can) {
-            throw new common_1.UnauthorizedException("Guard blocked execution");
+            throw new exceptions_1.McpUnauthorizedException("Guard blocked execution");
         }
     }
 }

package/package.json

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