@nestjs-mcp/server 0.2.0 → 0.3.0-rc.2

package/README.md

@@ -199,6 +199,12 @@ export class AppModule {}
 
 Registers the MCP Server globally using asynchronous options, useful for integrating with configuration modules like `@nestjs/config`.
 
+> **Note:**
+>
+> - The `imports` array should include any modules that provide dependencies required by your `useFactory` (e.g., `ConfigModule` if you inject `ConfigService`).
+> - Use `forRootAsync` only once in your root module (`AppModule`).
+> - See `McpModuleAsyncOptions` for all available options.
+
 **Parameters:**
 
 - `options: McpModuleAsyncOptions` — Asynchronous configuration object:
@@ -470,34 +476,66 @@ Decorate methods within a Resolver class to expose them as MCP Tools. Accepts op
 
 ```ts
 import { Tool, Resolver } from '@nestjs-mcp/server';
-import { RequestHandlerExtra } from '@nestjs-mcp/server'; // Import type for extra info
-import { z } from 'zod'; // Example using Zod for schema
-
-// Example Zod schema for parameters
-const SumParams = z.object({
-  num1: z.number(),
-  num2: z.number(),
-});
+import { RequestHandlerExtra } from '@nestjs-mcp/server';
+import { z } from 'zod';
+import { CallToolResult } from '@modelcontextprotocol/sdk/types';
 
-@Resolver('utils') // Must be in a Resolver class
-export class MyTools {
+@Resolver('user_tools')
+export class UserToolsResolver {
   @Tool({
-    name: 'calculate_sum',
-    description: 'Calculates the sum of two numbers.',
-    paramSchema: SumParams, // Use the Zod schema
+    name: 'delete_user',
+    description: 'Deletes a user by ID',
+    paramsSchema: { userId: z.string() },
+    annotations: { destructiveHint: true, readOnlyHint: false },
   })
-  sumTool(
-    params: z.infer<typeof SumParams>, // First arg is typed parameters from schema
-    extra: RequestHandlerExtra, // Contains sessionId and other metadata
-  ) {
-    console.log(`Calculating sum for session: ${extra.sessionId}`);
-    const result = params.num1 + params.num2;
-    /* ... return CallToolResult ... */
-    return { content: [{ type: 'text', text: `Result: ${result}` }] };
+  deleteUser(
+    { userId }: { userId: string },
+    extra: RequestHandlerExtra,
+  ): CallToolResult {
+    // ...logic...
+    return { content: [{ type: 'text', text: `User ${userId} deleted.` }] };
   }
 }
 ```
 
+#### Tool Annotations
+
+The `annotations` field allows you to provide protocol-level hints about the tool's behavior, such as whether it is destructive, read-only, idempotent, or has other special properties. These hints can be used by clients, UIs, or the protocol itself to display warnings, optimize calls, or enforce policies.
+
+**Common annotation keys:**
+
+- `destructiveHint` (boolean): Indicates the tool performs a destructive action (e.g., deletes data).
+- `readOnlyHint` (boolean): Indicates the tool does not modify any data.
+- `idempotentHint` (boolean): Indicates the tool can be safely called multiple times with the same effect.
+- `openWorldHint` (boolean): Indicates the tool may have side effects outside the current system.
+
+**Example:**
+
+```ts
+@Tool({
+  name: 'reset_password',
+  paramsSchema: { userId: z.string() },
+  annotations: { destructiveHint: true, idempotentHint: false }
+})
+resetPassword({ userId }: { userId: string }): CallToolResult {
+  // ...
+}
+```
+
+#### ToolOptions Variants
+
+| Variant                                          | Required Fields                              |
+| ------------------------------------------------ | -------------------------------------------- |
+| ToolBaseOptions                                  | name                                         |
+| ToolWithDescriptionOptions                       | name, description                            |
+| ToolWithParamOrAnnotationsOptions                | name, paramsSchemaOrAnnotations              |
+| ToolWithParamOrAnnotationsAndDescriptionOptions  | name, paramsSchemaOrAnnotations, description |
+| ToolWithParamAndAnnotationsOptions               | name, paramsSchema, annotations              |
+| ToolWithParamAndAnnotationsAndDescriptionOptions | name, paramsSchema, annotations, description |
+
+- `paramsSchema` and `paramsSchemaOrAnnotations` can be a Zod schema for input validation.
+- `annotations` is an object with protocol-level hints as described above.
+
 ### RequestHandlerExtra Argument
 
 All MCP capability methods (`@Prompt`, `@Resource`, `@Tool`) always receive a `RequestHandlerExtra` object as their last parameter. This object extends the original type from `@modelcontextprotocol/sdk` and provides essential context about the current MCP request.

