loopback4-mcp 1.0.0 → 1.0.2

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 (5) hide show
  1. package/README.md +71 -39
  2. package/dist/services/mcp-tool-registry.service.js +2 -0
  3. package/dist/services/mcp-tool-registry.service.js.map +1 -1
  4. package/package.json +1 -1
  5. package/src/services/mcp-tool-registry.service.ts +2 -0
package/README.md CHANGED
@@ -28,7 +28,9 @@
28
28
  This extension provides a plug-and-play integration between LoopBack4 applications and the Model Context Protocol (MCP) specification.
29
29
 
30
30
  Its purpose is to enable LoopBack APIs, services, and business logic to be exposed as MCP Tools, allowing external MCP clients (such as LLMs, agents, or MCP-compatible apps) to discover and execute server-defined operations.
31
+
31
32
  ### Key Features
33
+
32
34
  - Automatic MCP Tool Discovery :-
33
35
  The extension scans your application at boot time and automatically registers all methods decorated with the custom @mcpTool() decorator.
34
36
 
@@ -38,16 +40,35 @@ Its purpose is to enable LoopBack APIs, services, and business logic to be expos
38
40
  A dedicated `McpToolRegistry` service maintains all discovered tool metadata,their handlers and execution context.
39
41
 
40
42
  A `McpToolRegistryBootObserver` ensures that registration happens only after the application has fully booted.
43
+
41
44
  ## Installation
45
+
42
46
  ```sh
43
47
  npm install loopback4-mcp
44
48
  ```
45
- Then register the component inside your `application.ts`.
49
+
50
+ ## Basic Usage
51
+
52
+ Configure and load `McpComponent` in the application constructor
53
+ as shown below.
54
+
46
55
  ```ts
47
- this.component(McpComponent);
56
+ import {McpComponent} from 'loopback4-mcp';
57
+
58
+ export class MyApplication extends BootMixin(
59
+ ServiceMixin(RepositoryMixin(RestApplication)),
60
+ ) {
61
+ constructor(options: ApplicationConfig = {}) {
62
+ super();
63
+ this.component(McpComponent);
64
+ }
65
+ }
48
66
  ```
49
- ## Usage
67
+
50
68
  Add the `@mcpTool()` decorator to any controller in your application.
69
+
70
+ All MCP tool methods must use LoopBack `@param` decorators to define their input parameters.If `@param` decorators are missing, the MCP tool will fail.
71
+
51
72
  ```ts
52
73
  @mcpTool({
53
74
  name: 'create-user',
@@ -57,8 +78,11 @@ Add the `@mcpTool()` decorator to any controller in your application.
57
78
  name: z.string(),
58
79
  },
59
80
  })
60
- async createUser(args: {email: string; name: string}) {
61
- return {message: `User ${args.name} created`};
81
+ async createUser(
82
+ @param.query.string('email') email: string,
83
+ @param.query.string('name') name: string,
84
+ ) {
85
+ return {message: `User ${name} created`};
62
86
  }
63
87
  ```
64
88
 
