@rekog/mcp-nest 1.2.0 → 1.3.0

package/.github/workflows/pipeline.yml

@@ -0,0 +1,26 @@
+name: Node.js CI and Publish
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+      - name: Install dependencies
+        run: npm ci
+      - name: Run tests
+        run: npm run test

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/README.md

@@ -1,19 +1,23 @@
 # NestJS MCP Server Module
 
-A NestJS module for exposing your services as an MCP (Model Context Protocol) server with Server-Sent Events (SSE) transport. This package simplifies exposing tools that clients can discover and execute via SSE.
+A NestJS module for creating an MCP (Model Context Protocol) server with Server-Sent Events (SSE) transport.
+
+<p align="center">
+  <img src="./image.png" height="200">
+</p>
 
 ## Features
 
-- **SSE Transport**: Built-in `/sse` endpoint for streaming and `/messages` for handling tool execution
-- **Tool Discovery**: Automatically discover and register tools using decorators
-- **Tool Request Validation**: Define Zod schemas to validate tool requests.
-- **Progress Notifications**: Send continuous progress updates from tools to clients.
-- **Authentication**: Integrates with NestJS Guards for securing endpoints.
+- 🚀 SSE Transport for streaming and tool execution
+- 🔍 Automatic `tool` and `resource` discovery and registration
+- 💯 Zod-based request validation
+- 📊 Progress notifications
+- 🔒 Guard-based authentication
 
 ## Installation
 
 ```bash
-npm install @rekog/mcp-nest reflect-metadata @modelcontextprotocol/sdk zod @nestjs/common @nestjs/core
+npm install @rekog/mcp-nest @modelcontextprotocol/sdk zod
 ```
 
 ## Quick Start
@@ -31,14 +35,14 @@ import { GreetingTool } from './greeting.tool';
     McpModule.forRoot({
       name: 'my-mcp-server',
       version: '1.0.0',
-    })
+    }),
   ],
-  providers: [GreetingTool]
+  providers: [GreetingTool],
 })
 export class AppModule {}
 ```
 
-### 2. Define Tools
+### 2. Define Tools and Resource
 
 ```typescript
 // greeting.tool.ts
@@ -77,50 +81,52 @@ export class GreetingTool {
       content: [{ type: 'text', text: greeting }],
     };
   }
+
+  @Resource({
+    uri: 'mcp://hello-world/{userName}',
+    name: 'Hello World',
+    description: 'A simple greeting resource',
+    mimeType: 'text/plain',
+  })
+  // Different from the SDK, we put the parameters and URI in the same object.
+  async getCurrentSchema({ uri, userName }) {
+    return {
+      content: [
+        {
+          uri,
+          text: `User is ${userName}`,
+          mimeType: 'text/plain',
+        },
+      ],
+    };
+  }
 }
 ```
 
 You are done!
 
-## Authentication
+## API Endpoints
 
-You can secure your MCP endpoints using standard NestJS Guards.
+- `GET /sse`: SSE connection endpoint (Protected by guards if configured)
+- `POST /messages`: Tool execution endpoint (Protected by guards if configured)
 
-### 1. Create a Guard
+### Tips
 
-Implement the `CanActivate` interface. The guard should handle request validation (e.g., checking JWTs, API keys) and optionally attach user information to the request object.
-<details>
-<summary>Example Guard Implementation</summary>
+It's possible to use the module with global prefix, but the recommended way is to exclude those endpoints with:
 
 ```typescript
-// auth.guard.ts
-import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common';
-import { Observable } from 'rxjs';
+app.setGlobalPrefix('/api', { exclude: ['sse', 'messages'] });
+```
 
-@Injectable()
-export class AuthGuard implements CanActivate {
-  canActivate(
-    context: ExecutionContext,
-  ): boolean | Promise<boolean> | Observable<boolean> {
-    const request = context.switchToHttp().getRequest();
-    const authorization = request.headers.authorization;
-
-    // Example: Check for a specific Bearer token
-    if (authorization && authorization.startsWith('Bearer ')) {
-      const token = authorization.substring(7);
-      if (token === 'your-secret-token') {
-        // Attach user info if needed (optional)
-        request.user = { id: 'user-123', roles: ['admin'] };
-        return true; // Allow access
-      }
-    }
+## Authentication
 
-    return false; // Deny access
-  }
-}
-```
+You can secure your MCP endpoints using standard NestJS Guards.
+
+### 1. Create a Guard
+
+Implement the `CanActivate` interface. The guard should handle request validation (e.g., checking JWTs, API keys) and optionally attach user information to the request object.
 
