@rekog/mcp-nest 1.2.0 → 1.3.0

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 (64) hide show
  1. package/.github/workflows/pipeline.yml +26 -0
  2. package/.prettierrc +4 -0
  3. package/README.md +51 -190
  4. package/dist/controllers/sse.controller.factory.d.ts +4 -6
  5. package/dist/controllers/sse.controller.factory.d.ts.map +1 -1
  6. package/dist/controllers/sse.controller.factory.js +13 -6
  7. package/dist/controllers/sse.controller.factory.js.map +1 -1
  8. package/dist/decorators/constants.d.ts +1 -0
  9. package/dist/decorators/constants.d.ts.map +1 -1
  10. package/dist/decorators/constants.js +2 -1
  11. package/dist/decorators/constants.js.map +1 -1
  12. package/dist/decorators/index.d.ts +1 -0
  13. package/dist/decorators/index.d.ts.map +1 -1
  14. package/dist/decorators/index.js +1 -0
  15. package/dist/decorators/index.js.map +1 -1
  16. package/dist/decorators/resource.decorator.d.ts +9 -0
  17. package/dist/decorators/resource.decorator.d.ts.map +1 -0
  18. package/dist/decorators/resource.decorator.js +10 -0
  19. package/dist/decorators/resource.decorator.js.map +1 -0
  20. package/dist/decorators/tool.decorator.d.ts +4 -3
  21. package/dist/decorators/tool.decorator.d.ts.map +1 -1
  22. package/dist/decorators/tool.decorator.js +2 -6
  23. package/dist/decorators/tool.decorator.js.map +1 -1
  24. package/dist/index.d.ts +2 -2
  25. package/dist/index.d.ts.map +1 -1
  26. package/dist/index.js +2 -2
  27. package/dist/index.js.map +1 -1
  28. package/dist/interfaces/index.d.ts +1 -0
  29. package/dist/interfaces/index.d.ts.map +1 -1
  30. package/dist/interfaces/index.js +1 -0
  31. package/dist/interfaces/index.js.map +1 -1
  32. package/dist/interfaces/mcp-tool.interface.d.ts +15 -0
  33. package/dist/interfaces/mcp-tool.interface.d.ts.map +1 -0
  34. package/dist/interfaces/mcp-tool.interface.js +3 -0
  35. package/dist/interfaces/mcp-tool.interface.js.map +1 -0
  36. package/dist/mcp.module.d.ts.map +1 -1
  37. package/dist/mcp.module.js +8 -25
  38. package/dist/mcp.module.js.map +1 -1
  39. package/dist/services/mcp-executor.service.d.ts +15 -0
  40. package/dist/services/mcp-executor.service.d.ts.map +1 -0
  41. package/dist/services/mcp-executor.service.js +172 -0
  42. package/dist/services/mcp-executor.service.js.map +1 -0
  43. package/dist/services/mcp-registry.service.d.ts +31 -0
  44. package/dist/services/mcp-registry.service.d.ts.map +1 -0
  45. package/dist/services/mcp-registry.service.js +119 -0
  46. package/dist/services/mcp-registry.service.js.map +1 -0
  47. package/dist/services/mcp-registry.service.spec.d.ts +2 -0
  48. package/dist/services/mcp-registry.service.spec.d.ts.map +1 -0
  49. package/dist/services/mcp-registry.service.spec.js +61 -0
  50. package/dist/services/mcp-registry.service.spec.js.map +1 -0
  51. package/eslint.config.mjs +38 -0
  52. package/image.png +0 -0
  53. package/package.json +22 -5
  54. package/playground/README.md +17 -0
  55. package/playground/greeting.resource.ts +25 -0
  56. package/playground/greeting.tool.ts +36 -0
  57. package/playground/server.ts +25 -0
  58. package/tests/mcp-resource.e2e.spec.ts +179 -0
  59. package/tests/{mcp-auth.e2e.spec.ts → mcp-tool-auth.e2e.spec.ts} +72 -83
  60. package/tests/mcp-tool.e2e.spec.ts +235 -0
  61. package/tests/utils.ts +42 -0
  62. package/tsconfig.build.json +11 -0
  63. package/tsconfig.build.tsbuildinfo +1 -0
  64. package/tests/mcp.e2e.spec.ts +0 -115
@@ -10,10 +10,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
10
10
  exports.McpModule = void 0;
