@nestjs-mcp/server 0.4.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +77 -0
  2. package/dist/index.d.ts +1 -1
  3. package/dist/index.js +1 -1
  4. package/dist/index.js.map +1 -1
  5. package/dist/interfaces/context.interface.d.ts +10 -5
  6. package/dist/mcp-core.module.js +27 -8
  7. package/dist/mcp-core.module.js.map +1 -1
  8. package/dist/mcp.constants.d.ts +5 -3
  9. package/dist/mcp.constants.js +6 -4
  10. package/dist/mcp.constants.js.map +1 -1
  11. package/dist/mcp.types.d.ts +8 -1
  12. package/dist/services/discovery.service.js.map +1 -1
  13. package/dist/services/logger.service.js +2 -1
  14. package/dist/services/logger.service.js.map +1 -1
  15. package/dist/services/registry.service.js +32 -20
  16. package/dist/services/registry.service.js.map +1 -1
  17. package/dist/services/session.manager.d.ts +5 -1
  18. package/dist/services/session.manager.js +21 -2
  19. package/dist/services/session.manager.js.map +1 -1
  20. package/dist/transports/sse/sse.service.d.ts +14 -3
  21. package/dist/transports/sse/sse.service.js +87 -9
  22. package/dist/transports/sse/sse.service.js.map +1 -1
  23. package/dist/transports/streamable/streamable.service.d.ts +13 -3
  24. package/dist/transports/streamable/streamable.service.js +101 -8
  25. package/dist/transports/streamable/streamable.service.js.map +1 -1
  26. package/dist/tsconfig.build.tsbuildinfo +1 -1
  27. package/dist/types/handler-args.types.d.ts +23 -0
  28. package/dist/types/handler-args.types.js +3 -0
  29. package/dist/types/handler-args.types.js.map +1 -0
  30. package/package.json +31 -34
  31. package/dist/classes/index.d.ts +0 -4
  32. package/dist/classes/index.js +0 -21
  33. package/dist/classes/index.js.map +0 -1
  34. package/dist/classes/prompt.args.d.ts +0 -8
  35. package/dist/classes/prompt.args.js +0 -16
  36. package/dist/classes/prompt.args.js.map +0 -1
  37. package/dist/classes/resource-template.args.d.ts +0 -8
  38. package/dist/classes/resource-template.args.js +0 -18
  39. package/dist/classes/resource-template.args.js.map +0 -1
  40. package/dist/classes/resource-uri.args.d.ts +0 -7
  41. package/dist/classes/resource-uri.args.js +0 -16
  42. package/dist/classes/resource-uri.args.js.map +0 -1
  43. package/dist/classes/tool.args.d.ts +0 -8
  44. package/dist/classes/tool.args.js +0 -16
  45. package/dist/classes/tool.args.js.map +0 -1