package/dist/classes/index.d.ts

@@ -0,0 +1,4 @@
+export * from './prompt.args';
+export * from './resource-template.args';
+export * from './resource-uri.args';
+export * from './tool.args';

package/dist/{registry → classes}/index.js

@@ -14,6 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./discovery.service"), exports);
-__exportStar(require("./registry.service"), exports);
+__exportStar(require("./prompt.args"), exports);
+__exportStar(require("./resource-template.args"), exports);
+__exportStar(require("./resource-uri.args"), exports);
+__exportStar(require("./tool.args"), exports);
 //# sourceMappingURL=index.js.map

package/dist/classes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,2DAAyC;AACzC,sDAAoC;AACpC,8CAA4B"}

package/dist/classes/prompt.args.d.ts

@@ -0,0 +1,8 @@
+import { z, ZodTypeAny } from 'zod';
+import { PromptArgsRawShape, RequestHandlerExtra } from '../mcp.types';
+export declare class PromptHandlerArgs<Args extends PromptArgsRawShape | undefined = undefined> {
+    readonly args?: Args extends PromptArgsRawShape ? z.objectOutputType<Args, ZodTypeAny> : undefined;
+    readonly extra: RequestHandlerExtra;
+    private constructor();
+    static from<Args extends PromptArgsRawShape | undefined>(extra: RequestHandlerExtra, args?: Args extends PromptArgsRawShape ? z.objectOutputType<Args, ZodTypeAny> : undefined): PromptHandlerArgs<Args>;
+}

package/dist/classes/prompt.args.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptHandlerArgs = void 0;
+class PromptHandlerArgs {
+    args;
+    extra;
+    constructor(extra, args) {
+        this.extra = extra;
+        this.args = args;
+    }
+    static from(extra, args) {
+        return new PromptHandlerArgs(extra, args);
+    }
+}
+exports.PromptHandlerArgs = PromptHandlerArgs;
+//# sourceMappingURL=prompt.args.js.map

package/dist/classes/prompt.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.args.js","sourceRoot":"","sources":["../../src/classes/prompt.args.ts"],"names":[],"mappings":";;;AAIA,MAAa,iBAAiB;IAGZ,IAAI,CAEN;IACE,KAAK,CAAsB;IAE3C,YACE,KAA0B,EAC1B,IAEa;QAEb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAA0B,EAC1B,IAEa;QAEb,OAAO,IAAI,iBAAiB,CAAO,KAAK,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;CACF;AA1BD,8CA0BC"}

package/dist/classes/resource-template.args.d.ts

@@ -0,0 +1,8 @@
+import { RequestHandlerExtra } from '../mcp.types';
+export declare class ResourceTemplateHandlerArgs {
+    readonly uri: URL;
+    readonly variables?: Record<string, string>;
+    readonly extra: RequestHandlerExtra;
+    private constructor();
+    static from(uri: URL, extra: RequestHandlerExtra, variables?: Record<string, string>): ResourceTemplateHandlerArgs;
+}

package/dist/classes/resource-template.args.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceTemplateHandlerArgs = void 0;
+class ResourceTemplateHandlerArgs {
+    uri;
+    variables;
+    extra;
+    constructor(uri, extra, variables) {
+        this.uri = uri;
+        this.extra = extra;
+        this.variables = variables;
+    }
+    static from(uri, extra, variables) {
+        return new ResourceTemplateHandlerArgs(uri, extra, variables);
+    }
+}
+exports.ResourceTemplateHandlerArgs = ResourceTemplateHandlerArgs;
+//# sourceMappingURL=resource-template.args.js.map

package/dist/classes/resource-template.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-template.args.js","sourceRoot":"","sources":["../../src/classes/resource-template.args.ts"],"names":[],"mappings":";;;AAEA,MAAa,2BAA2B;IACtB,GAAG,CAAM;IACT,SAAS,CAA0B;IACnC,KAAK,CAAsB;IAE3C,YACE,GAAQ,EACR,KAA0B,EAC1B,SAAkC;QAElC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,IAAI,CACT,GAAQ,EACR,KAA0B,EAC1B,SAAkC;QAElC,OAAO,IAAI,2BAA2B,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAtBD,kEAsBC"}

package/dist/classes/resource-uri.args.d.ts

@@ -0,0 +1,7 @@
+import { RequestHandlerExtra } from '../mcp.types';
+export declare class ResourceUriHandlerArgs {
+    readonly uri: URL;
+    readonly extra: RequestHandlerExtra;
+    private constructor();
+    static from(uri: URL, extra: RequestHandlerExtra): ResourceUriHandlerArgs;
+}

