@muzikanto/nestjs-mcp 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @muzikanto/nestjs-mcp
 
+## 1.1.1
+
+### Patch Changes
+
+- add guard authorization check
+
+## 1.1.0
+
+### Minor Changes
+
+- Add prompt decorators and routes
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -1,9 +1,9 @@
 # @muzikanto/nestjs-mcp
 
-![npm](https://img.shields.io/npm/v/@muzikanto/nestjs-mcp)
-![downloads](https://img.shields.io/npm/dt/@muzikanto/nestjs-mcp)
-![GitHub stars](https://img.shields.io/github/stars/Muzikanto/nestjs-mcp?style=social)
-![License](https://img.shields.io/npm/l/@muzikanto/nestjs-mcp)
+[![npm](https://img.shields.io/npm/v/@muzikanto/nestjs-mcp)](https://www.npmjs.com/package/@muzikanto/nestjs-mcp)
+[![downloads](https://img.shields.io/npm/dt/@muzikanto/nestjs-mcp)]((https://www.npmjs.com/package/@muzikanto/nestjs-mcp))
+[![GitHub stars](https://img.shields.io/github/stars/Muzikanto/nestjs-mcp?style=social)](https://github.com/Muzikanto/nestjs-mcp)
+[![License](https://img.shields.io/npm/l/@muzikanto/nestjs-mcp)](https://github.com/Muzikanto/nestjs-mcp/blob/main/LICENSE)
 
 NestJS MCP (Model Context Protocol) module — allows you to create “tools” (functions) for LLM or HTTP, with automatic detection via decorators, validation, and integration with OpenAI Function Calls.
 
@@ -15,17 +15,24 @@ NestJS MCP (Model Context Protocol) module — allows you to create “tools”
 - [Usage](#usage)
   - [Connecting the MCP module](#connecting-the-mcp-module)
   - [Create MCP tool](#create-mcp-tool)
+  - [Create MCP prompt](#create-mcp-prompt)
   - [Calling MCP tools via HTTP](#calling-mcp-tools-via-http)
   - [Obtaining all tools](#obtaining-all-tools)
+  - [Obtaining all prompts](#obtaining-all-prompts)
+  - [Obtain prompt](#obtain-prompt)
+  - [Auth guard](#auth-guard)
   - [Integration with OpenAI Function Calls](#integration-with-openai-function-calls)
 
 ## Features
 
 - Register MCP tools using the `@McpTool()` decorator
+- Register MCP prompts using the `@McpPrompt()` decorator
 - Automatic detection of all providers (tools) in the module
 - Input data validation
 - HTTP endpoint for calling tools (`POST /mcp`)  
 - Endpoint for a list of all tools (`GET /mcp/tools`)  
+- Endpoint for a list of all prompts (`GET /mcp/prompts`)  
+- Endpoint for prompt (`GET /mcp/prompts/:name`)  
 - Easy integration with LLM (OpenAI Function Calls)  
 - Full TypeScript typing  
 
@@ -46,14 +53,14 @@ Peer dependencies: `@nestjs/common, @nestjs/core, reflect-metadata`
 ```ts
 import { Module } from '@nestjs/common';
 import { McpModule } from '@muzikanto/nestjs-mcp';
-import { GetCurrentDateTool } from './tools/payment.tool';
+import { TelegramSendMessageTool } from './tools/telegram-send-message.tool';
+import { TelegramAutoReplyPrompt } from './prompts/telegram-auto-reply.prompt';
 
 @Module({
   imports: [
-    McpModule.forRoot(),
-  ],
-  providers: [
-    GetCurrentDateTool,
+    McpModule.forRoot({
+      providers: [TelegramSendMessageTool, TelegramAutoReplyPrompt],
+    }),
   ],
 })
 export class AppModule {}
@@ -63,21 +70,35 @@ export class AppModule {}
 
 ```ts
 import { IMcpTool, McpTool } from '@muzikanto/nestjs-mcp';
+import { Telegraf } from 'telegraf';
 
 @McpTool()
-export class GetCurrentDateTool implements IMcpTool<{ country: string; }, { date: string }> {
-  name = 'get-date';
+export class TelegramSendMessageTool implements IMcpTool<
+  { chatId: string; text: string },
+  { success: boolean }
+> {
+  name = 'telegram.sendMessage';
 
   inputSchema = {
-    "type": "object",
-    "properties": {
-      "country": { "type": "string", "description": "Country" }
+    type: "object",
+    properties: {
+      chatId: {
+        type: "string",
+        description: "Telegram chat id"
+      },
+      text: {
+        type: "string",
+        description: "Message text"
+      }
     },
-    "required": ["country"]
+    required: ["chatId", "text"]
   };
 
-  async execute(input: { country: string }) {
-    return { date: new Date().toLocaleString() };
+  constructor(private readonly bot: Telegraf) {}
+
+  async execute(input: { chatId: string; text: string }) {
+    await this.bot.telegram.sendMessage(input.chatId, input.text);
+    return { success: true };
   }
 }
 ```
@@ -88,9 +109,10 @@ POST /mcp
 
 ```json
 {
-  "type": "get-date",
+  "type": "telegram.sendMessage",
   "payload": {
-    "country": "ru"
+    "chatId": "...",
+    "text": "Hi, how are you ?"
   }
 }
 ```
@@ -99,7 +121,7 @@ POST /mcp
 ```json
 {
   "data": {
-    "date": "21/02/2026, 16:17:00"
+    "success": true
   }
 }
 ```
@@ -111,15 +133,132 @@ GET /mcp/tool
 ```json
 [
   {
-    "name": "get-date",
-    "description": "",
+    "name": "telegram.sendMessage",
+    "description": "Sent message via Telegram",
     "inputSchema": {
-      "country": { "type": "string", "description": "Страна" },
+      "chatId": {
+        "type": "string",
+        "description": "Telegram chat ID"
+      },
+      "text": {
+        "type": "string",
+        "description": "Message text"
+      }
     }
   }
 ]
 ```
 
+### Create MCP prompt
+
+```ts
+import { IMcpPrompt, McpPrompt } from '@muzikanto/nestjs-mcp';
+
+@McpPrompt()
+export class TelegramAutoReplyPrompt implements IMcpPrompt<{ text: string; chatId: number; }> {
+  name = 'telegram_auto_reply';
+  description = 'Generate a short, fiendly reply to an incoming Telegram message and send it back to the same chat using teegram.sendMessage tool';
+
+  async execute({ text, chatId }: { text: string; chatId: number }) {
+    return [
+      {
+        role: "system",
+        content: `You are a friendly Telegram bot. Reply briefly and to the point.`
+      },
+      {
+        role: "user",
+        content: text
+      },
+      {
+        role: "assistant",
+        tool_call: {
+          name: "telegram.sendMessage",
+          arguments: {
+            chatId,
+            text: "{{model_output}}"
+          }
+        }
+      }
+    ];
+  }
+}
+```
+
+### Obtaining all prompts
+
+GET /mcp/prompts
+
+```json
+[
+  {
+    "name": "telegram_auto_reply",
+    "description": "Generate a short, fiendly reply to an incoming Telegram message and send it back to the same chat using teegram.sendMessage tool"
+  }
+]
+```
+
+### Obtainin prompt
+
+POST /mcp/prompts/telegram_auto_reply
+
+```json
+{
+  "text": "Hi. How are you ?",
+  "chatId": 100000000
+}
+```
+
+Response
+```json
+{
+  "messages": [
+      {
+        "role": "system",
+        "content": "You are a friendly Telegram bot. Reply briefly and to the point."
+      },
+      {
+        "role": "user",
+        "content": "Hi. How are you ?"
+      },
+      {
+        "role": "assistant",
+        "tool_call": {
+          "name": "telegram.sendMessage",
+          "arguments": {
+            "chatId": 100000000,
+            "text": "{{model_output}}"
+          }
+        }
+      }
+    ]
+}
+```
+
+### Auth guard
+```ts
+import { McpModule } from '@muzikanto/nestjs-mcp';
+import { Module, CanActivate, ExecutionContext, Injectable } from "@nestjs/common";
+
+@Injectable()
+export class TestGuard implements CanActivate {
+    canActivate(context: ExecutionContext): Promise<boolean> {
+      const request = context.switchToHttp().getRequest();
+      const authHeader = request.headers['authorization'];
+    
+      return true;
+    }
+}
+
+@Module({
+  imports: [
+    McpModule.forRoot({
+      guard: TestGuard
+    }),
+  ],
+})
+export class AppModule {}
+```
+
 ### Integration with OpenAI Function Calls
 
 ```ts
@@ -128,6 +267,7 @@ import OpenAI from 'openai';
 
 const MCP_URL = 'http://localhost:3000/mcp';
 const MCP_TOOLS_URL = 'http://localhost:3000/mcp/tools';
+const MCP_TELEGRAM_PROMPT_URL = 'http://localhost:3000/mcp/prompts/telegram_auto_reply';
 
 // Create OpenAI client
 const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
@@ -135,11 +275,19 @@ const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
 /**
  * Get all tools
  */
-async function listMcpTools() {
+async function getMcpTools() {
   const response = await axios.get(MCP_TOOLS_URL);
   return response.data;
 }
 
+/**
+ * Get all prompts
+ */
+async function getMcpPrompt() {
+  const response = await axios.post(MCP_TELEGRAM_PROMPT_URL, {/* propmpt generation arguments */});
+  return response.data;
+}
+
 /**
  * Request mcp tool
  */
@@ -156,12 +304,13 @@ async function callMcpTool(toolName: string, payload: Record<string, any>) {
  * Example
  */
 (async () => {
-  const functions = await listMcpTools();
+  const toolsResponse = await getMcpTools();
+  const promptResponse = await getMcpPrompt();
 
   const completion = await client.chat.completions.create({
     model: 'gpt-4.1-mini',
-    messages: [{ role: 'user', content: 'Confirm cart abc123' }],
-    functions,
+    messages: promptResponse.messages,
+    functions: toolsResponse.tools,
     function_call: 'auto',
   });
 

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

@@ -0,0 +1,20 @@
+import "reflect-metadata";
+export type IMcpPromptMessage = {
+    role: string;
+    content?: string;
+    tool_call?: {
+        name: string;
+        arguments: object;
+    };
+};
+export interface IMcpPrompt<Payload = any, Result extends IMcpPromptMessage[] = IMcpPromptMessage[]> {
+    name: string;
+    description?: string;
+    inputSchema?: object | object[];
+    execute(input: Payload): Promise<Result>;
+}
+export declare const MCP_PROMPT_METADATA = "mcp:prompt-class";
+/**
+ * Декоратор класса для MCP prompt
+ */
+export declare const McpPrompt: () => (target: any) => void;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPrompt = exports.MCP_PROMPT_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+require("reflect-metadata");
+exports.MCP_PROMPT_METADATA = "mcp:prompt-class";
+/**
+ * Декоратор класса для MCP prompt
+ */
+const McpPrompt = () => {
+    return (target) => {
+        (0, common_1.Injectable)()(target);
+        Reflect.defineMetadata(exports.MCP_PROMPT_METADATA, {}, target);
+    };
+};
+exports.McpPrompt = McpPrompt;

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

@@ -1,9 +1,12 @@
 import "reflect-metadata";
+export type IMcpToolContext = {
+    request: any;
+};
 export interface IMcpTool<Payload = any, Result = any> {
     name: string;
     description?: string;
     inputSchema?: object | object[];
-    execute(input: Payload): Promise<Result>;
+    execute(input: Payload, context: IMcpToolContext): Promise<Result>;
 }
 export declare const MCP_TOOL_METADATA = "mcp:tool-class";
 /**

package/dist/dto/McpMessage.dto.js

@@ -17,10 +17,10 @@ class McpMessageDto {
 }
 exports.McpMessageDto = McpMessageDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: 'string', description: 'Tool name' }),
+    (0, swagger_1.ApiProperty)({ type: "string", description: "Tool name" }),
     __metadata("design:type", String)
 ], McpMessageDto.prototype, "type", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ description: 'Tool handler payload' }),
+    (0, swagger_1.ApiProperty)({ description: "Tool handler payload" }),
     __metadata("design:type", Object)
 ], McpMessageDto.prototype, "payload", void 0);

package/dist/dto/McpPrompt.dto.d.ts

@@ -0,0 +1,4 @@
+export declare class McpPromptDto {
+    name: string;
+    description?: string;
+}

package/dist/dto/McpPrompt.dto.js

@@ -0,0 +1,30 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPromptDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class McpPromptDto {
+    name;
+    description;
+}
+exports.McpPromptDto = McpPromptDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: "string", description: "Propmt name" }),
+    __metadata("design:type", String)
+], McpPromptDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: "string",
+        description: "Propmt description",
+        nullable: true,
+    }),
+    __metadata("design:type", String)
+], McpPromptDto.prototype, "description", void 0);

package/dist/dto/McpPromptMessage.d.ts

@@ -0,0 +1,5 @@
+export declare class McpPromptMessageDto {
+    role: string;
+    content?: string;
+    tool_call?: object;
+}

package/dist/dto/McpPromptMessage.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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPromptMessageDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+class McpPromptMessageDto {
+    role;
+    content;
+    tool_call;
+}
+exports.McpPromptMessageDto = McpPromptMessageDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: "string", description: "AI role" }),
+    __metadata("design:type", String)
+], McpPromptMessageDto.prototype, "role", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: "string",
+        description: "Request ai message",
+        nullable: true,
+    }),
+    __metadata("design:type", String)
+], McpPromptMessageDto.prototype, "content", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: "object",
+        description: "Tool call context",
+        nullable: true,
+        additionalProperties: false,
+    }),
+    __metadata("design:type", Object)
+], McpPromptMessageDto.prototype, "tool_call", void 0);

package/dist/dto/McpPromptMessages.dto.d.ts

@@ -0,0 +1,4 @@
+import { McpPromptMessageDto } from "./McpPromptMessage";
+export declare class McpPromptMessagesDto {
+    messages: McpPromptMessageDto[];
+}

package/dist/dto/McpPromptMessages.dto.js

@@ -0,0 +1,26 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPromptMessagesDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const McpPromptMessage_1 = require("./McpPromptMessage");
+class McpPromptMessagesDto {
+    messages;
+}
+exports.McpPromptMessagesDto = McpPromptMessagesDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: McpPromptMessage_1.McpPromptMessageDto,
+        isArray: true,
+        description: "Messages list",
+    }),
+    __metadata("design:type", Array)
+], McpPromptMessagesDto.prototype, "messages", void 0);

package/dist/dto/McpPrompts.dto.d.ts

@@ -0,0 +1,4 @@
+import { McpPromptDto } from "./McpPrompt.dto";
+export declare class McpPromptsDto {
+    prompts: McpPromptDto[];
+}

package/dist/dto/McpPrompts.dto.js

@@ -0,0 +1,26 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPromptsDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const McpPrompt_dto_1 = require("./McpPrompt.dto");
+class McpPromptsDto {
+    prompts;
+}
+exports.McpPromptsDto = McpPromptsDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        type: McpPrompt_dto_1.McpPromptDto,
+        isArray: true,
+        description: "Prompts list",
+    }),
+    __metadata("design:type", Array)
+], McpPromptsDto.prototype, "prompts", void 0);

package/dist/dto/McpTool.dto.js

@@ -18,14 +18,23 @@ class McpToolDto {
 }
 exports.McpToolDto = McpToolDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: 'string', description: 'Tool name' }),
+    (0, swagger_1.ApiProperty)({ type: "string", description: "Tool name" }),
     __metadata("design:type", String)
 ], McpToolDto.prototype, "name", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: 'string', description: 'Tool description', nullable: true }),
+    (0, swagger_1.ApiProperty)({
+        type: "string",
+        description: "Tool description",
+        nullable: true,
+    }),
     __metadata("design:type", String)
 ], McpToolDto.prototype, "description", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: 'object', description: 'Tool validation schema', nullable: true, additionalProperties: false }),
+    (0, swagger_1.ApiProperty)({
+        type: "object",
+        description: "Tool validation schema",
+        nullable: true,
+        additionalProperties: false,
+    }),
     __metadata("design:type", Object)
 ], McpToolDto.prototype, "parameters", void 0);

package/dist/dto/McpTools.dto.js

@@ -17,6 +17,6 @@ class McpToolsDto {
 }
 exports.McpToolsDto = McpToolsDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ type: McpTool_dto_1.McpToolDto, isArray: true, description: 'Tools list' }),
+    (0, swagger_1.ApiProperty)({ type: McpTool_dto_1.McpToolDto, isArray: true, description: "Tools list" }),
     __metadata("design:type", Array)
 ], McpToolsDto.prototype, "tools", void 0);

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./mcp.module";
 export * from "./decorators/mcp-tool.decorator";
+export * from "./decorators/mcp-prompt.decorator";

package/dist/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mcp.module"), exports);
 __exportStar(require("./decorators/mcp-tool.decorator"), exports);
+__exportStar(require("./decorators/mcp-prompt.decorator"), exports);

package/dist/mcp.controller.d.ts

@@ -1,10 +1,14 @@
+import { ExecutionContext, CanActivate } from "@nestjs/common";
 import { McpService } from "./mcp.service";
 import { McpMessageDto } from "./dto/McpMessage.dto";
 import { McpToolsDto } from "./dto/McpTools.dto";
+import { McpPromptsDto } from "./dto/McpPrompts.dto";
+import { McpPromptMessagesDto } from "./dto/McpPromptMessages.dto";
 export declare class McpController {
     private readonly service;
-    constructor(service: McpService);
-    handle(body: McpMessageDto): Promise<{
+    private readonly guard;
+    constructor(service: McpService, guard: CanActivate);
+    handle(body: McpMessageDto, request: any, context: ExecutionContext): Promise<{
         success: boolean;
         data: any;
         error?: undefined;
@@ -13,5 +17,8 @@ export declare class McpController {
         error: any;
         data?: undefined;
     }>;
-    getTools(): Promise<McpToolsDto>;
+    getTools(context: ExecutionContext): Promise<McpToolsDto>;
+    getPrompts(context: ExecutionContext): Promise<McpPromptsDto>;
+    getPrompt(name: string, body: object, context: ExecutionContext): Promise<McpPromptMessagesDto>;
+    private checkGuard;
 }

package/dist/mcp.controller.js

@@ -18,53 +18,136 @@ const mcp_service_1 = require("./mcp.service");
 const McpMessage_dto_1 = require("./dto/McpMessage.dto");
 const swagger_1 = require("@nestjs/swagger");
 const McpTools_dto_1 = require("./dto/McpTools.dto");
+const McpPrompts_dto_1 = require("./dto/McpPrompts.dto");
+const McpPromptMessages_dto_1 = require("./dto/McpPromptMessages.dto");
+const context_decorator_1 = require("./utils/context.decorator");
+const inject_tokens_1 = require("./utils/inject-tokens");
 let McpController = class McpController {
     service;
-    constructor(service) {
+    guard;
+    constructor(service, guard) {
         this.service = service;
+        this.guard = guard;
     }
-    async handle(body) {
-        return this.service.sendMessage(body);
+    async handle(body, request, context) {
+        await this.checkGuard(context);
+        return this.service.sendMessage(body, { request });
     }
-    async getTools() {
+    async getTools(context) {
+        await this.checkGuard(context);
         const tools = this.service.listTools();
         return { tools };
     }
+    async getPrompts(context) {
+        await this.checkGuard(context);
+        const prompts = this.service.listPrompts();
+        return { prompts };
+    }
+    async getPrompt(name, body, context) {
+        await this.checkGuard(context);
+        const messages = await this.service.getPrompt(name, body);
+        return {
+            messages,
+        };
+    }
+    async checkGuard(context) {
+        if (!(await this.guard.canActivate(context))) {
+            throw new common_1.ForbiddenException();
+        }
+    }
 };
 exports.McpController = McpController;
 __decorate([
     (0, common_1.Post)(),
     (0, common_1.Header)("Content-Type", "application/json"),
     (0, swagger_1.ApiOperation)({
-        summary: 'Request tool',
+        summary: "Request tool",
     }),
     (0, swagger_1.ApiResponse)({
         status: 200,
-        description: 'Tool execution result',
+        description: "Tool execution result",
     }),
     (0, swagger_1.ApiBadRequestResponse)({
-        description: 'Invalid request body',
+        description: "Invalid request body",
+    }),
+    (0, swagger_1.ApiForbiddenResponse)({
+        description: "No access to method",
     }),
     __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Request)()),
+    __param(2, (0, context_decorator_1.Context)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [McpMessage_dto_1.McpMessageDto]),
+    __metadata("design:paramtypes", [McpMessage_dto_1.McpMessageDto, Object, Object]),
     __metadata("design:returntype", Promise)
 ], McpController.prototype, "handle", null);
 __decorate([
     (0, common_1.Get)("tools"),
     (0, swagger_1.ApiOperation)({
-        summary: 'Get tool list',
+        summary: "Get tool list",
     }),
     (0, swagger_1.ApiResponse)({
         status: 200,
-        description: 'Tools list',
+        description: "Tools list",
         type: McpTools_dto_1.McpToolsDto,
     }),
+    (0, swagger_1.ApiForbiddenResponse)({
+        description: "No access to method",
+    }),
+    __param(0, (0, context_decorator_1.Context)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
+    __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], McpController.prototype, "getTools", null);
+__decorate([
+    (0, common_1.Get)("prompts"),
+    (0, swagger_1.ApiOperation)({
+        summary: "Get prompt list",
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: "Prompts list",
+        type: McpPrompts_dto_1.McpPromptsDto,
+    }),
+    (0, swagger_1.ApiForbiddenResponse)({
+        description: "No access to method",
+    }),
+    __param(0, (0, context_decorator_1.Context)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], McpController.prototype, "getPrompts", null);
+__decorate([
+    (0, common_1.Post)("prompts/:name"),
+    (0, swagger_1.ApiOperation)({
+        summary: "Generate messages by prompt name",
+    }),
+    (0, swagger_1.ApiBody)({
+        description: "Any body structure",
+        type: Object, // Указываем, что тело может быть любым объектом
+    }),
+    (0, swagger_1.ApiResponse)({
+        status: 200,
+        description: "Prompt messages",
+        type: McpPromptMessages_dto_1.McpPromptMessagesDto,
+    }),
+    (0, swagger_1.ApiNotFoundResponse)({
+        description: "Not found prompt",
+    }),
+    (0, swagger_1.ApiBadRequestResponse)({
+        description: "Invalid prompt arguments",
+    }),
+    (0, swagger_1.ApiForbiddenResponse)({
+        description: "No access to method",
+    }),
+    __param(0, (0, common_1.Param)("name")),
+    __param(1, (0, common_1.Body)()),
+    __param(2, (0, context_decorator_1.Context)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], McpController.prototype, "getPrompt", null);
 exports.McpController = McpController = __decorate([
     (0, common_1.Controller)("mcp"),
-    __metadata("design:paramtypes", [mcp_service_1.McpService])
+    __param(1, (0, common_1.Inject)(inject_tokens_1.MCP_GUARD)),
+    __metadata("design:paramtypes", [mcp_service_1.McpService, Object])
 ], McpController);

package/dist/mcp.explorer.js

@@ -14,6 +14,7 @@ const core_1 = require("@nestjs/core");
 const common_1 = require("@nestjs/common");
 const mcp_service_1 = require("./mcp.service");
 const mcp_tool_decorator_1 = require("./decorators/mcp-tool.decorator");
+const mcp_prompt_decorator_1 = require("./decorators/mcp-prompt.decorator");
 let McpExplorer = class McpExplorer {
     discovery;
     mcpService;
@@ -35,6 +36,18 @@ let McpExplorer = class McpExplorer {
             }
             this.mcpService.registerTool(instance.name, instance);
         });
+        providers.forEach(({ instance, metatype }) => {
+            if (!instance || !metatype)
+                return;
+            const metadata = Reflect.getMetadata(mcp_prompt_decorator_1.MCP_PROMPT_METADATA, metatype);
+            if (!metadata)
+                return;
+            // Проверка интерфейса
+            if (typeof instance.execute !== "function") {
+                throw new Error(`MCP Prompt ${instance.name} must implement IMcpPrompt with execute() method`);
+            }
+            this.mcpService.registerPrompt(instance.name, instance);
+        });
     }
 };
 exports.McpExplorer = McpExplorer;

package/dist/mcp.module.d.ts

@@ -1,5 +1,7 @@
-import { DynamicModule, ModuleMetadata } from "@nestjs/common";
-type Metadata = Pick<ModuleMetadata, 'providers' | 'imports' | 'exports'>;
+import { CanActivate, DynamicModule, ModuleMetadata, Provider } from "@nestjs/common";
+type Metadata = Pick<ModuleMetadata, "providers" | "imports" | "exports"> & {
+    guard?: Provider<CanActivate>;
+};
 export declare class McpModule {
     static forRoot(metadata?: Metadata): DynamicModule;
 }

package/dist/mcp.module.js

@@ -13,18 +13,33 @@ const core_1 = require("@nestjs/core");
 const mcp_service_1 = require("./mcp.service");
 const mcp_explorer_1 = require("./mcp.explorer");
 const mcp_controller_1 = require("./mcp.controller");
+const inject_tokens_1 = require("./utils/inject-tokens");
+const publicGuard = { canActivate: () => Promise.resolve(true) };
 let McpModule = McpModule_1 = class McpModule {
     static forRoot(metadata = {}) {
+        const guardProvider = metadata.guard
+            ? { provide: inject_tokens_1.MCP_GUARD, useExisting: metadata.guard }
+            : {
+                provide: inject_tokens_1.MCP_GUARD,
+                useValue: publicGuard,
+            };
         return {
             module: McpModule_1,
             imports: [core_1.DiscoveryModule, ...(metadata.imports || [])],
-            providers: [mcp_service_1.McpService, mcp_explorer_1.McpExplorer, ...(metadata.providers || [])],
-            exports: [mcp_service_1.McpService, ...(metadata.providers || [])],
+            providers: [
+                mcp_service_1.McpService,
+                mcp_explorer_1.McpExplorer,
+                guardProvider,
+                ...(metadata.guard ? [metadata.guard] : []),
+                ...(metadata.providers || []),
+            ],
+            exports: [mcp_service_1.McpService, ...(metadata.exports || [])],
             controllers: [mcp_controller_1.McpController],
         };
     }
 };
 exports.McpModule = McpModule;
 exports.McpModule = McpModule = McpModule_1 = __decorate([
+    (0, common_1.Global)(),
     (0, common_1.Module)({})
 ], McpModule);

package/dist/mcp.service.d.ts

@@ -1,5 +1,6 @@
 import { OnModuleInit } from "@nestjs/common";
-import { IMcpTool } from "./decorators/mcp-tool.decorator";
+import { IMcpTool, IMcpToolContext } from "./decorators/mcp-tool.decorator";
+import { IMcpPrompt } from "./decorators/mcp-prompt.decorator";
 export interface McpMessage {
     type: string;
     payload: any;
@@ -11,6 +12,7 @@ export interface McpResponse {
 }
 export declare class McpService implements OnModuleInit {
     private tools;
+    private prompts;
     private ajv;
     onModuleInit(): void;
     /**
@@ -21,14 +23,20 @@ export declare class McpService implements OnModuleInit {
         description: string;
         parameters: object;
     }[];
+    listPrompts(): {
+        name: string;
+        description: string;
+    }[];
     registerTool(name: string, handler: IMcpTool): void;
+    registerPrompt(name: string, handler: IMcpPrompt): void;
+    getPrompt(name: string, payload: object): Promise<import("./decorators/mcp-prompt.decorator").IMcpPromptMessage[]>;
     /**
      * Отправить сообщение в MCP "сервер"
      */
     sendMessage(msg: {
         type: string;
         payload: any;
-    }): Promise<{
+    }, context: IMcpToolContext): Promise<{
         success: boolean;
         data: any;
         error?: undefined;

package/dist/mcp.service.js

@@ -11,6 +11,7 @@ const common_1 = require("@nestjs/common");
 const ajv_1 = require("ajv");
 let McpService = class McpService {
     tools = new Map();
+    prompts = new Map();
     ajv = new ajv_1.default();
     onModuleInit() {
         // console.log('MCP Service initialized');
@@ -25,13 +26,37 @@ let McpService = class McpService {
             parameters: t.inputSchema || {},
         }));
     }
+    listPrompts() {
+        return Array.from(this.prompts.values()).map((t) => ({
+            name: t.name,
+            description: t.description || "",
+        }));
+    }
     registerTool(name, handler) {
         this.tools.set(name, handler);
     }
+    registerPrompt(name, handler) {
+        this.prompts.set(name, handler);
+    }
+    getPrompt(name, payload) {
+        if (!this.prompts.has(name)) {
+            throw new common_1.NotFoundException("Not found prompt");
+        }
+        const prompt = this.prompts.get(name);
+        // Валидация через AJV, если есть inputSchema
+        if (prompt.inputSchema) {
+            const validate = this.ajv.compile(prompt.inputSchema);
+            const valid = validate(payload);
+            if (!valid) {
+                throw new common_1.NotFoundException("Invalid prompt arguments");
+            }
+        }
+        return prompt.execute(payload);
+    }
     /**
      * Отправить сообщение в MCP "сервер"
      */
-    async sendMessage(msg) {
+    async sendMessage(msg, context) {
         const tool = this.tools.get(msg.type);
         if (!tool) {
             return { success: false, error: `Unknown tool: "${msg.type}"` };
@@ -45,7 +70,7 @@ let McpService = class McpService {
             }
         }
         try {
-            const result = await tool.execute(msg.payload);
+            const result = await tool.execute(msg.payload, context);
             return { success: true, data: result };
         }
         catch (err) {

package/dist/utils/context.decorator.d.ts

@@ -0,0 +1 @@
+export declare const Context: (...dataOrPipes: unknown[]) => ParameterDecorator;

package/dist/utils/context.decorator.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+const common_1 = require("@nestjs/common");
+exports.Context = (0, common_1.createParamDecorator)((data, context) => context);

package/dist/utils/inject-tokens.d.ts

@@ -0,0 +1 @@
+export declare const MCP_GUARD = "MCP:guard";

package/dist/utils/inject-tokens.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_GUARD = void 0;
+exports.MCP_GUARD = "MCP:guard";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muzikanto/nestjs-mcp",
-  "version": "1.0.1",
+  "version": "1.1.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",
@@ -19,6 +19,8 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
+    "lint": "prettier --check 'src/**/*.ts'",
+    "format": "prettier --write 'src/**/*.ts'",
     "ch": "changeset",
     "vers": "changeset version",
     "pub": "changeset publish"
@@ -49,8 +51,15 @@
       "name": "Maxim Schiriy"
     }
   ],
+  "homepage": "https://github.com/Muzikanto/nestjs-mcp#readme",
   "repository": {
     "type": "git",
     "url": "https://github.com/Muzikanto/nestjs-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/Muzikanto/nestjs-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
   }
 }