@@ -0,0 +1,23 @@
1
+ import type { RequestHandlerExtra } from '../mcp.types';
2
+ export interface ResourceUriHandlerArgs {
3
+ readonly type: 'resource:uri';
4
+ readonly uri: URL;
5
+ readonly extra: RequestHandlerExtra;
6
+ }
7
+ export interface ResourceTemplateHandlerArgs {
8
+ readonly type: 'resource:template';
9
+ readonly uri: URL;
10
+ readonly variables?: Record<string, string>;
11
+ readonly extra: RequestHandlerExtra;
12
+ }
13
+ export interface PromptHandlerArgs {
14
+ readonly type: 'prompt';
15
+ readonly args?: any;
16
+ readonly extra: RequestHandlerExtra;
17
+ }
18
+ export interface ToolHandlerArgs {
19
+ readonly type: 'tool';
20
+ readonly params?: any;
21
+ readonly extra: RequestHandlerExtra;
22
+ }
23
+ export type McpHandlerArgs = ResourceUriHandlerArgs | ResourceTemplateHandlerArgs | PromptHandlerArgs | ToolHandlerArgs;
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=handler-args.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handler-args.types.js","sourceRoot":"","sources":["../../src/types/handler-args.types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,13 +1,13 @@
1
1
  {
2
2
  "name": "@nestjs-mcp/server",
3
- "version": "0.4.0",
3
+ "version": "1.0.1",
4
4
  "description": "Modular library for building scalable MCP servers with NestJS, providing decorators and integration patterns as a wrapper for the official MCP TypeScript SDK.",
5
5
  "author": "Adrián Darío Hidalgo Flores",
6
6
  "license": "MIT",
7
- "packageManager": "pnpm@10.12.1",
7
+ "packageManager": "pnpm@11.5.0",
8
8
  "engines": {
9
9
  "node": ">=24",
10
- "pnpm": ">=10"
10
+ "pnpm": ">=11"
11
11
  },
12
12
  "publishConfig": {
13
13
  "access": "public"
@@ -55,6 +55,7 @@
55
55
  "typecheck": "tsc --noEmit",
56
56
  "quality:check": "pnpm lint:check && pnpm format:check && pnpm typecheck",
57
57
  "quality:fix": "pnpm lint:fix && pnpm format:fix",
58
+ "knip": "knip",
58
59
  "test": "jest",
59
60
  "test:watch": "jest --watch",
60
61
  "test:cov": "jest --coverage",
@@ -62,53 +63,49 @@
62
63
  "test:e2e": "jest --config ./test/jest-e2e.json"
63
64
  },
64
65
  "peerDependencies": {
65
- "@nestjs/common": "^11.1.11",
66
- "@nestjs/core": "^11.1.11",
67
- "@nestjs/platform-express": "^11.1.11",
66
+ "@nestjs/common": "^11.1.18",
67
+ "@nestjs/core": "^11.1.18",
68
+ "@nestjs/platform-express": "^11.1.18",
68
69
  "reflect-metadata": "^0.2.2",
69
- "rxjs": "^7.8.1"
70
+ "rxjs": "^7.8.2"
70
71
  },
71
72
  "dependencies": {
72
- "@modelcontextprotocol/sdk": "^1.25.1",
73
- "zod": "^4.2.1"
73
+ "@modelcontextprotocol/sdk": "^1.29.0",
74
+ "zod": "^4.4.3"
74
75
  },
75
76
  "devDependencies": {
76
- "@commitlint/cli": "^20.2.0",
77
- "@commitlint/config-conventional": "^20.2.0",
78
- "@commitlint/types": "^20.2.0",
79
- "@eslint/eslintrc": "^3.3.3",
80
- "@eslint/js": "^9.39.2",
81
- "@nestjs/cli": "^11.0.14",
82
- "@nestjs/config": "^4.0.2",
83
- "@nestjs/schematics": "^11.0.9",
84
- "@nestjs/testing": "^11.1.11",
77
+ "@commitlint/cli": "^21.0.2",
78
+ "@commitlint/config-conventional": "^21.0.2",
79
+ "@commitlint/types": "^21.0.1",
80
+ "@eslint/js": "^10.0.1",
81
+ "@nestjs/cli": "^11.0.21",
82
+ "@nestjs/config": "^4.0.4",
83
+ "@nestjs/schematics": "^11.1.0",
84
+ "@nestjs/testing": "^11.1.24",
85
85
  "@semantic-release/changelog": "^6.0.3",
86
86
  "@semantic-release/git": "^10.0.1",
87
- "@semantic-release/github": "^12.0.2",
88
- "@swc/cli": "^0.7.9",
89
- "@swc/core": "^1.15.8",
87
+ "@semantic-release/github": "^12.0.8",
88
+ "@swc/cli": "^0.8.1",
89
+ "@swc/core": "^1.15.40",
90
90
  "@swc/jest": "^0.2.39",
91
91
  "@types/express": "^5.0.6",
92
92
  "@types/jest": "^30.0.0",
93
- "@types/node": "^25.0.3",
94
- "@types/supertest": "^6.0.2",
95
- "eslint": "^9.39.2",
93
+ "@types/node": "^25.9.1",
94
+ "eslint": "^10.4.1",
96
95
  "eslint-config-prettier": "^10.1.8",
97
- "eslint-plugin-prettier": "^5.5.4",
98
- "globals": "^16.5.0",
96
+ "eslint-plugin-prettier": "^5.5.6",
97
+ "globals": "^17.6.0",
99
98
  "husky": "^9.1.7",
100
99
  "is-ci": "^4.1.0",
101
- "jest": "^30.2.0",
102
- "lint-staged": "^16.2.7",
103
- "prettier": "^3.7.4",
104
- "semantic-release": "^25.0.2",
105
- "source-map-support": "^0.5.21",
106
- "supertest": "^7.1.4",
107
- "ts-loader": "^9.5.4",
100
+ "jest": "^30.4.2",
101
+ "knip": "^6.15.0",
102
+ "lint-staged": "^17.0.7",
103
+ "prettier": "^3.8.3",
104
+ "semantic-release": "^25.0.3",
108
105
  "ts-node": "^10.9.2",
109
106
  "tsconfig-paths": "^4.2.0",
110
107
  "typescript": "^5.9.3",
111
- "typescript-eslint": "^8.51.0"
108
+ "typescript-eslint": "8.60.0"
112
109
  },
113
110
  "lint-staged": {
114
111
  "{src,test,examples}/**/*.ts": [
@@ -1,4 +0,0 @@
1
- export * from './prompt.args';
2
- export * from './resource-template.args';
3
- export * from './resource-uri.args';
4
- export * from './tool.args';
@@ -1,21 +0,0 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
- };
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- __exportStar(require("./prompt.args"), exports);
18
- __exportStar(require("./resource-template.args"), exports);
19
- __exportStar(require("./resource-uri.args"), exports);
20
- __exportStar(require("./tool.args"), exports);
21
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,2DAAyC;AACzC,sDAAoC;AACpC,8CAA4B"}
@@ -1,8 +0,0 @@
1
- import { ShapeOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
2
- import { PromptArgsRawShape, RequestHandlerExtra } from '../mcp.types';
3
- export declare class PromptHandlerArgs<Args extends PromptArgsRawShape | undefined = undefined> {
4
- readonly args?: Args extends PromptArgsRawShape ? ShapeOutput<Args> : undefined;
5
- readonly extra: RequestHandlerExtra;
6
- private constructor();
7
- static from<Args extends PromptArgsRawShape | undefined>(extra: RequestHandlerExtra, args?: Args extends PromptArgsRawShape ? ShapeOutput<Args> : undefined): PromptHandlerArgs<Args>;
8
- }
@@ -1,16 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.PromptHandlerArgs = void 0;
4
- class PromptHandlerArgs {
5
- args;
6
- extra;
7
- constructor(extra, args) {
8
- this.extra = extra;
9
- this.args = args;
10
- }
11
- static from(extra, args) {
12
- return new PromptHandlerArgs(extra, args);
13
- }
14
- }
15
- exports.PromptHandlerArgs = PromptHandlerArgs;
16
- //# sourceMappingURL=prompt.args.js.map
@@ -1 +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,IAAsE;QAEtE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAA0B,EAC1B,IAAsE;QAEtE,OAAO,IAAI,iBAAiB,CAAO,KAAK,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;CACF;AAtBD,8CAsBC"}
@@ -1,8 +0,0 @@
1
- import { RequestHandlerExtra } from '../mcp.types';
2
- export declare class ResourceTemplateHandlerArgs {
3
- readonly uri: URL;
4
- readonly variables?: Record<string, string>;
5
- readonly extra: RequestHandlerExtra;
6
- private constructor();
7
- static from(uri: URL, extra: RequestHandlerExtra, variables?: Record<string, string>): ResourceTemplateHandlerArgs;
8
- }
@@ -1,18 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ResourceTemplateHandlerArgs = void 0;
4
- class ResourceTemplateHandlerArgs {
5
- uri;
6
- variables;
7
- extra;
8
- constructor(uri, extra, variables) {
9
- this.uri = uri;
10
- this.extra = extra;
11
- this.variables = variables;
12
- }
13
- static from(uri, extra, variables) {
14
- return new ResourceTemplateHandlerArgs(uri, extra, variables);
15
- }
16
- }
17
- exports.ResourceTemplateHandlerArgs = ResourceTemplateHandlerArgs;
18
- //# sourceMappingURL=resource-template.args.js.map
@@ -1 +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"}
@@ -1,7 +0,0 @@
1
- import { RequestHandlerExtra } from '../mcp.types';
2
- export declare class ResourceUriHandlerArgs {
3
- readonly uri: URL;
4
- readonly extra: RequestHandlerExtra;
5
- private constructor();
6
- static from(uri: URL, extra: RequestHandlerExtra): ResourceUriHandlerArgs;
7
- }
@@ -1,16 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ResourceUriHandlerArgs = void 0;
4
- class ResourceUriHandlerArgs {
5
- uri;
6
- extra;
7
- constructor(uri, extra) {
8
- this.uri = uri;
9
- this.extra = extra;
10
- }
11
- static from(uri, extra) {
12
- return new ResourceUriHandlerArgs(uri, extra);
13
- }
14
- }
15
- exports.ResourceUriHandlerArgs = ResourceUriHandlerArgs;
16
- //# sourceMappingURL=resource-uri.args.js.map
@@ -1 +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"}
@@ -1,8 +0,0 @@
1
- import { ShapeOutput, ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
2
- import { RequestHandlerExtra } from '../mcp.types';
3
- export declare class ToolHandlerArgs<Args extends ZodRawShapeCompat | undefined = undefined> {
4
- readonly args?: Args extends ZodRawShapeCompat ? ShapeOutput<Args> : undefined;
5
- readonly extra: RequestHandlerExtra;
6
- private constructor();
7
- static from<Args extends ZodRawShapeCompat | undefined>(extra: RequestHandlerExtra, args?: Args extends ZodRawShapeCompat ? ShapeOutput<Args> : undefined): ToolHandlerArgs<Args>;
8
- }
@@ -1,16 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ToolHandlerArgs = void 0;
4
- class ToolHandlerArgs {
5
- args;
6
- extra;
7
- constructor(extra, args) {
8
- this.extra = extra;
9
- this.args = args;
10
- }
11
- static from(extra, args) {
12
- return new ToolHandlerArgs(extra, args);
13
- }
14
- }
15
- exports.ToolHandlerArgs = ToolHandlerArgs;
16
- //# sourceMappingURL=tool.args.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"tool.args.js","sourceRoot":"","sources":["../../src/classes/tool.args.ts"],"names":[],"mappings":";;;AAOA,MAAa,eAAe;IAGV,IAAI,CAEN;IACE,KAAK,CAAsB;IAE3C,YACE,KAA0B,EAC1B,IAAqE;QAErE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,IAAI,CACT,KAA0B,EAC1B,IAAqE;QAErE,OAAO,IAAI,eAAe,CAAO,KAAK,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAtBD,0CAsBC"}