package/dist/classes/resource-uri.args.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceUriHandlerArgs = void 0;
+class ResourceUriHandlerArgs {
+    uri;
+    extra;
+    constructor(uri, extra) {
+        this.uri = uri;
+        this.extra = extra;
+    }
+    static from(uri, extra) {
+        return new ResourceUriHandlerArgs(uri, extra);
+    }
+}
+exports.ResourceUriHandlerArgs = ResourceUriHandlerArgs;
+//# sourceMappingURL=resource-uri.args.js.map

package/dist/classes/resource-uri.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-uri.args.js","sourceRoot":"","sources":["../../src/classes/resource-uri.args.ts"],"names":[],"mappings":";;;AAEA,MAAa,sBAAsB;IACjB,GAAG,CAAM;IACT,KAAK,CAAsB;IAE3C,YAAoB,GAAQ,EAAE,KAA0B;QACtD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAQ,EAAE,KAA0B;QAC9C,OAAO,IAAI,sBAAsB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;CACF;AAZD,wDAYC"}

package/dist/classes/tool.args.d.ts

@@ -0,0 +1,8 @@
+import { z, ZodRawShape, ZodTypeAny } from 'zod';
+import { RequestHandlerExtra } from '../mcp.types';
+export declare class ToolHandlerArgs<Args extends ZodRawShape | undefined = undefined> {
+    readonly args?: Args extends ZodRawShape ? z.objectOutputType<Args, ZodTypeAny> : undefined;
+    readonly extra: RequestHandlerExtra;
+    private constructor();
+    static from<Args extends ZodRawShape | undefined>(extra: RequestHandlerExtra, args?: Args extends ZodRawShape ? z.objectOutputType<Args, ZodTypeAny> : undefined): ToolHandlerArgs<Args>;
+}

package/dist/classes/tool.args.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolHandlerArgs = void 0;
+class ToolHandlerArgs {
+    args;
+    extra;
+    constructor(extra, args) {
+        this.extra = extra;
+        this.args = args;
+    }
+    static from(extra, args) {
+        return new ToolHandlerArgs(extra, args);
+    }
+}
+exports.ToolHandlerArgs = ToolHandlerArgs;
+//# sourceMappingURL=tool.args.js.map

package/dist/classes/tool.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.args.js","sourceRoot":"","sources":["../../src/classes/tool.args.ts"],"names":[],"mappings":";;;AAIA,MAAa,eAAe;IACV,IAAI,CAEN;IACE,KAAK,CAAsB;IAE3C,YACE,KAA0B,EAC1B,IAEa;QAEb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAA0B,EAC1B,IAEa;QAEb,OAAO,IAAI,eAAe,CAAO,KAAK,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAxBD,0CAwBC"}

package/dist/decorators/index.d.ts

@@ -1,2 +1,5 @@
-export * from './capabilities.constants';
-export * from './capabilities.decorators';
+export * from './prompt.decorator';
+export * from './resolver.decorator';
+export * from './resource.decorator';
+export * from './tool.decorator';
+export * from './user-guard.decorator';