11
11
  const common_1 = require("@nestjs/common");
12
12
  const core_1 = require("@nestjs/core");
13
- const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
14
13
  const sse_controller_factory_1 = require("./controllers/sse.controller.factory");
15
- const mcp_tool_registry_service_1 = require("./services/mcp-tool-registry.service");
16
- const mcp_tools_executor_service_1 = require("./services/mcp-tools-executor.service");
14
+ const mcp_registry_service_1 = require("./services/mcp-registry.service");
15
+ const mcp_executor_service_1 = require("./services/mcp-executor.service");
17
16
  let McpModule = McpModule_1 = class McpModule {
18
17
  static forRoot(options) {
19
18
  const sseEndpoint = options.sseEndpoint ?? 'sse';
@@ -30,18 +29,10 @@ let McpModule = McpModule_1 = class McpModule {
30
29
  provide: 'MCP_OPTIONS',
31
30
  useValue: options,
32
31
  },
33
- {
34
- provide: 'MCP_SERVER',
35
- useFactory: (mcpOptions) => {
36
- const server = new mcp_js_1.McpServer({ name: mcpOptions.name, version: mcpOptions.version }, { capabilities: mcpOptions.capabilities || { tools: {} } });
37
- return server;
38
- },
39
- inject: ['MCP_OPTIONS'],
40
- },
41
- mcp_tool_registry_service_1.McpToolRegistryService,
42
- mcp_tools_executor_service_1.McpToolsExecutorService
32
+ mcp_registry_service_1.McpRegistryService,
33
+ mcp_executor_service_1.McpExecutorService,
43
34
  ],
44
- exports: ['MCP_SERVER', mcp_tool_registry_service_1.McpToolRegistryService, mcp_tools_executor_service_1.McpToolsExecutorService],
35
+ exports: [mcp_registry_service_1.McpRegistryService, mcp_executor_service_1.McpExecutorService],
45
36
  };
46
37
  }
47
38
  static forRootAsync(options) {
@@ -52,18 +43,10 @@ let McpModule = McpModule_1 = class McpModule {
52
43
  controllers: [],
53
44
  providers: [
54
45
  ...providers,
55
- {
56
- provide: 'MCP_SERVER',
57
- useFactory: (mcpOptions) => {
58
- const server = new mcp_js_1.McpServer({ name: mcpOptions.name, version: mcpOptions.version }, { capabilities: mcpOptions.capabilities || { tools: {} } });
59
- return server;
60
- },
61
- inject: ['MCP_OPTIONS'],
62
- },
63
- mcp_tool_registry_service_1.McpToolRegistryService,
64
- mcp_tools_executor_service_1.McpToolsExecutorService
46
+ mcp_registry_service_1.McpRegistryService,
47
+ mcp_executor_service_1.McpExecutorService,
65
48
  ],
66
- exports: ['MCP_SERVER', mcp_tool_registry_service_1.McpToolRegistryService, mcp_tools_executor_service_1.McpToolsExecutorService],
49
+ exports: [mcp_registry_service_1.McpRegistryService, mcp_executor_service_1.McpExecutorService],
67
50
  };
68
51
  }