-</details>
+Nothing special, check the NestJS documentation for more details.
 
 ### 2. Apply the Guard
 
@@ -138,157 +144,12 @@ import { AuthGuard } from './auth.guard';
     McpModule.forRoot({
       name: 'my-mcp-server',
       version: '1.0.0',
-      guards: [AuthGuard] // Apply the guard here
-    })
+      guards: [AuthGuard], // Apply the guard here
+    }),
   ],
-  providers: [GreetingTool, AuthGuard] // Ensure the Guard is also provided
+  providers: [GreetingTool, AuthGuard], // Ensure the Guard is also provided
 })
 export class AppModule {}
 ```
 
-### 3. Access User Context in Tools (Optional)
-
-If your guard attaches user information to the `request` object (e.g., `request.user = ...`), you can access it in your tool as the third parameter.
-
-```typescript
-// authenticated-greeting.tool.ts
-import { Injectable } from '@nestjs/common';
-import { Tool, Context } from '@rekog/mcp-nest';
-import { z } from 'zod';
-import { Request } from 'express'; // Import Request from express
-
-@Injectable()
-export class AuthenticatedGreetingTool {
-
-  @Tool({
-    name: 'auth-hello-world',
-    description: 'Greets the authenticated user',
-    parameters: z.object({}), // No parameters needed for this example
-  })
-  // Add 'request' as the third parameter
-  async sayAuthHello(args: {}, context: Context, request: Request & { user?: { id: string } }) {
-    const userId = request.user?.id || 'Anonymous';
-    const greeting = `Hello, user ${userId}!`;
-
-    return {
-      content: [{ type: 'text', text: greeting }],
-    };
-  }
-}
-```
-
-*Note: Ensure your tool (`AuthenticatedGreetingTool` in this example) is added to the `providers` array in your `AppModule`.*
-
-## Client Connection
-
-Clients need to provide the necessary credentials (e.g., Authorization header) when connecting if authentication is enabled.
-
-### Unauthenticated Client
-
-```typescript
-// client.ts (no authentication)
-import { Client } from '@modelcontextprotocol/sdk/client';
-import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse';
-
-const client = new Client(
-  { name: 'client-name', version: '1.0.0' },
-  { capabilities: {} }
-);
-
-await client.connect(
-  new SSEClientTransport(new URL('http://localhost:3000/sse'))
-);
-
-// ... list tools, call tools etc.
-```
-
-### Authenticated Client
-
-Pass request options (like headers) to the `SSEClientTransport`.
-
-```typescript
-// client.ts (with authentication)
-import { Client } from '@modelcontextprotocol/sdk/client';
-import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse';
-
-const client = new Client(
-  { name: 'client-name', version: '1.0.0' },
-  { capabilities: {} }
-);
-
-const transport = new SSEClientTransport(
-  new URL('http://localhost:3000/sse'),
-  {
-    // Provide necessary credentials here
-    requestInit: {
-      headers: {
-        Authorization: 'Bearer your-secret-token' // Match guard expectation
-      }
-    }
-  }
-);
-
-await client.connect(transport);
-
-
-// Execute the 'auth-hello-world' tool
-const greetResult = await client.callTool(
-  {
-    name: 'auth-hello-world',
-    arguments: {},
-  },
-  undefined, // responseSchema is optional
-  {
-    onprogress: (progress) => { // Example progress handler
-      console.log(
-        `Progress: ${progress.progress}/${progress.total}`
-      );
-    },
-  },
-);
-
-console.log(greetResult.content[0].text); // Output: Hello, user user-123!
-```
-
-## API Endpoints
-
-- `GET /sse`: SSE connection endpoint (Protected by guards if configured)
-- `POST /messages`: Tool execution endpoint (Protected by guards if configured)
-
-## Configuration Reference
-
-### `McpOptions`
-
-| Property             | Type                      | Description                                                                 | Default Value |
-|----------------------|---------------------------|-----------------------------------------------------------------------------|---------------|
-| `name`               | string                    | Server name                                                                 | -             |
-| `version`            | string                    | Server version                                                              | -             |
-| `capabilities`       | Record<string, any>       | Server capabilities, defines what the server can do.                        | `{}`          |
-| `guards`             | `any[]` (NestJS Guards)   | An array of NestJS Guards to apply to the MCP endpoints.                    | `[]`          |
-| `sseEndpoint`        | string (optional)         | Endpoint for SSE connections.                                               | `'sse'`       |
-| `messagesEndpoint`   | string (optional)         | Endpoint for handling tool execution.                                        | `'messages'`  |
-| `globalApiPrefix`    | string (optional)         | Global API prefix for all endpoints.                                        | `''`          |
-
-### Tool Decorator
-
-The `@Tool` decorator is used to define a method as an MCP tool.
-
-```typescript
-@Tool({ name: string, description: string, parameters?: z.ZodObject<any> })
-```
-
-- `name`: The name of the tool. This will be used to list it in the `listTools` request.
-- `description`: A description of the tool.
-- `parameters`: (Optional) A Zod schema defining the expected structure of the tool's input arguments.
-
-### Context Parameter
-
-The second parameter passed to a `@Tool` decorated method is the `Context` object.
-
-- `context.reportProgress(progress: Progress)`: Sends a progress update message to the client. `Progress` typically has `{ progress: number, total: number }`.
-
-### Request Paramter
-
-The third parameter passed to a `@Tool` decorated method is the `Request` object.
-
-- `request`: The request object from the underlying HTTP framework (e.g., Express). This can be used to access headers, query parameters, etc.
+That's it! The rest is the same as NestJS Guards.

package/dist/controllers/sse.controller.factory.d.ts

@@ -5,18 +5,16 @@ import { ModuleRef } from '@nestjs/core';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
 import { McpOptions } from '../interfaces';
-import { McpToolRegistryService } from '../services/mcp-tool-registry.service';
+import { McpRegistryService } from '../services/mcp-registry.service';
 export declare function createSseController(sseEndpoint: string, messagesEndpoint: string, globalApiPrefix: string, guards?: Type<CanActivate>[]): {
-    new (options: McpOptions, moduleRef: ModuleRef, toolRegistry: McpToolRegistryService): {
+    new (options: McpOptions, moduleRef: ModuleRef, toolRegistry: McpRegistryService): {
         transports: Map<string, SSEServerTransport>;
         mcpServers: Map<string, McpServer>;
         readonly options: McpOptions;
         readonly moduleRef: ModuleRef;
-        readonly toolRegistry: McpToolRegistryService;
+        readonly toolRegistry: McpRegistryService;
         sse(res: Response): Promise<void>;
-        messages(req: Request & {
-            user: any;
-        }, res: Response, body: unknown): Promise<Response<any, Record<string, any>> | undefined>;
+        messages(req: Request, res: Response, body: unknown): Promise<Response<any, Record<string, any>> | undefined>;
     };
 };
 //# sourceMappingURL=sse.controller.factory.d.ts.map

package/dist/controllers/sse.controller.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.controller.factory.d.ts","sourceRoot":"","sources":["../../src/controllers/sse.controller.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,IAAI,EAAa,MAAM,gBAAgB,CAAC;AAChG,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAM/E,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,MAAM,GAAE,IAAI,CAAC,WAAW,CAAC,EAAO;kBAcoB,UAAU,aAC/B,SAAS,gBACN,sBAAsB;;;0BAFJ,UAAU;4BAC/B,SAAS;+BACN,sBAAsB;iBAOhC,QAAQ;sBA4BH,OAAO,GAAG;YAAE,IAAI,EAAE,GAAG,CAAA;SAAE,OAAc,QAAQ,QAAgB,OAAO;;EA6BlG"}
+{"version":3,"file":"sse.controller.factory.d.ts","sourceRoot":"","sources":["../../src/controllers/sse.controller.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,IAAI,EAEL,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAMtE,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,MAAM,GAAE,IAAI,CAAC,WAAW,CAAC,EAAO;kBAaoB,UAAU,aAC/B,SAAS,gBACN,kBAAkB;;;0BAFA,UAAU;4BAC/B,SAAS;+BACN,kBAAkB;iBAO5B,QAAQ;sBAsChB,OAAO,OACP,QAAQ,QACN,OAAO;;EA+B1B"}

package/dist/controllers/sse.controller.factory.js

@@ -17,8 +17,8 @@ const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
-const mcp_tool_registry_service_1 = require("../services/mcp-tool-registry.service");
-const mcp_tools_executor_service_1 = require("../services/mcp-tools-executor.service");
+const mcp_registry_service_1 = require("../services/mcp-registry.service");
+const mcp_executor_service_1 = require("../services/mcp-executor.service");
 function createSseController(sseEndpoint, messagesEndpoint, globalApiPrefix, guards = []) {
     let SseController = class SseController {
         constructor(options, moduleRef, toolRegistry) {
@@ -31,7 +31,13 @@ function createSseController(sseEndpoint, messagesEndpoint, globalApiPrefix, gua
         async sse(res) {
             const transport = new sse_js_1.SSEServerTransport(`${globalApiPrefix}/${messagesEndpoint}`, res);
             const sessionId = transport.sessionId;
-            const mcpServer = new mcp_js_1.McpServer({ name: this.options.name, version: this.options.version }, { capabilities: this.options.capabilities || { tools: {} } });
+            const mcpServer = new mcp_js_1.McpServer({ name: this.options.name, version: this.options.version }, {
+                capabilities: this.options.capabilities || {
+                    tools: {},
+                    resources: {},
+                    resourceTemplates: {},
+                },
+            });
             this.transports.set(sessionId, transport);
             this.mcpServers.set(sessionId, mcpServer);
             transport.onclose = () => {
@@ -50,8 +56,9 @@ function createSseController(sseEndpoint, messagesEndpoint, globalApiPrefix, gua
             if (!mcpServer) {
                 return res.status(404).send('MCP server not found for session');
             }
-            const toolExecutor = await this.moduleRef.resolve(mcp_tools_executor_service_1.McpToolsExecutorService, undefined, { strict: false });
-            toolExecutor.registerRequestHandlers(mcpServer, req);
+            const contextId = core_1.ContextIdFactory.getByRequest(req);
+            const executor = await this.moduleRef.resolve(mcp_executor_service_1.McpExecutorService, contextId, { strict: false });
+            executor.registerRequestHandlers(mcpServer, req);
             await transport.handlePostMessage(req, res, body);
         }
     };
@@ -76,7 +83,7 @@ function createSseController(sseEndpoint, messagesEndpoint, globalApiPrefix, gua
         (0, common_1.Controller)(),
         __param(0, (0, common_1.Inject)('MCP_OPTIONS')),
         __metadata("design:paramtypes", [Object, core_1.ModuleRef,
-            mcp_tool_registry_service_1.McpToolRegistryService])
+            mcp_registry_service_1.McpRegistryService])
     ], SseController);
     return SseController;
 }

package/dist/controllers/sse.controller.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.controller.factory.js","sourceRoot":"","sources":["../../src/controllers/sse.controller.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sse.controller.factory.js","sourceRoot":"","sources":["../../src/controllers/sse.controller.factory.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAwBA,kDAiGC;AAzHD,2CAUwB;AAGxB,uCAA2D;AAE3D,oEAAoE;AACpE,oEAA6E;AAE7E,2EAAsE;AACtE,2EAAsE;AAKtE,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,gBAAwB,EACxB,eAAuB,EACvB,SAA8B,EAAE;IAEhC,IACM,aAAa,GADnB,MACM,aAAa;QASjB,YACyB,OAAmC,EAC1C,SAAoB,EACpB,YAAgC;YAFT,YAAO,GAAP,OAAO,CAAY;YAC1C,cAAS,GAAT,SAAS,CAAW;YACpB,iBAAY,GAAZ,YAAY,CAAoB;YAP3C,eAAU,GAAG,IAAI,GAAG,EAA8B,CAAC;YAEnD,eAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;QAM9C,CAAC;QAME,AAAN,KAAK,CAAC,GAAG,CAAQ,GAAa;YAC5B,MAAM,SAAS,GAAG,IAAI,2BAAkB,CACtC,GAAG,eAAe,IAAI,gBAAgB,EAAE,EACxC,GAAG,CACJ,CAAC;YACF,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;YAGtC,MAAM,SAAS,GAAG,IAAI,kBAAS,CAC7B,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAC1D;gBACE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI;oBACzC,KAAK,EAAE,EAAE;oBACT,SAAS,EAAE,EAAE;oBACb,iBAAiB,EAAE,EAAE;iBACtB;aACF,CACF,CAAC;YAGF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAE1C,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBAEvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC,CAAC;YAEF,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAOK,AAAN,KAAK,CAAC,QAAQ,CACL,GAAY,EACZ,GAAa,EACZ,IAAa;YAErB,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAmB,CAAC;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAEjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAClE,CAAC;YAGD,MAAM,SAAS,GAAG,uBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3C,yCAAkB,EAClB,SAAS,EACT,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;YAGF,QAAQ,CAAC,uBAAuB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAGjD,MAAM,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;KACF,CAAA;IApEO;QADL,IAAA,YAAG,EAAC,WAAW,CAAC;QACN,WAAA,IAAA,YAAG,GAAE,CAAA;;;;4CA8Bf;IAOK;QAFL,IAAA,aAAI,EAAC,gBAAgB,CAAC;QACtB,IAAA,kBAAS,EAAC,GAAG,MAAM,CAAC;QAElB,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,YAAG,GAAE,CAAA;QACL,WAAA,IAAA,aAAI,GAAE,CAAA;;;;iDA2BR;IAtFG,aAAa;QADlB,IAAA,mBAAU,GAAE;QAWR,WAAA,IAAA,eAAM,EAAC,aAAa,CAAC,CAAA;iDACK,gBAAS;YACN,yCAAkB;OAZ9C,aAAa,CAuFlB;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/decorators/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const MCP_TOOL_METADATA_KEY = "mcp:tool";
+export declare const MCP_RESOURCE_METADATA_KEY = "mcp:resource";
 //# sourceMappingURL=constants.d.ts.map

package/dist/decorators/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,aAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,yBAAyB,iBAAiB,CAAC"}

package/dist/decorators/constants.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_TOOL_METADATA_KEY = void 0;
+exports.MCP_RESOURCE_METADATA_KEY = exports.MCP_TOOL_METADATA_KEY = void 0;
 exports.MCP_TOOL_METADATA_KEY = 'mcp:tool';
+exports.MCP_RESOURCE_METADATA_KEY = 'mcp:resource';
 //# sourceMappingURL=constants.js.map

package/dist/decorators/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,UAAU,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/decorators/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,qBAAqB,GAAG,UAAU,CAAC;AACnC,QAAA,yBAAyB,GAAG,cAAc,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,3 +1,4 @@
 export * from './tool.decorator';
 export * from './constants';
+export * from './resource.decorator';
 //# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/decorators/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./tool.decorator"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./resource.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8CAA4B;AAC5B,uDAAqC"}

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

@@ -0,0 +1,9 @@
+export type ResourceOptions = {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+};
+export type ResourceMetadata = ResourceOptions;
+export declare const Resource: (options: ResourceOptions) => import("@nestjs/common").CustomDecorator<string>;
+//# sourceMappingURL=resource.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/resource.decorator.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAEzB;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAS/C,eAAO,MAAM,QAAQ,YAAa,eAAe,qDAEhD,CAAC"}

package/dist/decorators/resource.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Resource = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("./constants");
+const Resource = (options) => {
+    return (0, common_1.SetMetadata)(constants_1.MCP_RESOURCE_METADATA_KEY, options);
+};
+exports.Resource = Resource;
+//# 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":";;;AAAA,2CAA6C;AAC7C,2CAAwD;AAoBjD,MAAM,QAAQ,GAAG,CAAC,OAAwB,EAAE,EAAE;IACnD,OAAO,IAAA,oBAAW,EAAC,qCAAyB,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,QAAQ,YAEnB"}

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

@@ -1,12 +1,13 @@
-import { z } from "zod";
+import { z } from 'zod';
 export interface ToolMetadata {
     name: string;
     description: string;
     parameters?: z.ZodTypeAny;
 }
-export declare const Tool: ({ name, description, parameters, }: {
+export interface ToolOptions {
     name: string;
     description: string;
     parameters?: z.ZodTypeAny;
-}) => import("@nestjs/common").CustomDecorator<string>;
+}
+export declare const Tool: (options: ToolOptions) => import("@nestjs/common").CustomDecorator<string>;
 //# sourceMappingURL=tool.decorator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC3B;AAED,eAAO,MAAM,IAAI,uCAId;IACD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC3B,qDAMA,CAAC"}
+{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;CAC3B;AAUD,eAAO,MAAM,IAAI,YAAa,WAAW,qDAExC,CAAC"}

package/dist/decorators/tool.decorator.js

@@ -3,12 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
 const common_1 = require("@nestjs/common");
 const constants_1 = require("./constants");
-const Tool = ({ name, description, parameters, }) => {
-    return (0, common_1.SetMetadata)(constants_1.MCP_TOOL_METADATA_KEY, {
-        name,
-        description,
-        parameters,
-    });
+const Tool = (options) => {
+    return (0, common_1.SetMetadata)(constants_1.MCP_TOOL_METADATA_KEY, options);
 };
 exports.Tool = Tool;
 //# sourceMappingURL=tool.decorator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAAoD;AAS7C,MAAM,IAAI,GAAG,CAAC,EACnB,IAAI,EACJ,WAAW,EACX,UAAU,GAKX,EAAE,EAAE;IACH,OAAO,IAAA,oBAAW,EAAC,iCAAqB,EAAE;QACxC,IAAI;QACJ,WAAW;QACX,UAAU;KACX,CAAC,CAAC;AACL,CAAC,CAAC;AAdW,QAAA,IAAI,QAcf"}
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAAoD;AAuB7C,MAAM,IAAI,GAAG,CAAC,OAAoB,EAAE,EAAE;IAC3C,OAAO,IAAA,oBAAW,EAAC,iCAAqB,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC,CAAC;AAFW,QAAA,IAAI,QAEf"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './decorators';
 export * from './interfaces';
 export * from './mcp.module';
-export * from './services/mcp-tool-registry.service';
-export * from './services/mcp-tools-executor.service';
+export * from './services/mcp-registry.service';
+export * from './services/mcp-executor.service';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC"}

package/dist/index.js

@@ -17,6 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./decorators"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./mcp.module"), exports);
-__exportStar(require("./services/mcp-tool-registry.service"), exports);
-__exportStar(require("./services/mcp-tools-executor.service"), exports);
+__exportStar(require("./services/mcp-registry.service"), exports);
+__exportStar(require("./services/mcp-executor.service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,+CAA6B;AAC7B,+CAA6B;AAC7B,uEAAqD;AACrD,wEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,+CAA6B;AAC7B,+CAA6B;AAC7B,kEAAgD;AAChD,kEAAgD"}

package/dist/interfaces/index.d.ts

@@ -1,2 +1,3 @@
 export * from './mcp-options.interface';
+export * from './mcp-tool.interface';
 //# sourceMappingURL=index.d.ts.map

package/dist/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC"}

package/dist/interfaces/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mcp-options.interface"), exports);
+__exportStar(require("./mcp-tool.interface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

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

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

@@ -0,0 +1,15 @@
+import { Progress } from '@modelcontextprotocol/sdk/types.js';
+export type Literal = boolean | null | number | string | undefined;
+export type SerializableValue = Literal | SerializableValue[] | {
+    [key: string]: SerializableValue;
+};
+export type Context = {
+    reportProgress: (progress: Progress) => Promise<void>;
+    log: {
+        debug: (message: string, data?: SerializableValue) => void;
+        error: (message: string, data?: SerializableValue) => void;
+        info: (message: string, data?: SerializableValue) => void;
+        warn: (message: string, data?: SerializableValue) => void;
+    };
+};
+//# sourceMappingURL=mcp-tool.interface.d.ts.map

package/dist/interfaces/mcp-tool.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/mcp-tool.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,iBAAiB,EAAE,GACnB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAKzC,MAAM,MAAM,OAAO,GAAG;IACpB,cAAc,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,GAAG,EAAE;QACH,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;QAC3D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;QAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;KAC3D,CAAC;CACH,CAAC"}

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

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

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

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

package/dist/mcp.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.module.d.ts","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAqB,MAAM,oCAAoC,CAAC;AAMpG,qBACa,SAAS;IACpB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa;IA0ClD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa;IA+B5D,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAqBnC,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAqB1C"}
+{"version":3,"file":"mcp.module.d.ts","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EACL,UAAU,EACV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAM5C,qBACa,SAAS;IACpB,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa;IA+BlD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa;IAoB5D,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAuBnC,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAyB1C"}