loopback4-mcp 0.0.1

package/README.md

@@ -0,0 +1,87 @@
+<a href="https://sourcefuse.github.io/arc-docs/arc-api-docs" target="_blank"><img src="https://github.com/sourcefuse/loopback4-microservice-catalog/blob/master/docs/assets/logo-dark-bg.png?raw=true" alt="ARC By SourceFuse logo" title="ARC By SourceFuse" align="right" width="150" /></a>
+# [loopback4-mcp](https://github.com/sourcefuse/loopback4-mcp)
+<p align="left">
+</a>
+<a href="https://loopback.io/" target="_blank">
+<img alt="Powered By LoopBack 4" src="https://img.shields.io/badge/Powered%20by-LoopBack 4-brightgreen" />
+</a>
+</p>
+
+## Overview
+
+This extension provides a plug-and-play integration between LoopBack4 applications and the Model Context Protocol (MCP) specification.
+
+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.
+### Key Features
+- Automatic MCP Tool Discovery :-
+  The extension scans your application at boot time and automatically registers all methods decorated with the custom @mcpTool() decorator.
+
+  This allows you to define MCP tools anywhere in your LoopBack project without manually wiring metadata.
+
+- Lifecycle-managed Tool Registry :-
+  A dedicated `McpToolRegistry` service maintains all discovered tool metadata,their handlers and execution context.
+
+  A `McpToolRegistryBootObserver` ensures that registration happens only after the application has fully booted.
+## Installation
+```sh
+npm install loopback4-mcp
+```
+Then register the component inside your `application.ts`.
+```ts
+this.component(McpComponent);
+```
+## Usage
+Add the `@mcpTool()` decorator to any controller in your application.
+```ts
+@mcpTool({
+  name: 'create-user',
+  description: 'Creates a new user in the system',
+  schema?: {
+    email: z.string().email(),
+    name: z.string(),
+  },
+})
+async createUser(args: {email: string; name: string}) {
+  return {message: `User ${args.name} created`};
+}
+```
+
+This decorator accepts a total of five fields, out of which `name` and `description` are mandatory and `schema`,`preHook` and `postHook` are optional enhancements.
+
+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.
+
+### Mcp Hook Usage Details
+  To use hooks with MCP tools, follow the provider-based approach:
+
+  Step 1: Create a hook provider:
+  ```ts
+  // src/providers/my-hook.provider.ts
+  export class MyHookProvider implements Provider<McpHookFunction> {
+    constructor(@inject(LOGGER.LOGGER_INJECT) private logger: ILogger) {}
+    value(): McpHookFunction {
+      return async (context: McpHookContext) => {
+        this.logger.info(`Hook executed for tool: ${context.toolName}`);
+      };
+    }
+ }
+  ```
+  Step 2: Add binding key to McpHookBindings:
+  ```ts
+  // src/keys.ts
+  export namespace McpHookBindings {
+    export const MY_HOOK = BindingKey.create<McpHookFunction>('hooks.mcp.myHook');
+  }
+  ```
+  Step 3: Bind provider in `application.ts`:
+  ```typescript
+  this.bind(McpHookBindings.MY_HOOK).toProvider(MyHookProvider);
+ ```
+  Step 4: Use in decorator:
+  ```ts
+  @mcpTool({
+   name: 'my-tool',
+   description: 'my-description'
+   preHookBinding: McpHookBindings.MY_HOOK,
+    postHookBinding: 'hooks.mcp.myOtherHook' // or string binding key
+  })
+  ```

package/dist/component.d.ts

@@ -0,0 +1,11 @@
+import { Application, Component } from '@loopback/core';
+import { McpSchemaGeneratorService, McpServerFactory, McpToolRegistry } from './services';
+import { McpController } from './controllers';
+import { McpToolRegistryBootObserver } from './observers';
+export declare class McpComponent implements Component {
+    private application;
+    services: (typeof McpSchemaGeneratorService | typeof McpToolRegistry | typeof McpServerFactory)[];
+    controllers: (typeof McpController)[];
+    lifeCycleObservers: (typeof McpToolRegistryBootObserver)[];
+    constructor(application: Application);
+}