69
52
  static createAsyncProviders(options) {
@@ -1 +1 @@
1
- {"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mcp.module.js","sourceRoot":"","sources":["../src/mcp.module.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { ModuleRef } from '@nestjs/core';
3
+ import { Request } from 'express';
4
+ import { McpRegistryService } from './mcp-registry.service';
5
+ export declare class McpExecutorService {
6
+ private readonly moduleRef;
7
+ private readonly registry;
8
+ private logger;
9
+ constructor(moduleRef: ModuleRef, registry: McpRegistryService);
10
+ registerRequestHandlers(mcpServer: McpServer, httpRequest: Request): void;
11
+ private registerResources;
12
+ private registerTools;
13
+ private createContext;
14
+ }
15
+ //# sourceMappingURL=mcp-executor.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-executor.service.d.ts","sourceRoot":"","sources":["../../src/services/mcp-executor.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAoB,SAAS,EAAE,MAAM,cAAc,CAAC;AAY3D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM5D,qBACa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,MAAM,CAAuC;gBAIlC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,kBAAkB;IAQ/C,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO;IAKlE,OAAO,CAAC,iBAAiB;IAiFzB,OAAO,CAAC,aAAa;IAgGrB,OAAO,CAAC,aAAa;CA+CtB"}
@@ -0,0 +1,172 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var McpExecutorService_1;
12
+ Object.defineProperty(exports, "__esModule", { value: true });
13
+ exports.McpExecutorService = void 0;
14
+ const common_1 = require("@nestjs/common");
15
+ const core_1 = require("@nestjs/core");
16
+ const zod_1 = require("zod");
17
+ const zod_to_json_schema_1 = require("zod-to-json-schema");
18
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
19
+ const mcp_registry_service_1 = require("./mcp-registry.service");
20
+ let McpExecutorService = McpExecutorService_1 = class McpExecutorService {
21
+ constructor(moduleRef, registry) {
22
+ this.moduleRef = moduleRef;
23
+ this.registry = registry;
24
+ this.logger = new common_1.Logger(McpExecutorService_1.name);
25
+ }
26
+ registerRequestHandlers(mcpServer, httpRequest) {
27
+ this.registerTools(mcpServer, httpRequest);
28
+ this.registerResources(mcpServer, httpRequest);
29
+ }
30
+ registerResources(mcpServer, httpRequest) {
31
+ mcpServer.server.setRequestHandler(types_js_1.ListResourcesRequestSchema, () => {
32
+ this.logger.debug('ListResourcesRequestSchema is being called');
33
+ const data = {
34
+ resources: this.registry
35
+ .getResources()
36
+ .map((resources) => resources.metadata),
37
+ };
38
+ return data;
39
+ });
40
+ mcpServer.server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
41
+ this.logger.debug('ReadResourceRequestSchema is being called');
42
+ const uri = request.params.uri;
43
+ const resourceInfo = this.registry.findResourceByUri(uri);
44
+ if (!resourceInfo) {
45
+ throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown resource: ${uri}`);
46
+ }
47
+ try {
48
+ const contextId = core_1.ContextIdFactory.getByRequest(httpRequest);
49
+ this.moduleRef.registerRequestByContextId(httpRequest, contextId);
50
+ const resourceInstance = await this.moduleRef.resolve(resourceInfo.resource.providerClass, contextId, { strict: false });
51
+ if (!resourceInstance) {
52
+ throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown resource: ${uri}`);
53
+ }
54
+ const context = this.createContext(mcpServer, request);
55
+ const requestParams = {
56
+ ...resourceInfo.params,
57
+ ...request.params,
58
+ };
59
+ const methodName = resourceInfo.resource.methodName;
60
+ const result = await resourceInstance[methodName].call(resourceInstance, requestParams, context, httpRequest);
61
+ this.logger.debug(result, 'ReadResourceRequestSchema result');
62
+ return result;
63
+ }
64
+ catch (error) {
65
+ this.logger.error(error);
66
+ return {
67
+ contents: [{ uri, mimeType: 'text/plain', text: error.message }],
68
+ isError: true,
69
+ };
70
+ }
71
+ });
72
+ }
73
+ registerTools(mcpServer, httpRequest) {
74
+ mcpServer.server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => {
75
+ const tools = this.registry.getTools().map((tool) => ({
76
+ name: tool.metadata.name,
77
+ description: tool.metadata.description,
78
+ inputSchema: tool.metadata.parameters
79
+ ?
80
+ (0, zod_to_json_schema_1.zodToJsonSchema)(tool.metadata.parameters)
81
+ : undefined,
82
+ }));
83
+ return {
84
+ tools,
85
+ };
86
+ });
87
+ mcpServer.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
88
+ this.logger.debug('CallToolRequestSchema is being called');
89
+ const toolInfo = this.registry.findTool(request.params.name);
90
+ if (!toolInfo) {
91
+ throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
92
+ }
93
+ const schema = toolInfo.metadata.parameters;
94
+ let parsedParams = request.params.arguments;
95
+ if (schema && schema instanceof zod_1.z.ZodType) {
96
+ const result = schema.safeParse(request.params.arguments);
97
+ if (!result.success) {
98
+ throw new types_js_1.McpError(types_js_1.ErrorCode.InvalidParams, `Invalid ${toolInfo.metadata.name} parameters: ${JSON.stringify(result.error.format())}`);
99
+ }
100
+ parsedParams = result.data;
101
+ }
102
+ try {
103
+ const contextId = core_1.ContextIdFactory.getByRequest(httpRequest);
104
+ this.moduleRef.registerRequestByContextId(httpRequest, contextId);
105
+ const toolInstance = await this.moduleRef.resolve(toolInfo.providerClass, contextId, { strict: false });
106
+ const context = this.createContext(mcpServer, request);
107
+ if (!toolInstance) {
108
+ throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
109
+ }
110
+ const result = await toolInstance[toolInfo.methodName].call(toolInstance, parsedParams, context, httpRequest);
111
+ this.logger.debug(result, 'CallToolRequestSchema result');
112
+ return result;
113
+ }
114
+ catch (error) {
115
+ this.logger.error(error);
116
+ return {
117
+ content: [{ type: 'text', text: error.message }],
118
+ isError: true,
119
+ };
120
+ }
121
+ });
122
+ }
123
+ createContext(mcpServer, mcpRequest) {
124
+ const progressToken = mcpRequest.params?._meta?.progressToken;
125
+ return {
126
+ reportProgress: async (progress) => {
127
+ if (progressToken) {
128
+ await mcpServer.server.notification({
129
+ method: 'notifications/progress',
130
+ params: {
131
+ ...progress,
132
+ progressToken,
133
+ },
134
+ });
135
+ }
136
+ },
137
+ log: {
138
+ debug: (message, context) => {
139
+ void mcpServer.server.sendLoggingMessage({
140
+ level: 'debug',
141
+ data: { message, context },
142
+ });
143
+ },
144
+ error: (message, context) => {
145
+ void mcpServer.server.sendLoggingMessage({
146
+ level: 'error',
147
+ data: { message, context },
148
+ });
149
+ },
150
+ info: (message, context) => {
151
+ void mcpServer.server.sendLoggingMessage({
152
+ level: 'info',
153
+ data: { message, context },
154
+ });
155
+ },
156
+ warn: (message, context) => {
157
+ void mcpServer.server.sendLoggingMessage({
158
+ level: 'warning',
159
+ data: { message, context },
160
+ });
161
+ },
162
+ },
163
+ };
164
+ }
165
+ };
166
+ exports.McpExecutorService = McpExecutorService;
167
+ exports.McpExecutorService = McpExecutorService = McpExecutorService_1 = __decorate([
168
+ (0, common_1.Injectable)({ scope: common_1.Scope.REQUEST }),
169
+ __metadata("design:paramtypes", [core_1.ModuleRef,
170
+ mcp_registry_service_1.McpRegistryService])
171
+ ], McpExecutorService);
172
+ //# sourceMappingURL=mcp-executor.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-executor.service.js","sourceRoot":"","sources":["../../src/services/mcp-executor.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ import { InjectionToken, OnApplicationBootstrap } from '@nestjs/common';
2
+ import { DiscoveryService, MetadataScanner } from '@nestjs/core';
3
+ import { ToolMetadata } from '../decorators';
4
+ import { ResourceMetadata } from 'src/decorators/resource.decorator';
5
+ export type DiscoveredTool<T extends object> = {
6
+ type: 'tool' | 'resource';
7
+ metadata: T;
8
+ providerClass: InjectionToken;
9
+ methodName: string;
10
+ };
11
+ export declare class McpRegistryService implements OnApplicationBootstrap {
12
+ private readonly discovery;
13
+ private readonly metadataScanner;
14
+ private discoveredTools;
15
+ constructor(discovery: DiscoveryService, metadataScanner: MetadataScanner);
16
+ onApplicationBootstrap(): void;
17
+ private discoverTools;
18
+ private addDiscoveryTool;
19
+ private addDiscoveryResource;
20
+ getTools(): DiscoveredTool<ToolMetadata>[];
21
+ findTool(name: string): DiscoveredTool<ToolMetadata> | undefined;
22
+ getResources(): DiscoveredTool<ResourceMetadata>[];
23
+ findResource(name: string): DiscoveredTool<ResourceMetadata> | undefined;
24
+ private convertTemplate;
25
+ private convertUri;
26
+ findResourceByUri(uri: string): {
27
+ resource: DiscoveredTool<ResourceMetadata>;
28
+ params: Record<string, string>;
29
+ } | undefined;
30
+ }
31
+ //# sourceMappingURL=mcp-registry.service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-registry.service.d.ts","sourceRoot":"","sources":["../../src/services/mcp-registry.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAGL,YAAY,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAMrE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI;IAC7C,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,QAAQ,EAAE,CAAC,CAAC;IACZ,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAKF,qBACa,kBAAmB,YAAW,sBAAsB;IAI7D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,eAAe,CAA6B;gBAGjC,SAAS,EAAE,gBAAgB,EAC3B,eAAe,EAAE,eAAe;IAGnD,sBAAsB;IAOtB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,oBAAoB;IAqB5B,QAAQ,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE;IAO1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,SAAS;IAOhE,YAAY,IAAI,cAAc,CAAC,gBAAgB,CAAC,EAAE;IAOlD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,gBAAgB,CAAC,GAAG,SAAS;IAIxE,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,UAAU;IAYlB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GACzB;QACE,QAAQ,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC,GACD,SAAS;CA6Bd"}
@@ -0,0 +1,119 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.McpRegistryService = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const core_1 = require("@nestjs/core");
15
+ const decorators_1 = require("../decorators");
16
+ const path_to_regexp_1 = require("path-to-regexp");
17
+ let McpRegistryService = class McpRegistryService {
18
+ constructor(discovery, metadataScanner) {
19
+ this.discovery = discovery;
20
+ this.metadataScanner = metadataScanner;
21
+ this.discoveredTools = [];
22
+ }
23
+ onApplicationBootstrap() {
24
+ this.discoverTools();
25
+ }
26
+ discoverTools() {
27
+ const providers = this.discovery.getProviders();
28
+ const controllers = this.discovery.getControllers();
29
+ const allInstances = [...providers, ...controllers]
30
+ .filter((wrapper) => wrapper.instance)
31
+ .map((wrapper) => ({
32
+ instance: wrapper.instance,
33
+ token: wrapper.token,
34
+ }));
35
+ allInstances.forEach(({ instance, token }) => {
36
+ this.metadataScanner.getAllMethodNames(instance).forEach((methodName) => {
37
+ const methodRef = instance[methodName];
38
+ const methodMetaKeys = Reflect.getOwnMetadataKeys(methodRef);
39
+ if (methodMetaKeys.includes(decorators_1.MCP_TOOL_METADATA_KEY)) {
40
+ this.addDiscoveryTool(methodRef, token, methodName);
41
+ }
42
+ if (methodMetaKeys.includes(decorators_1.MCP_RESOURCE_METADATA_KEY)) {
43
+ this.addDiscoveryResource(methodRef, token, methodName);
44
+ }
45
+ });
46
+ });
47
+ }
48
+ addDiscoveryTool(methodRef, token, methodName) {
49
+ const metadata = Reflect.getMetadata(decorators_1.MCP_TOOL_METADATA_KEY, methodRef);
50
+ this.discoveredTools.push({
51
+ type: 'tool',
52
+ metadata,
53
+ providerClass: token,
54
+ methodName,
55
+ });
56
+ }
57
+ addDiscoveryResource(methodRef, token, methodName) {
58
+ const metadata = Reflect.getMetadata(decorators_1.MCP_RESOURCE_METADATA_KEY, methodRef);
59
+ this.discoveredTools.push({
60
+ type: 'resource',
61
+ metadata,
62
+ providerClass: token,
63
+ methodName,
64
+ });
65
+ }
66
+ getTools() {
67
+ return this.discoveredTools.filter((tool) => tool.type === 'tool');
68
+ }
69
+ findTool(name) {
70
+ return this.getTools().find((tool) => tool.metadata.name === name);
71
+ }
72
+ getResources() {
73
+ return this.discoveredTools.filter((tool) => tool.type === 'resource');
74
+ }
75
+ findResource(name) {
76
+ return this.getResources().find((tool) => tool.metadata.name === name);
77
+ }
78
+ convertTemplate(template) {
79
+ return template?.replace(/{(\w+)}/g, ':$1');
80
+ }
81
+ convertUri(uri) {
82
+ if (uri.includes('://')) {
83
+ return uri.split('://')[1];
84
+ }
85
+ return uri;
86
+ }
87
+ findResourceByUri(uri) {
88
+ const resources = this.getResources().map((tool) => ({
89
+ name: tool.metadata.name,
90
+ uri: tool.metadata.uri,
91
+ }));
92
+ const strippedInputUri = this.convertUri(uri);
93
+ for (const t of resources) {
94
+ if (!t.uri)
95
+ continue;
96
+ const rawTemplate = t.uri;
97
+ const templatePath = this.convertTemplate(this.convertUri(rawTemplate));
98
+ const matcher = (0, path_to_regexp_1.match)(templatePath, { decode: decodeURIComponent });
99
+ const result = matcher(strippedInputUri);
100
+ if (result) {
101
+ const foundResource = this.findResource(t.name);
102
+ if (!foundResource)
103
+ continue;
104
+ return {
105
+ resource: foundResource,
106
+ params: result.params,
107
+ };
108
+ }
109
+ }
110
+ return undefined;
111
+ }
112
+ };
113
+ exports.McpRegistryService = McpRegistryService;
114
+ exports.McpRegistryService = McpRegistryService = __decorate([
115
+ (0, common_1.Injectable)(),
116
+ __metadata("design:paramtypes", [core_1.DiscoveryService,
117
+ core_1.MetadataScanner])
118
+ ], McpRegistryService);
119
+ //# sourceMappingURL=mcp-registry.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-registry.service.js","sourceRoot":"","sources":["../../src/services/mcp-registry.service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=mcp-registry.service.spec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-registry.service.spec.d.ts","sourceRoot":"","sources":["../../src/services/mcp-registry.service.spec.ts"],"names":[],"mappings":""}
@@ -0,0 +1,61 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const testing_1 = require("@nestjs/testing");
4
+ const mcp_registry_service_1 = require("./mcp-registry.service");
5
+ const core_1 = require("@nestjs/core");
6
+ describe('McpRegistryService', () => {
7
+ let service;
8
+ const mockResource = (name, uri) => ({
9
+ type: 'resource',
10
+ metadata: { name, uri },
11
+ providerClass: Symbol(name),
12
+ methodName: 'someMethod',
13
+ });
14
+ beforeEach(async () => {
15
+ const module = await testing_1.Test.createTestingModule({
16
+ providers: [
17
+ mcp_registry_service_1.McpRegistryService,
18
+ {
19
+ provide: core_1.DiscoveryService,
20
+ useValue: {
21
+ getProviders: jest.fn(() => []),
22
+ getControllers: jest.fn(() => []),
23
+ },
24
+ },
25
+ core_1.MetadataScanner,
26
+ ],
27
+ }).compile();
28
+ service = module.get(mcp_registry_service_1.McpRegistryService);
29
+ service.discoveredTools = [
30
+ mockResource('res0', '/posts/comments'),
31
+ mockResource('res1', '/users/{id}'),
32
+ mockResource('res2', '/posts/:postId/comments'),
33
+ mockResource('res3', 'mcp://hello-world'),
34
+ ];
35
+ });
36
+ it('should return the correct resource by URI', () => {
37
+ const result = service.findResourceByUri('/users/123');
38
+ expect(result?.resource.metadata.name).toBe('res1');
39
+ expect(result?.params).toEqual({ id: '123' });
40
+ });
41
+ it('should return undefined for unknown URI', () => {
42
+ const result = service.findResourceByUri('/unknown/path');
43
+ expect(result).toBeUndefined();
44
+ });
45
+ it('should match complex URI template', () => {
46
+ const result = service.findResourceByUri('/posts/456/comments');
47
+ expect(result?.resource.metadata.name).toBe('res2');
48
+ expect(result?.params).toEqual({ postId: '456' });
49
+ });
50
+ it('should match simple URI template', () => {
51
+ const result = service.findResourceByUri('/posts/comments');
52
+ expect(result?.resource.metadata.name).toBe('res0');
53
+ expect(result?.params).toEqual({});
54
+ });
55
+ it('should match mcp URI', () => {
56
+ const result = service.findResourceByUri('mcp://hello-world');
57
+ expect(result?.resource.metadata.name).toBe('res3');
58
+ expect(result?.params).toEqual({});
59
+ });
60
+ });
61
+ //# sourceMappingURL=mcp-registry.service.spec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-registry.service.spec.js","sourceRoot":"","sources":["../../src/services/mcp-registry.service.spec.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ import eslint from '@eslint/js';
2
+ import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
3
+ import globals from 'globals';
4
+ import tseslint from 'typescript-eslint';
5
+
6
+ export default tseslint.config(
7
+ {
8
+ ignores: ['eslint.config.mjs', 'dist', 'tests/**/*'],
9
+ },
10
+ eslint.configs.recommended,
11
+ ...tseslint.configs.recommendedTypeChecked,
12
+ eslintPluginPrettierRecommended,
13
+ {
14
+ languageOptions: {
15
+ globals: {
16
+ ...globals.node,
17
+ ...globals.jest,
18
+ },
19
+ ecmaVersion: 5,
20
+ sourceType: 'module',
21
+ parserOptions: {
22
+ projectService: true,
23
+ tsconfigRootDir: import.meta.dirname,
24
+ },
25
+ },
26
+ },
27
+ {
28
+ rules: {
29
+ '@typescript-eslint/no-explicit-any': 'off',
30
+ '@typescript-eslint/no-floating-promises': 'warn',
31
+ '@typescript-eslint/no-unsafe-argument': 'warn',
32
+ '@typescript-eslint/no-unsafe-assignment': 'off',
33
+ '@typescript-eslint/no-unused-vars': 'warn',
34
+ '@typescript-eslint/no-unsafe-member-access': 'off',
35
+ '@typescript-eslint/no-unsafe-call': 'off',
36
+ },
37
+ },
38
+ );
package/image.png ADDED
Binary file
package/package.json CHANGED
@@ -1,14 +1,21 @@
1
1
  {
2
2
  "name": "@rekog/mcp-nest",
3
- "version": "1.2.0",
3
+ "version": "1.3.0",
4
4
  "description": "NestJS module for creating Model Context Protocol (MCP) servers and exposing tools using SSE",
5
5
  "main": "dist/index.js",
6
+ "license": "MIT",
6
7
  "types": "dist/index.d.ts",
8
+ "publishConfig": {
9
+ "access": "public"
10
+ },
7
11
  "scripts": {
8
- "build": "tsc",
12
+ "build": "tsc -p tsconfig.build.json",
9
13
  "prepare": "npm run build",
14
+ "start:playground": "ts-node-dev --respawn ./playground/server.ts",
10
15
  "test": "jest",
11
- "test:watch": "jest --watch"
16
+ "test:watch": "jest --watch",
17
+ "lint": "eslint \"{src,apps,libs,tests}/**/*.ts\" --fix",
18
+ "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\""
12
19
  },
13
20
  "peerDependencies": {
14
21
  "@modelcontextprotocol/sdk": ">=1.4.1",
@@ -18,17 +25,27 @@
18
25
  "reflect-metadata": ">=0.1.14"
19
26
  },
20
27
  "devDependencies": {
28
+ "@eslint/eslintrc": "^3.2.0",
29
+ "@eslint/js": "^9.18.0",
21
30
  "@modelcontextprotocol/sdk": "1.4.1",
22
31
  "@nestjs/common": "^11.0.5",
23
32
  "@nestjs/core": "^11.0.5",
24
- "@nestjs/testing": "^11.0.5",
25
33
  "@nestjs/platform-express": "^11.0.5",
34
+ "@nestjs/testing": "^11.0.5",
26
35
  "@types/express": "^5.0.0",
27
36
  "@types/jest": "^29.5.14",
28
37
  "@types/node": "^22.10.10",
38
+ "eslint": "^9.18.0",
39
+ "eslint-config-prettier": "^10.0.1",
40
+ "eslint-plugin-prettier": "^5.2.3",
29
41
  "express": "^4.21.2",
30
42
  "jest": "^29.7.0",
31
43
  "ts-jest": "^29.2.5",
32
- "typescript": "^5.7.3"
44
+ "ts-node-dev": "^2.0.0",
45
+ "typescript": "^5.7.3",
46
+ "typescript-eslint": "^8.20.0"
47
+ },
48
+ "dependencies": {
49
+ "path-to-regexp": "^8.2.0"
33
50
  }
34
51
  }
@@ -0,0 +1,17 @@
1
+ # Playground
2
+
3
+ Easy way to test using the `npx @modelcontextprotocol/inspector`.
4
+
5
+ ### Using
6
+
7
+ ```sh
8
+ # 1. start the playground
9
+ npm run start:playground
10
+
11
+ # 2. make your code changes
12
+
13
+ # 3. test it using the inspector
14
+ npx @modelcontextprotocol/inspector
15
+ ```
16
+
17
+ The last command will print the MCP Inspector URL. Open it in your browser, change the **Transport Type** to `SSE` and set the **URL** to the playground endpoint `http://localhost:3030/sse`.