package/dist/decorators/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./capabilities.constants"), exports);
-__exportStar(require("./capabilities.decorators"), exports);
+__exportStar(require("./prompt.decorator"), exports);
+__exportStar(require("./resolver.decorator"), exports);
+__exportStar(require("./resource.decorator"), exports);
+__exportStar(require("./tool.decorator"), exports);
+__exportStar(require("./user-guard.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,2DAAyC;AACzC,4DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,uDAAqC;AACrC,uDAAqC;AACrC,mDAAiC;AACjC,yDAAuC"}

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

@@ -0,0 +1,15 @@
+import { PromptArgsRawShape } from '../mcp.types';
+export interface PromptBaseOptions {
+    name: string;
+}
+export interface PromptWithDescriptionOptions extends PromptBaseOptions {
+    description: string;
+}
+export interface PromptWithArgsSchemaOptions extends PromptBaseOptions {
+    argsSchema: PromptArgsRawShape;
+}
+export interface PromptWithDescriptionAndArgsSchemaOptions extends PromptWithDescriptionOptions, PromptWithArgsSchemaOptions {
+}
+export type PromptOptions = PromptBaseOptions | PromptWithDescriptionOptions | PromptWithArgsSchemaOptions | PromptWithDescriptionAndArgsSchemaOptions;
+export declare const MCP_PROMPT = "__mcp_prompt__";
+export declare function Prompt(options: PromptOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/prompt.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_PROMPT = void 0;
+exports.Prompt = Prompt;
+const common_1 = require("@nestjs/common");
+exports.MCP_PROMPT = '__mcp_prompt__';
+function Prompt(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_PROMPT, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=prompt.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.decorator.js","sourceRoot":"","sources":["../../src/decorators/prompt.decorator.ts"],"names":[],"mappings":";;;AAgDA,wBAaC;AA7DD,2CAA6C;AA2BhC,QAAA,UAAU,GAAG,gBAAgB,CAAC;AAqB3C,SAAgB,MAAM,CAAC,OAAsB;IAC3C,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,kBAAU,EAAE;YACtB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAEpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const MCP_RESOLVER = "__mcp_resolver__";
+export declare function Resolver(workspace?: string): ClassDecorator;

package/dist/decorators/resolver.decorator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_RESOLVER = void 0;
+exports.Resolver = Resolver;
+const common_1 = require("@nestjs/common");
+const common_2 = require("@nestjs/common");
+exports.MCP_RESOLVER = '__mcp_resolver__';
+function Resolver(workspace) {
+    return function (target) {
+        (0, common_1.Injectable)()(target);
+        (0, common_2.SetMetadata)(exports.MCP_RESOLVER, workspace || true)(target);
+    };
+}
+//# sourceMappingURL=resolver.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.decorator.js","sourceRoot":"","sources":["../../src/decorators/resolver.decorator.ts"],"names":[],"mappings":";;;AAkBA,4BAKC;AAvBD,2CAA4C;AAE5C,2CAA6C;AAKhC,QAAA,YAAY,GAAG,kBAAkB,CAAC;AAW/C,SAAgB,QAAQ,CAAC,SAAkB;IACzC,OAAO,UAAU,MAAW;QAC1B,IAAA,mBAAU,GAAE,CAAC,MAAM,CAAC,CAAC;QACrB,IAAA,oBAAW,EAAC,oBAAY,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+export interface ResourceBaseOptions {
+    name: string;
+}
+export interface ResourceUriOptions extends ResourceBaseOptions {
+    uri: string;
+}
+export interface ResourceUriWithMetadataOptions extends ResourceUriOptions {
+    metadata: Record<string, any>;
+}
+export interface ResourceTemplateOptions extends ResourceBaseOptions {
+    template: string;
+}
+export interface ResourceTemplateWithMetadataOptions extends ResourceTemplateOptions {
+    metadata: Record<string, any>;
+}
+export type ResourceOptions = ResourceUriOptions | ResourceUriWithMetadataOptions | ResourceTemplateOptions | ResourceTemplateWithMetadataOptions;
+export declare const MCP_RESOURCE = "__mcp_resource__";
+export declare function Resource(options: ResourceOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/resource.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_RESOURCE = void 0;
+exports.Resource = Resource;
+const common_1 = require("@nestjs/common");
+exports.MCP_RESOURCE = '__mcp_resource__';
+function Resource(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_RESOURCE, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# 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":";;;AAsDA,4BAYC;AAlED,2CAA6C;AA6BhC,QAAA,YAAY,GAAG,kBAAkB,CAAC;AAyB/C,SAAgB,QAAQ,CAAC,OAAwB;IAC/C,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,oBAAY,EAAE;YACxB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QACpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,24 @@
+import { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
+import { ZodRawShape } from 'zod';
+export interface ToolBaseOptions {
+    name: string;
+}
+export interface ToolWithDescriptionOptions extends ToolBaseOptions {
+    description: string;
+}
+export interface ToolWithParamOrAnnotationsOptions extends ToolBaseOptions {
+    paramsSchemaOrAnnotations: ZodRawShape | ToolAnnotations;
+}
+export interface ToolWithParamOrAnnotationsAndDescriptionOptions extends ToolWithParamOrAnnotationsOptions {
+    description: string;
+}
+export interface ToolWithParamAndAnnotationsOptions extends ToolBaseOptions {
+    paramsSchema: ZodRawShape;
+    annotations: ToolAnnotations;
+}
+export interface ToolWithParamAndAnnotationsAndDescriptionOptions extends ToolWithParamAndAnnotationsOptions {
+    description: string;
+}
+export type ToolOptions = ToolBaseOptions | ToolWithDescriptionOptions | ToolWithParamOrAnnotationsOptions | ToolWithParamOrAnnotationsAndDescriptionOptions | ToolWithParamAndAnnotationsOptions | ToolWithParamAndAnnotationsAndDescriptionOptions;
+export declare const MCP_TOOL = "__mcp_tool__";
+export declare function Tool(options: ToolOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/tool.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_TOOL = void 0;
+exports.Tool = Tool;
+const common_1 = require("@nestjs/common");
+exports.MCP_TOOL = '__mcp_tool__';
+function Tool(options) {
+    return function (target, propertyKey, descriptor) {
+        (0, common_1.SetMetadata)(exports.MCP_TOOL, {
+            ...options,
+            methodName: propertyKey,
+        })(target, propertyKey, descriptor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=tool.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/tool.decorator.ts"],"names":[],"mappings":";;;AAyDA,oBAaC;AArED,2CAA6C;AAsChC,QAAA,QAAQ,GAAG,cAAc,CAAC;AAkBvC,SAAgB,IAAI,CAAC,OAAoB;IACvC,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,IAAA,oBAAW,EAAC,gBAAQ,EAAE;YACpB,GAAG,OAAO;YACV,UAAU,EAAE,WAAW;SACxB,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAEpC,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/user-guard.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const MCP_GUARDS = "__mcp_guards__";
+export declare function UseGuards(...guards: any[]): ClassDecorator & MethodDecorator;

package/dist/decorators/user-guard.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_GUARDS = void 0;
+exports.UseGuards = UseGuards;
+const common_1 = require("@nestjs/common");
+exports.MCP_GUARDS = '__mcp_guards__';
+function UseGuards(...guards) {
+    return (0, common_1.SetMetadata)(exports.MCP_GUARDS, guards);
+}
+//# sourceMappingURL=user-guard.decorator.js.map

package/dist/decorators/user-guard.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-guard.decorator.js","sourceRoot":"","sources":["../../src/decorators/user-guard.decorator.ts"],"names":[],"mappings":";;;AAiBA,8BAEC;AAnBD,2CAA6C;AAKhC,QAAA,UAAU,GAAG,gBAAgB,CAAC;AAY3C,SAAgB,SAAS,CAAC,GAAG,MAAa;IACxC,OAAO,IAAA,oBAAW,EAAC,kBAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './mcp.module';
+export * from './mcp.types';
 export * from './interfaces';
-export * from './registry';
+export * from './classes';
 export * from './services';
 export * from './decorators';

package/dist/index.js

@@ -15,8 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./mcp.module"), exports);
+__exportStar(require("./mcp.types"), exports);
 __exportStar(require("./interfaces"), exports);
-__exportStar(require("./registry"), exports);
+__exportStar(require("./classes"), exports);
 __exportStar(require("./services"), exports);
 __exportStar(require("./decorators"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,+CAA6B;AAG7B,+CAA6B;AAG7B,6CAA2B;AAG3B,6CAA2B;AAG3B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,+CAA6B;AAC7B,8CAA4B;AAG5B,+CAA6B;AAG7B,4CAA0B;AAG1B,6CAA2B;AAG3B,+CAA6B"}

package/dist/interfaces/context.interface.d.ts

@@ -1,6 +1,6 @@
 import { ExecutionContext } from '@nestjs/common';
-import { PromptHandlerParams, ResourceTemplateHandlerParams, ResourceUriHandlerParams, ToolHandlerParams } from './capabilities.interface';
+import { PromptHandlerArgs, ResourceTemplateHandlerArgs, ResourceUriHandlerArgs, ToolHandlerArgs } from '../classes';
 export interface McpExecutionContext extends ExecutionContext {
-    args: ResourceUriHandlerParams | ResourceTemplateHandlerParams | PromptHandlerParams | ToolHandlerParams;
+    args: ResourceUriHandlerArgs | ResourceTemplateHandlerArgs | PromptHandlerArgs | ToolHandlerArgs;
     getSessionId: () => string;
 }

package/dist/interfaces/index.d.ts

@@ -1,3 +1 @@
-export * from './capabilities.interface';
 export * from './context.interface';
-export * from './mcp-server-options.interface';

package/dist/interfaces/index.js

@@ -14,7 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./capabilities.interface"), exports);
 __exportStar(require("./context.interface"), exports);
-__exportStar(require("./mcp-server-options.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,2DAAyC;AACzC,sDAAoC;AACpC,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

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

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { McpFeatureOptions, McpModuleAsyncOptions, McpModuleOptions } from './mcp.types';
+export declare class McpCoreModule {
+    private static getActiveTransportControllersAndProviders;
+    private static buildServerConfig;
+    private static createAsyncOptionsProvider;
+    private static createAsyncProviders;
+    static forRoot(options: McpModuleOptions): DynamicModule;
+    static forRootAsync(options: McpModuleAsyncOptions): DynamicModule;
+    static forFeature(_options?: McpFeatureOptions): DynamicModule;
+}