package/dist/component.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpComponent = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@loopback/core");
+const services_1 = require("./services");
+const controllers_1 = require("./controllers");
+const observers_1 = require("./observers");
+let McpComponent = class McpComponent {
+    constructor(application) {
+        this.application = application;
+        this.services = [services_1.McpSchemaGeneratorService, services_1.McpServerFactory, services_1.McpToolRegistry];
+        this.controllers = [controllers_1.McpController];
+        this.lifeCycleObservers = [observers_1.McpToolRegistryBootObserver];
+    }
+};
+exports.McpComponent = McpComponent;
+exports.McpComponent = McpComponent = tslib_1.__decorate([
+    tslib_1.__param(0, (0, core_1.inject)(core_1.CoreBindings.APPLICATION_INSTANCE)),
+    tslib_1.__metadata("design:paramtypes", [core_1.Application])
+], McpComponent);
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":";;;;AAAA,yCAA4E;AAC5E,yCAIoB;AACpB,+CAA4C;AAC5C,2CAAwD;AAExD,IAAa,YAAY,GAAzB,MAAa,YAAY;IAIvB,YAEE,WAAgC;QAAxB,gBAAW,GAAX,WAAW,CAAa;QALlC,aAAQ,GAAG,CAAC,oCAAyB,EAAE,2BAAgB,EAAE,0BAAe,CAAC,CAAC;QAC1E,gBAAW,GAAG,CAAC,2BAAa,CAAC,CAAC;QAC9B,uBAAkB,GAAG,CAAC,uCAA2B,CAAC,CAAC;IAIhD,CAAC;CACL,CAAA;AARY,oCAAY;uBAAZ,YAAY;IAKpB,mBAAA,IAAA,aAAM,EAAC,mBAAY,CAAC,oBAAoB,CAAC,CAAA;6CACrB,kBAAW;GANvB,YAAY,CAQxB"}

package/dist/constants/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp-tool.constant';

package/dist/constants/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-tool.constant"), exports);
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":";;;AAAA,8DAAoC"}

package/dist/constants/mcp-tool.constant.d.ts

@@ -0,0 +1 @@
+export declare const MCP_TOOL_METADATA_KEY = "mcp:tools";

package/dist/constants/mcp-tool.constant.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_TOOL_METADATA_KEY = void 0;
+// Metadata key for MCP tools
+exports.MCP_TOOL_METADATA_KEY = 'mcp:tools';
+//# sourceMappingURL=mcp-tool.constant.js.map

package/dist/constants/mcp-tool.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.constant.js","sourceRoot":"","sources":["../../src/constants/mcp-tool.constant.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAChB,QAAA,qBAAqB,GAAG,WAAW,CAAC"}

package/dist/controllers/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp.controller';

package/dist/controllers/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp.controller"), exports);
+//# sourceMappingURL=index.js.map

package/dist/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC"}

package/dist/controllers/mcp.controller.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="express" />
+import { Request, Response } from '@loopback/rest';
+import { ILogger } from '@sourceloop/core';
+import { McpServerFactory } from '../services';
+export declare class McpController {
+    private readonly logger;
+    private readonly serverFactory;
+    constructor(logger: ILogger, serverFactory: McpServerFactory);
+    handleMCPRequest(req: Request, res: Response): Promise<void>;
+}