@@ -66,38 +90,46 @@ This decorator accepts a total of five fields, out of which `name` and `descript
66
90
 
67
91
  The schema field allows defining a Zod-based validation schema for tool input parameters, while preHook and postHook enable execution of custom logic before and after the tool handler runs.
68
92
 
69
- ### Mcp Hook Usage Details
70
- To use hooks with MCP tools, follow the provider-based approach:
71
-
72
- Step 1: Create a hook provider:
73
- ```ts
74
- // src/providers/my-hook.provider.ts
75
- export class MyHookProvider implements Provider<McpHookFunction> {
76
- constructor(@inject(LOGGER.LOGGER_INJECT) private logger: ILogger) {}
77
- value(): McpHookFunction {
78
- return async (context: McpHookContext) => {
79
- this.logger.info(`Hook executed for tool: ${context.toolName}`);
80
- };
81
- }
82
- }
83
- ```
84
- Step 2: Add binding key to McpHookBindings:
85
- ```ts
86
- // src/keys.ts
87
- export namespace McpHookBindings {
88
- export const MY_HOOK = BindingKey.create<McpHookFunction>('hooks.mcp.myHook');
93
+ ## Mcp Hook Usage Details
94
+
95
+ To use hooks with MCP tools, follow the provider-based approach:
96
+
97
+ Step 1: Create a hook provider:
98
+
99
+ ```ts
100
+ // src/providers/my-hook.provider.ts
101
+ export class MyHookProvider implements Provider<McpHookFunction> {
102
+ constructor(@inject(LOGGER.LOGGER_INJECT) private logger: ILogger) {}
103
+ value(): McpHookFunction {
104
+ return async (context: McpHookContext) => {
105
+ this.logger.info(`Hook executed for tool: ${context.toolName}`);
106
+ };
89
107
  }
90
- ```
91
- Step 3: Bind provider in `application.ts`:
92
- ```typescript
93
- this.bind(McpHookBindings.MY_HOOK).toProvider(MyHookProvider);
94
- ```
95
- Step 4: Use in decorator:
96
- ```ts
97
- @mcpTool({
98
- name: 'my-tool',
99
- description: 'my-description'
100
- preHookBinding: McpHookBindings.MY_HOOK,
101
- postHookBinding: 'hooks.mcp.myOtherHook' // or string binding key
102
- })
103
- ```
108
+ }
109
+ ```
110
+
111
+ Step 2: Add binding key to McpHookBindings:
112
+
113
+ ```ts
114
+ // src/keys.ts
115
+ export namespace McpHookBindings {
116
+ export const MY_HOOK = BindingKey.create<McpHookFunction>('hooks.mcp.myHook');
117
+ }
118
+ ```
119
+
120
+ Step 3: Bind provider in `application.ts`:
121
+
122
+ ```typescript
123
+ this.bind(McpHookBindings.MY_HOOK).toProvider(MyHookProvider);
124
+ ```
125
+
126
+ Step 4: Use in decorator:
127
+
128
+ ```ts
129
+ @mcpTool({
130
+ name: 'my-tool',
131
+ description: 'my-description'
132
+ preHookBinding: McpHookBindings.MY_HOOK,
133
+ postHookBinding: 'hooks.mcp.myOtherHook' // or string binding key
134
+ })
135
+ ```
package/dist/services/mcp-tool-registry.service.js CHANGED
@@ -24,6 +24,7 @@ let McpToolRegistry = class McpToolRegistry {
24
24
  getMcpToolsFromClass(targetClass) {
25
25
  const processedTools = [];
26
26
  const prototype = targetClass.prototype;
27
+ // Retrieve all tool metadata that was stored earlier by @mcpTool decorator
27
28
  const allTools = core_1.MetadataInspector.getAllMethodMetadata(constants_1.MCP_TOOL_METADATA_KEY, prototype);
28
29
  if (!allTools || Object.keys(allTools).length === 0) {
29
30
  return [];
@@ -69,6 +70,7 @@ let McpToolRegistry = class McpToolRegistry {
69
70
  this.logger.info(`No constructor found for binding ${binding.key}`);
70
71
  return [];
71
72
  }
73
+ // extracts all methods decroated with @mcpTool
72
74
  const tools = this.getMcpToolsFromClass(controllerClass);
73
75
  if (tools.length === 0)
74
76
  return [];
package/dist/services/mcp-tool-registry.service.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-tool-registry.service.js","sourceRoot":"","sources":["../../src/services/mcp-tool-registry.service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mcp-tool-registry.service.js","sourceRoot":"","sources":["../../src/services/mcp-tool-registry.service.ts"],"names":[],"mappings":";;;;AAAA,yCAWwB;AACxB,yCAA0C;AAO1C,2CAA2E;AAC3E,uEAAgE;AAChE,qEAIiC;AAEjC,4CAAmD;AACnD,oCAA8C;AAC9C,iGAAiF;AAI1E,IAAM,eAAe,GAArB,MAAM,eAAe;IAI1B,YAEE,GAAiC,EAEjC,MAAgC,EAEhC,eAA2D;QAJ1C,QAAG,GAAH,GAAG,CAAa;QAEhB,WAAM,GAAN,MAAM,CAAS;QAEf,oBAAe,GAAf,eAAe,CAA2B;QATrD,oBAAe,GAAc,EAAE,CAAC;QAChC,kBAAa,GAAG,KAAK,CAAC;IAS3B,CAAC;IAEJ;;OAEG;IACK,oBAAoB,CAAC,WAAqB;QAChD,MAAM,cAAc,GAAsB,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QAExC,2EAA2E;QAC3E,MAAM,QAAQ,GAAG,wBAAiB,CAAC,oBAAoB,CACrD,iCAAqB,EACrB,SAAS,CACV,CAAC;QAEF,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YACnD,OAAO,EAAE,CAAC;SACX;QAED,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACzD,IAAI;gBACF,MAAM,EAAC,cAAc,EAAC,GAAG,IAAA,4BAAoB,EAAC,SAAS,EAAE,UAAU,CAAC,CAAC;gBAErE,4CAA4C;gBAC5C,MAAM,aAAa,GAAoB;oBACrC,GAAG,IAAI;oBACP,cAAc;iBACf,CAAC;gBAEF,4BAA4B;gBAC5B,IACE,CAAC,aAAa,CAAC,MAAM;oBACrB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAC9C;oBACA,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,8BAA8B,CAChE;wBACE,IAAI,EAAE,aAAa,CAAC,IAAI;wBACxB,WAAW,EAAE,aAAa,CAAC,WAAW;wBACtC,MAAM,EAAE,aAAa,CAAC,MAAM;qBAC7B,EACD,SAAS,EACT,UAAU,CACX,CAAC;oBACF,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC;iBAC/B;gBAED,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;aACpC;YAAC,OAAO,KAAK,EAAE;gBACd,kDAAkD;gBAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,QAAQ,UAAU,yCAAyC,EAC3D,KAAK,CACN,CAAC;aACH;SACF;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO;QAE/B,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAE5D,mFAAmF;QACnF,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAClD,MAAM,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;YACjD,IAAI,CAAC,eAAe,EAAE;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBACpE,OAAO,EAAE,CAAC;aACX;YAED,+CAA+C;YAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;YAEzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAElC,oCAAoC;YACpC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACtB,OAAO;oBACL,GAAG,IAAI;oBACP,iBAAiB,EAAE,iBAAU,CAAC,MAAM,CAAS,OAAO,CAAC,GAAG,CAAC;oBACzD,OAAO,EAAE,KAAK,EACZ,cAAuB,EACvB,IAA8B,EAC9B,MAA8D,EACrC,EAAE;;wBAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAC9C,cAAc,EACd,IAAI,EACJ,eAAe,CAChB,CAAC;wBAEF,MAAM,WAAW,GAAmB;4BAClC,QAAQ,EAAE,IAAI,CAAC,IAAI;4BACnB,IAAI,EAAE,IAAI;4BACV,QAAQ,EAAE,MAAA,IAAI,CAAC,QAAQ,0CAAE,MAAM;yBAChC,CAAC;wBACF,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;wBAElD,IAAI,MAAM,CAAC;wBACX,IAAI;4BACF,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CACnC,GAAG,EACH,OAAO,CAAC,GAAG,EACX,IAAI,EACJ,WAAW,EACX,MAAM,CACP,CAAC;4BACF,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC;4BAE5B,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;yBACpD;wBAAC,OAAO,GAAG,EAAE;4BACZ,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;4BAClE,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;4BAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,aAAa,IAAI,CAAC,IAAI,qBAAqB,EAC3C,KAAK,CAAC,OAAO,CACd,CAAC;4BACF,OAAO,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;yBAC1C;gCAAS;4BACR,GAAG,CAAC,KAAK,EAAE,CAAC;yBACb;wBACD,OAAO,MAAC,WAAW,CAAC,MAAyB,mCAAI,MAAM,CAAC;oBAC1D,CAAC;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,GAAY,EACZ,WAAkD;QAElD,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO,SAAS,CAAC;SAClB;QAED,IAAI;YACF,MAAM,UAAU,GACd,OAAO,WAAW,KAAK,QAAQ;gBAC7B,CAAC,CAAC,iBAAU,CAAC,MAAM,CAAkB,WAAW,CAAC;gBACjD,CAAC,CAAC,WAAW,CAAC;YAClB,OAAO,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;SAClC;QAAC,OAAO,KAAK,EAAE;YACd,uEAAuE;YACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,gBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EACnD,KAAK,CACN,CAAC;YACF,OAAO,SAAS,CAAC;SAClB;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,yBAAyB,CACrC,cAAuB,EACvB,IAAqB,EACrB,eAAoC;QAEpC,wDAAwD;QACxD,MAAM,YAAY,GAChB,wBAAiB,CAAC,iBAAiB,CACjC,yDAA+B,EAC/B,eAAe,CAAC,SAAS,EACzB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAC7B,CAAC;QAEJ,IAAI,CAAC,YAAY,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,iDAAiD,IAAI,CAAC,IAAI,GAAG,CAC9D,CAAC;YACF,MAAM,IAAI,iBAAU,CAAC,SAAS,CAC5B,aAAa,IAAI,CAAC,IAAI,2CAA2C,CAClE,CAAC;SACH;QAED,kEAAkE;QAClE,MAAM,GAAG,GAAG,IAAI,cAAO,CAAC,cAAc,CAAC,CAAC;QAExC,iFAAiF;QACjF,GAAG,CAAC,IAAI,CAAC,+CAAqB,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;QAE1D,gDAAgD;QAChD,GAAG,CAAC,IAAI,CAAC,mBAAY,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;QAC5D,GAAG;aACA,IAAI,CAAC,mBAAY,CAAC,sBAAsB,CAAC;aACzC,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CACxB,iDAAsB,CAAC,YAAY,CACpC,CAAC;QAEF,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,GAAG,CACnC,+CAAqB,CAAC,gBAAgB,CACvC,CAAC;QACF,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE7D,IAAI,CAAC,YAAY,EAAE;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,QAAQ,IAAI,CAAC,EAAE,0CAA0C,IAAI,CAAC,IAAI,GAAG,CACtE,CAAC;YACF,MAAM,IAAI,iBAAU,CAAC,SAAS,CAC5B,+BAA+B,IAAI,CAAC,IAAI,IAAI,CAC7C,CAAC;SACH;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,IAAqB,EACrB,IAA8B;;QAE9B,8CAA8C;QAC9C,IAAI,CAAC,CAAA,MAAA,IAAI,CAAC,cAAc,0CAAE,MAAM,CAAA,EAAE;YAChC,6DAA6D;YAC7D,OAAO,CAAC,IAAI,CAAC,CAAC;SACf;QAED,+CAA+C;QAC/C,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAG,SAAS,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,GAAY,EACZ,IAAqB,EACrB,WAA2B;;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAA,IAAI,CAAC,OAAO,0CAAE,OAAO,CAAC,CAAC;QACnE,IAAI,OAAO,EAAE;YACX,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,aAAa,EAAE;gBACjB,WAAW,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC;aACvC;SACF;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,GAAY,EACZ,IAAqB,EACrB,WAA2B;;QAE3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAA,IAAI,CAAC,QAAQ,0CAAE,OAAO,CAAC,CAAC;QACrE,IAAI,QAAQ,EAAE;YACZ,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;YACnD,IAAI,cAAc,EAAE;gBAClB,WAAW,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;gBAC3C,WAAW,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;gBACvC,WAAW,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;aAC1C;SACF;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,GAAY,EACZ,UAAkB,EAClB,IAAqB,EACrB,WAA2B,EAC3B,MAA8D;QAE9D,MAAM,kBAAkB,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAEvE,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAC7C,kBAAkB,EAClB,GAAG,UAAU,EACb,MAAM,CACP,CAAC;QAEF,0EAA0E;QAC1E,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAC3D,MAAM,GAAG;gBACP,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACgB,CAAC;SACrB;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,qBAAqB,CAAC,KAAY;QACxC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,2BAA2B;iBACnD;aACF;SACgB,CAAC;IACtB,CAAC;CACF,CAAA;AAhVY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,WAAI,EAAC,EAAC,KAAK,EAAE,mBAAY,CAAC,SAAS,EAAC,CAAC;IAMjC,mBAAA,IAAA,aAAM,EAAC,mBAAY,CAAC,oBAAoB,CAAC,CAAA;IAEzC,mBAAA,IAAA,aAAM,EAAC,aAAM,CAAC,aAAa,CAAC,CAAA;IAE5B,mBAAA,IAAA,cAAO,EAAC,gEAAyB,CAAC,CAAA;6CAHb,kBAAW,UAIC,gEAAyB;GAVlD,eAAe,CAgV3B"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "loopback4-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "private": false,
5
5
  "description": "A loopback extension that exposes API to MCP Tools.",
6
6
  "keywords": [
package/src/services/mcp-tool-registry.service.ts CHANGED
@@ -51,6 +51,7 @@ export class McpToolRegistry {
51
51
  const processedTools: McpToolMetadata[] = [];
52
52
  const prototype = targetClass.prototype;
53
53
 
54
+ // Retrieve all tool metadata that was stored earlier by @mcpTool decorator
54
55
  const allTools = MetadataInspector.getAllMethodMetadata<McpToolMetadata>(
55
56
  MCP_TOOL_METADATA_KEY,
56
57
  prototype,
@@ -116,6 +117,7 @@ export class McpToolRegistry {
116
117
  return [];
117
118
  }
118
119
 
120
+ // extracts all methods decroated with @mcpTool
119
121
  const tools = this.getMcpToolsFromClass(controllerClass);
120
122
 
121
123
  if (tools.length === 0) return [];