package/dist/controllers/mcp.controller.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpController = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@loopback/core");
+const rest_1 = require("@loopback/rest");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const core_2 = require("@sourceloop/core");
+const loopback4_authentication_1 = require("loopback4-authentication");
+const loopback4_authorization_1 = require("loopback4-authorization");
+const services_1 = require("../services");
+let McpController = class McpController {
+    constructor(logger, serverFactory) {
+        this.logger = logger;
+        this.serverFactory = serverFactory;
+    }
+    async handleMCPRequest(req, res) {
+        try {
+            // Server creation using factory service
+            const server = this.serverFactory.createServer();
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            // Set up cleanup handlers
+            /* eslint-disable @typescript-eslint/no-misused-promises */
+            res.on('close', async () => {
+                await transport.close();
+                await server.close();
+                this.logger.info('Session closed.');
+            });
+            res.on('error', async () => {
+                await transport.close();
+                await server.close();
+                this.logger.info('Closing Session as it errorred out.');
+            });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (err) {
+            this.logger.error('Failed to establish MCP connection:', err);
+            if (!res.headersSent) {
+                res.status(500 /* STATUS_CODE.INTERNAL_SERVER_ERROR */).json({
+                    jsonrpc: '2.0',
+                    error: {
+                        code: -32603,
+                        message: 'Internal server error',
+                    },
+                    id: null,
+                });
+            }
+        }
+    }
+};
+exports.McpController = McpController;
+tslib_1.__decorate([
+    (0, loopback4_authentication_1.authenticate)("bearer" /* STRATEGY.BEARER */, {
+        passReqToCallback: true,
+    }),
+    (0, loopback4_authorization_1.authorize)({
+        permissions: ['*'],
+    }),
+    (0, rest_1.post)('/mcp', {
+        summary: 'MCP HTTP Message',
+        description: 'Handle MCP message via StreamableHTTP transport',
+        requestBody: {
+            content: {
+                [core_2.CONTENT_TYPE.JSON]: {
+                    schema: {
+                        type: 'object',
+                        description: 'MCP message payload',
+                    },
+                },
+            },
+        },
+        responses: {
+            [200 /* STATUS_CODE.OK */]: {
+                description: 'MCP message processed successfully',
+                content: {
+                    [core_2.CONTENT_TYPE.JSON]: {
+                        schema: {
+                            type: 'object',
+                            description: 'MCP response message',
+                        },
+                    },
+                },
+            },
+            [500 /* STATUS_CODE.INTERNAL_SERVER_ERROR */]: {
+                description: 'Internal server error',
+                content: {
+                    [core_2.CONTENT_TYPE.JSON]: {
+                        schema: {
+                            type: 'object',
+                            properties: {
+                                jsonrpc: { type: 'string' },
+                                error: {
+                                    type: 'object',
+                                    properties: {
+                                        code: { type: 'number' },
+                                        message: { type: 'string' },
+                                    },
+                                },
+                                id: { type: 'null' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    }),
+    tslib_1.__param(0, (0, core_1.inject)(rest_1.RestBindings.Http.REQUEST)),
+    tslib_1.__param(1, (0, core_1.inject)(rest_1.RestBindings.Http.RESPONSE)),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], McpController.prototype, "handleMCPRequest", null);
+exports.McpController = McpController = tslib_1.__decorate([
+    tslib_1.__param(0, (0, core_1.inject)(core_2.LOGGER.LOGGER_INJECT)),
+    tslib_1.__param(1, (0, core_1.service)(services_1.McpServerFactory)),
+    tslib_1.__metadata("design:paramtypes", [Object, services_1.McpServerFactory])
+], McpController);
+//# sourceMappingURL=mcp.controller.js.map

package/dist/controllers/mcp.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.controller.js","sourceRoot":"","sources":["../../src/controllers/mcp.controller.ts"],"names":[],"mappings":"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"}

package/dist/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp-tool.decorator';

package/dist/decorators/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-tool.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

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

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

@@ -0,0 +1,2 @@
+import { McpToolDecoratorOptions } from '../types';
+export declare function mcpTool(options: McpToolDecoratorOptions): (target: Object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/decorators/mcp-tool.decorator.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpTool = void 0;
+const core_1 = require("@loopback/core");
+const constants_1 = require("../constants");
+/**
+ * Process hook config to normalize binding keys
+ */
+function processHookConfig(hookConfig) {
+    if (!hookConfig)
+        return undefined;
+    const binding = typeof hookConfig.binding === 'string'
+        ? core_1.BindingKey.create(hookConfig.binding)
+        : hookConfig.binding;
+    return {
+        binding,
+        config: hookConfig.config,
+    };
+}
+function mcpTool(options) {
+    return function (target, propertyKey, descriptor) {
+        var _a, _b;
+        // Create basic schema - parameter extraction happens in the service
+        const basicSchema = (_a = options.schema) !== null && _a !== void 0 ? _a : {};
+        const metadata = {
+            name: options.name,
+            description: options.description,
+            schema: basicSchema,
+            controllerFunction: descriptor.value,
+            preHook: processHookConfig(options.preHook),
+            postHook: processHookConfig(options.postHook),
+            parameterNames: [], // Will be populated by service
+        };
+        // Store metadata using LoopBack's metadata system
+        // Get existing metadata for the class
+        const existingMethodsMetadata = (_b = core_1.MetadataInspector.getAllMethodMetadata(constants_1.MCP_TOOL_METADATA_KEY, target)) !== null && _b !== void 0 ? _b : {};
+        // Add this method's metadata
+        existingMethodsMetadata[propertyKey] = metadata;
+        // Store the complete metadata map back
+        core_1.MetadataInspector.defineMetadata(constants_1.MCP_TOOL_METADATA_KEY, existingMethodsMetadata, target);
+        return descriptor;
+    };
+}
+exports.mcpTool = mcpTool;
+//# sourceMappingURL=mcp-tool.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;;AAAA,yCAA6D;AAC7D,4CAAmD;AAQnD;;GAEG;AACH,SAAS,iBAAiB,CACxB,UAA0B;IAE1B,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,OAAO,GACX,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;QACpC,CAAC,CAAC,iBAAU,CAAC,MAAM,CAAkB,UAAU,CAAC,OAAO,CAAC;QACxD,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IAEzB,OAAO;QACL,OAAO;QACP,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,SAAgB,OAAO,CAAC,OAAgC;IACtD,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;;QAE9B,oEAAoE;QACpE,MAAM,WAAW,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAoB;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,WAAW;YACnB,kBAAkB,EAAE,UAAU,CAAC,KAAK;YACpC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC;YAC3C,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC7C,cAAc,EAAE,EAAE,EAAE,+BAA+B;SACpD,CAAC;QAEF,kDAAkD;QAClD,sCAAsC;QACtC,MAAM,uBAAuB,GAC3B,MAAA,wBAAiB,CAAC,oBAAoB,CACpC,iCAAqB,EACrB,MAAM,CACP,mCAAI,EAAE,CAAC;QAEV,6BAA6B;QAC7B,uBAAuB,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;QAEhD,uCAAuC;QACvC,wBAAiB,CAAC,cAAc,CAC9B,iCAAqB,EACrB,uBAAuB,EACvB,MAAM,CACP,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAvCD,0BAuCC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './component';
+export * from './types';
+export * from './decorators';
+export * from './observers';
+export * from './keys';

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./component"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./decorators"), exports);
+tslib_1.__exportStar(require("./observers"), exports);
+tslib_1.__exportStar(require("./keys"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,kDAAwB;AACxB,uDAA6B;AAC7B,sDAA4B;AAC5B,iDAAuB"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp-hook-provider.interface';

package/dist/interfaces/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-hook-provider.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

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

package/dist/interfaces/mcp-hook-provider.interface.d.ts

@@ -0,0 +1,12 @@
+export interface McpHookContext {
+    toolName: string;
+    args: {
+        [key: string]: unknown;
+    };
+    result?: unknown;
+    error?: Error;
+    metadata?: {
+        [key: string]: unknown;
+    };
+}
+export type McpHookFunction = (context: McpHookContext) => Promise<McpHookContext | void> | McpHookContext | void;

package/dist/interfaces/mcp-hook-provider.interface.js

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

package/dist/interfaces/mcp-hook-provider.interface.js.map

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

package/dist/keys.d.ts

@@ -0,0 +1 @@
+export declare namespace McpBindings { }

package/dist/keys.js

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

package/dist/keys.js.map

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

package/dist/observers/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp-tool-registry-boot.observer';

package/dist/observers/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-tool-registry-boot.observer"), exports);
+//# sourceMappingURL=index.js.map

package/dist/observers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observers/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkD"}

package/dist/observers/mcp-tool-registry-boot.observer.d.ts

@@ -0,0 +1,19 @@
+import { LifeCycleObserver } from '@loopback/core';
+import { ILogger } from '@sourceloop/core';
+import { McpToolRegistry } from '../services';
+/**
+ * Lifecycle observer to initialize MCP tool registry after application boot
+ */
+export declare class McpToolRegistryBootObserver implements LifeCycleObserver {
+    private readonly mcpToolRegistry;
+    private readonly logger;
+    constructor(mcpToolRegistry: McpToolRegistry, logger: ILogger);
+    /**
+     * Initialize MCP tool registry after application starts
+     */
+    start(): Promise<void>;
+    /**
+     * Called when application stops
+     */
+    stop(): Promise<void>;
+}

package/dist/observers/mcp-tool-registry-boot.observer.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolRegistryBootObserver = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@loopback/core");
+const core_2 = require("@sourceloop/core");
+const services_1 = require("../services");
+/**
+ * Lifecycle observer to initialize MCP tool registry after application boot
+ */
+let McpToolRegistryBootObserver = class McpToolRegistryBootObserver {
+    constructor(mcpToolRegistry, logger) {
+        this.mcpToolRegistry = mcpToolRegistry;
+        this.logger = logger;
+    }
+    /**
+     * Initialize MCP tool registry after application starts
+     */
+    async start() {
+        try {
+            await this.mcpToolRegistry.initialize();
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize MCP tool registry:', error);
+            throw error;
+        }
+    }
+    /**
+     * Called when application stops
+     */
+    async stop() {
+        this.logger.info('MCP tool registry stopping...');
+    }
+};
+exports.McpToolRegistryBootObserver = McpToolRegistryBootObserver;
+exports.McpToolRegistryBootObserver = McpToolRegistryBootObserver = tslib_1.__decorate([
+    (0, core_1.lifeCycleObserver)('mcpToolRegistryInit'),
+    tslib_1.__param(0, (0, core_1.service)(services_1.McpToolRegistry)),
+    tslib_1.__param(1, (0, core_1.inject)(core_2.LOGGER.LOGGER_INJECT)),
+    tslib_1.__metadata("design:paramtypes", [services_1.McpToolRegistry, Object])
+], McpToolRegistryBootObserver);
+//# sourceMappingURL=mcp-tool-registry-boot.observer.js.map

package/dist/observers/mcp-tool-registry-boot.observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-registry-boot.observer.js","sourceRoot":"","sources":["../../src/observers/mcp-tool-registry-boot.observer.ts"],"names":[],"mappings":";;;;AAAA,yCAKwB;AACxB,2CAAiD;AACjD,0CAA4C;AAE5C;;GAEG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACtC,YAEmB,eAAgC,EAEhC,MAAe;QAFf,oBAAe,GAAf,eAAe,CAAiB;QAEhC,WAAM,GAAN,MAAM,CAAS;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI;YACF,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;SACzC;QAAC,OAAO,KAAK,EAAE;YACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YACpE,MAAM,KAAK,CAAC;SACb;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACpD,CAAC;CACF,CAAA;AA1BY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,wBAAiB,EAAC,qBAAqB,CAAC;IAGpC,mBAAA,IAAA,cAAO,EAAC,0BAAe,CAAC,CAAA;IAExB,mBAAA,IAAA,aAAM,EAAC,aAAM,CAAC,aAAa,CAAC,CAAA;6CADK,0BAAe;GAHxC,2BAA2B,CA0BvC"}

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+export * from './mcp-server-factory.service';
+export * from './mcp-tool-registry.service';
+export * from './mcp-schema-generator-service.service';

package/dist/services/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mcp-server-factory.service"), exports);
+tslib_1.__exportStar(require("./mcp-tool-registry.service"), exports);
+tslib_1.__exportStar(require("./mcp-schema-generator-service.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;AAAA,uEAA6C;AAC7C,sEAA4C;AAC5C,iFAAuD"}

package/dist/services/mcp-schema-generator-service.service.d.ts

@@ -0,0 +1,20 @@
+import { ILogger } from '@sourceloop/core';
+import { z, ZodRawShape } from 'zod';
+export declare class McpSchemaGeneratorService {
+    private readonly logger;
+    constructor(logger: ILogger);
+    /**
+     * Create Zod schema for a single parameter using LoopBack type string
+     */
+    createZodSchemaForParameterType(paramType: string): z.ZodString | z.ZodNumber | z.ZodBoolean | z.ZodObject<{}, z.core.$loose> | z.ZodAny | z.ZodArray<z.ZodAny>;
+    /**
+     * Generate tool schema using LoopBack metadata
+     */
+    generateToolSchemaFromLoopBack(options: {
+        name: string;
+        description: string;
+        schema?: ZodRawShape;
+    }, target: Object, methodName: string): Readonly<{
+        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    }>;
+}