@malek0512/loopback4-mcp 1.0.0

package/README.md

@@ -0,0 +1,124 @@
+# @malek0512/loopback4-mcp
+
+> MCP (Model Context Protocol) component for LoopBack 4 — expose your REST controllers as AI-callable tools via JSON-RPC 2.0 and SSE.
+
+## What it does
+
+Adds a `POST /mcp` and `GET /mcp/sse` endpoint to your LoopBack 4 application. Any controller method decorated with `@mcpTool()` is automatically discovered at startup and registered as an MCP tool, making it callable by LLMs and AI agents (Claude, GPT, etc.) through the standard Model Context Protocol.
+
+## Install
+
+```bash
+npm install @malek0512/loopback4-mcp
+```
+
+Peer dependencies (already present in any LB4 app):
+- `@loopback/core`
+- `@loopback/rest`
+- `@loopback/openapi-v3`
+
+## Usage
+
+### 1. Add `McpComponent` to your application
+
+```typescript
+// src/application.ts
+import {McpComponent} from '@malek0512/loopback4-mcp';
+
+export class MyApplication extends BootMixin(ServiceMixin(RepositoryMixin(RestApplication))) {
+  constructor(options: ApplicationConfig = {}) {
+    super(options);
+    this.component(McpComponent); // ← one line
+    // ...
+  }
+}
+```
+
+### 2. Decorate controller methods with `@mcpTool()`
+
+```typescript
+import {mcpTool} from '@malek0512/loopback4-mcp';
+
+export class OrderController {
+  @mcpTool({
+    name: 'list_orders',
+    description: 'List all orders, optionally filtered by status',
+  })
+  @get('/orders')
+  async find(): Promise<Order[]> {
+    return this.orderRepository.find();
+  }
+
+  @mcpTool({
+    name: 'create_order',
+    description: 'Create a new order',
+  })
+  @post('/orders')
+  async create(@requestBody() order: Omit<Order, 'id'>): Promise<Order> {
+    return this.orderRepository.create(order);
+  }
+
+  @mcpTool({
+    name: 'delete_order',
+    description: 'Delete an order by ID',
+  })
+  @del('/orders/{id}')
+  async deleteById(@param.path.number('id') id: number): Promise<void> {
+    return this.orderRepository.deleteById(id);
+  }
+}
+```
+
+### 3. Test with MCP Inspector
+
+```bash
+npm start
+npx @modelcontextprotocol/inspector http://localhost:3000/mcp
+```
+
+## Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| `POST` | `/mcp` | JSON-RPC 2.0 endpoint (initialize, tools/list, tools/call) |
+| `GET`  | `/mcp/sse` | Server-Sent Events transport |
+| `GET`  | `/mcp/health` | Health check |
+
+## MCP Methods supported
+
+| Method | Description |
+|--------|-------------|
+| `initialize` | MCP handshake |
+| `tools/list` | Returns all `@mcpTool()` decorated methods with their JSON Schema |
+| `tools/call` | Invokes a tool with arguments |
+
+## How `@mcpTool()` options map to MCP
+
+```typescript
+@mcpTool({
+  name: 'create_order',        // Tool name exposed to LLMs
+  description: 'Create order', // Shown in tools/list
+  inputSchema: {               // Optional: override auto-generated JSON Schema
+    type: 'object',
+    properties: { ... }
+  }
+})
+```
+
+The input schema is auto-generated from your LoopBack decorators (`@param.path`, `@requestBody`, etc.) — you don't need to write it manually.
+
+## Architecture
+
+```
+POST /mcp
+  → McpController
+    → MessageRouter (JSON-RPC 2.0)
+      → tools/list  → ToolRegistry.list()
+      → tools/call  → ToolExecutor → controller method
+```
+
+At startup, `MetadataScanner` scans all controllers tagged `controller`, reads `@mcpTool()` metadata, and registers each method as a `ToolDescriptor` in `ToolRegistry`. Input schemas are generated via `getControllerSpec()` from `@loopback/openapi-v3`.
+
+## License
+
+MIT

package/dist/component.d.ts

@@ -0,0 +1,8 @@
+import { Component, Application } from '@loopback/core';
+import { McpController } from './controllers/mcp.controller';
+export declare class McpComponent implements Component {
+    private app;
+    controllers: (typeof McpController)[];
+    constructor(app: Application);
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAKT,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAC,aAAa,EAAC,MAAM,8BAA8B,CAAC;AAW3D,qBAGa,YAAa,YAAW,SAAS;IAK1C,OAAO,CAAC,GAAG;IAJb,WAAW,2BAAmB;gBAIpB,GAAG,EAAE,WAAW;CA6B3B"}

package/dist/component.js

@@ -0,0 +1,67 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpComponent = void 0;
+const core_1 = require("@loopback/core");
+const mcp_controller_1 = require("./controllers/mcp.controller");
+const tool_registry_1 = require("./registry/tool-registry");
+const metadata_scanner_1 = require("./registry/metadata-scanner");
+const schema_generator_1 = require("./registry/schema-generator");
+const json_rpc_handler_1 = require("./protocol/json-rpc.handler");
+const message_router_1 = require("./protocol/message-router");
+const tool_executor_1 = require("./execution/tool-executor");
+const context_manager_1 = require("./execution/context-manager");
+const result_formatter_1 = require("./execution/result-formatter");
+const sse_transport_1 = require("./transport/sse.transport");
+let McpComponent = class McpComponent {
+    constructor(app) {
+        this.app = app;
+        this.controllers = [mcp_controller_1.McpController];
+        // Bind all MCP services as singletons so state (tool registry, initialized flag) persists across requests
+        this.app.bind('mcp.toolRegistry').toClass(tool_registry_1.ToolRegistry).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.metadataScanner').toClass(metadata_scanner_1.MetadataScanner).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.schemaGenerator').toClass(schema_generator_1.SchemaGenerator).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.jsonRpcHandler').toClass(json_rpc_handler_1.JsonRpcHandler).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.messageRouter').toClass(message_router_1.MessageRouter).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.toolExecutor').toClass(tool_executor_1.ToolExecutor).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.contextManager').toClass(context_manager_1.ContextManager).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.resultFormatter').toClass(result_formatter_1.ResultFormatter).inScope(core_1.BindingScope.SINGLETON);
+        this.app.bind('mcp.sseTransport').toClass(sse_transport_1.SseTransport).inScope(core_1.BindingScope.SINGLETON);
+        // Scan for MCP tools after application starts
+        this.app.on('started', async () => {
+            // Delay scanning to ensure all controllers are fully initialized
+            setTimeout(async () => {
+                try {
+                    console.log('[MCP] Scanning for MCP tools...');
+                    const scanner = await this.app.get('mcp.metadataScanner');
+                    await scanner.scan();
+                    const registry = await this.app.get('mcp.toolRegistry');
+                    console.log(`[MCP] Tool scanning complete. Found ${registry.size} tools.`);
+                }
+                catch (error) {
+                    console.error('[MCP] Error scanning tools:', error);
+                }
+            }, 100);
+        });
+    }
+};
+exports.McpComponent = McpComponent;
+exports.McpComponent = McpComponent = __decorate([
+    (0, core_1.injectable)({
+        tags: { [core_1.ContextTags.KEY]: 'components.McpComponent' },
+    }),
+    __param(0, (0, core_1.inject)(core_1.CoreBindings.APPLICATION_INSTANCE)),
+    __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,yCAQwB;AACxB,iEAA2D;AAC3D,4DAAsD;AACtD,kEAA4D;AAC5D,kEAA4D;AAC5D,kEAA2D;AAC3D,8DAAwD;AACxD,6DAAuD;AACvD,iEAA2D;AAC3D,mEAA6D;AAC7D,6DAAuD;AAKhD,IAAM,YAAY,GAAlB,MAAM,YAAY;IAGvB,YAEE,GAAwB;QAAhB,QAAG,GAAH,GAAG,CAAa;QAJ1B,gBAAW,GAAG,CAAC,8BAAa,CAAC,CAAC;QAM5B,0GAA0G;QAC1G,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,4BAAY,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,kCAAe,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,kCAAe,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,iCAAc,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,8BAAa,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC1F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,4BAAY,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,gCAAc,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,kCAAe,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,4BAAY,CAAC,CAAC,OAAO,CAAC,mBAAY,CAAC,SAAS,CAAC,CAAC;QAExF,8CAA8C;QAC9C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAChC,iEAAiE;YACjE,UAAU,CAAC,KAAK,IAAI,EAAE;gBACpB,IAAI,CAAC;oBACH,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;oBAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAkB,qBAAqB,CAAC,CAAC;oBAC3E,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAe,kBAAkB,CAAC,CAAC;oBACtE,OAAO,CAAC,GAAG,CAAC,uCAAuC,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC;gBAC7E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlCY,oCAAY;uBAAZ,YAAY;IAHxB,IAAA,iBAAU,EAAC;QACV,IAAI,EAAE,EAAC,CAAC,kBAAW,CAAC,GAAG,CAAC,EAAE,yBAAyB,EAAC;KACrD,CAAC;IAKG,WAAA,IAAA,aAAM,EAAC,mBAAY,CAAC,oBAAoB,CAAC,CAAA;qCAC7B,kBAAW;GALf,YAAY,CAkCxB"}

package/dist/controllers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp.controller';
+//# sourceMappingURL=index.d.ts.map

package/dist/controllers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/controllers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./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,mDAAiC"}

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

@@ -0,0 +1,16 @@
+import { Request, Response } from '@loopback/rest';
+import { MessageRouter } from '../protocol/message-router';
+import { SseTransport } from '../transport/sse.transport';
+import { JsonRpcRequest } from '../protocol/types';
+export declare class McpController {
+    private messageRouter;
+    private sseTransport;
+    constructor(messageRouter: MessageRouter, sseTransport: SseTransport);
+    handleMessage(request: JsonRpcRequest): Promise<unknown>;
+    handleSse(req: Request, res: Response): Promise<void>;
+    health(): Promise<{
+        status: string;
+        timestamp: number;
+    }>;
+}
+//# sourceMappingURL=mcp.controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/mcp.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,OAAO,EACP,QAAQ,EAGT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAC,YAAY,EAAC,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAEjD,qBAAa,aAAa;IAGtB,OAAO,CAAC,aAAa;IAErB,OAAO,CAAC,YAAY;gBAFZ,aAAa,EAAE,aAAa,EAE5B,YAAY,EAAE,YAAY;IAI9B,aAAa,CAAgB,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvE,SAAS,CACsB,GAAG,EAAE,OAAO,EACX,GAAG,EAAE,QAAQ,GAChD,OAAO,CAAC,IAAI,CAAC;IAKV,MAAM,IAAI,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;CAM7D"}

package/dist/controllers/mcp.controller.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpController = void 0;
+const core_1 = require("@loopback/core");
+const rest_1 = require("@loopback/rest");
+const message_router_1 = require("../protocol/message-router");
+const sse_transport_1 = require("../transport/sse.transport");
+let McpController = class McpController {
+    constructor(messageRouter, sseTransport) {
+        this.messageRouter = messageRouter;
+        this.sseTransport = sseTransport;
+    }
+    async handleMessage(request) {
+        return this.messageRouter.route(request);
+    }
+    async handleSse(req, res) {
+        return this.sseTransport.handleConnection(req, res);
+    }
+    async health() {
+        return {
+            status: 'ok',
+            timestamp: Date.now(),
+        };
+    }
+};
+exports.McpController = McpController;
+__decorate([
+    (0, rest_1.post)('/mcp'),
+    __param(0, (0, rest_1.requestBody)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], McpController.prototype, "handleMessage", null);
+__decorate([
+    (0, rest_1.get)('/mcp/sse'),
+    __param(0, (0, core_1.inject)(rest_1.RestBindings.Http.REQUEST)),
+    __param(1, (0, core_1.inject)(rest_1.RestBindings.Http.RESPONSE)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], McpController.prototype, "handleSse", null);
+__decorate([
+    (0, rest_1.get)('/mcp/health'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], McpController.prototype, "health", null);
+exports.McpController = McpController = __decorate([
+    __param(0, (0, core_1.inject)('mcp.messageRouter')),
+    __param(1, (0, core_1.inject)('mcp.sseTransport')),
+    __metadata("design:paramtypes", [message_router_1.MessageRouter,
+        sse_transport_1.SseTransport])
+], 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":";;;;;;;;;;;;;;;AAAA,yCAAsC;AACtC,yCAOwB;AACxB,+DAAyD;AACzD,8DAAwD;AAGxD,IAAa,aAAa,GAA1B,MAAa,aAAa;IACxB,YAEU,aAA4B,EAE5B,YAA0B;QAF1B,kBAAa,GAAb,aAAa,CAAe;QAE5B,iBAAY,GAAZ,YAAY,CAAc;IACjC,CAAC;IAGE,AAAN,KAAK,CAAC,aAAa,CAAgB,OAAuB;QACxD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CACsB,GAAY,EACX,GAAa;QAEjD,OAAO,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM;QACV,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,sCAAa;AASlB;IADL,IAAA,WAAI,EAAC,MAAM,CAAC;IACQ,WAAA,IAAA,kBAAW,GAAE,CAAA;;;;kDAEjC;AAGK;IADL,IAAA,UAAG,EAAC,UAAU,CAAC;IAEb,WAAA,IAAA,aAAM,EAAC,mBAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,WAAA,IAAA,aAAM,EAAC,mBAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;;;;8CAGpC;AAGK;IADL,IAAA,UAAG,EAAC,aAAa,CAAC;;;;2CAMlB;wBA3BU,aAAa;IAErB,WAAA,IAAA,aAAM,EAAC,mBAAmB,CAAC,CAAA;IAE3B,WAAA,IAAA,aAAM,EAAC,kBAAkB,CAAC,CAAA;qCADJ,8BAAa;QAEd,4BAAY;GALzB,aAAa,CA4BzB"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp-tool.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/decorators/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./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,uDAAqC"}

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

@@ -0,0 +1,21 @@
+import { JsonSchema } from '../protocol/types';
+export declare const MCP_TOOL_METADATA_KEY = "mcp:tool";
+export interface McpToolMetadata {
+    name: string;
+    description?: string;
+    inputSchema?: JsonSchema;
+    preHook?: {
+        binding?: string;
+        function?: Function;
+    };
+    postHook?: {
+        binding?: string;
+        function?: Function;
+    };
+}
+export declare function mcpTool(metadata: McpToolMetadata): MethodDecorator;
+export declare namespace McpToolMetadata {
+    function getMetadata(target: Object, methodName: string): McpToolMetadata | undefined;
+    function getAllMetadata(target: Object): Map<string, McpToolMetadata>;
+}
+//# sourceMappingURL=mcp-tool.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAE7C,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAMlE;AAED,yBAAiB,eAAe,CAAC;IAC/B,SAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,eAAe,GAAG,SAAS,CAM7B;IAED,SAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAgB3E;CACF"}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpToolMetadata = exports.MCP_TOOL_METADATA_KEY = void 0;
+exports.mcpTool = mcpTool;
+const core_1 = require("@loopback/core");
+exports.MCP_TOOL_METADATA_KEY = 'mcp:tool';
+function mcpTool(metadata) {
+    return core_1.MethodDecoratorFactory.createDecorator(exports.MCP_TOOL_METADATA_KEY, metadata, { decoratorName: '@mcpTool' });
+}
+var McpToolMetadata;
+(function (McpToolMetadata) {
+    function getMetadata(target, methodName) {
+        return core_1.MetadataInspector.getMethodMetadata(exports.MCP_TOOL_METADATA_KEY, target, methodName);
+    }
+    McpToolMetadata.getMetadata = getMetadata;
+    function getAllMetadata(target) {
+        const metadata = new Map();
+        const proto = Object.getPrototypeOf(target);
+        const methodNames = Object.getOwnPropertyNames(proto).filter(name => typeof proto[name] === 'function' && name !== 'constructor');
+        for (const methodName of methodNames) {
+            const toolMetadata = getMetadata(target, methodName);
+            if (toolMetadata) {
+                metadata.set(methodName, toolMetadata);
+            }
+        }
+        return metadata;
+    }
+    McpToolMetadata.getAllMetadata = getAllMetadata;
+})(McpToolMetadata || (exports.McpToolMetadata = McpToolMetadata = {}));
+//# 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":";;;AAmBA,0BAMC;AAzBD,yCAAyE;AAG5D,QAAA,qBAAqB,GAAG,UAAU,CAAC;AAgBhD,SAAgB,OAAO,CAAC,QAAyB;IAC/C,OAAO,6BAAsB,CAAC,eAAe,CAC3C,6BAAqB,EACrB,QAAQ,EACR,EAAC,aAAa,EAAE,UAAU,EAAC,CAC5B,CAAC;AACJ,CAAC;AAED,IAAiB,eAAe,CA6B/B;AA7BD,WAAiB,eAAe;IAC9B,SAAgB,WAAW,CACzB,MAAc,EACd,UAAkB;QAElB,OAAO,wBAAiB,CAAC,iBAAiB,CACxC,6BAAqB,EACrB,MAAM,EACN,UAAU,CACX,CAAC;IACJ,CAAC;IATe,2BAAW,cAS1B,CAAA;IAED,SAAgB,cAAc,CAAC,MAAc;QAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAE5C,MAAM,WAAW,GAAG,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,MAAM,CAC1D,IAAI,CAAC,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,IAAI,IAAI,KAAK,aAAa,CACpE,CAAC;QAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACrD,IAAI,YAAY,EAAE,CAAC;gBACjB,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAhBe,8BAAc,iBAgB7B,CAAA;AACH,CAAC,EA7BgB,eAAe,+BAAf,eAAe,QA6B/B"}

package/dist/execution/context-manager.d.ts

@@ -0,0 +1,14 @@
+export interface ExecutionContext {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    timestamp: number;
+    requestId?: string;
+}
+export declare class ContextManager {
+    private contexts;
+    createContext(toolName: string, args: Record<string, unknown>, requestId?: string): ExecutionContext;
+    getContext(requestId: string): ExecutionContext | undefined;
+    clearContext(requestId: string): boolean;
+    clearAll(): void;
+}
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/execution/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../src/execution/context-manager.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBACa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAuC;IAEvD,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB;IAenB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI3D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/execution/context-manager.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextManager = void 0;
+const core_1 = require("@loopback/core");
+let ContextManager = class ContextManager {
+    constructor() {
+        this.contexts = new Map();
+    }
+    createContext(toolName, args, requestId) {
+        const context = {
+            toolName,
+            arguments: args,
+            timestamp: Date.now(),
+            requestId,
+        };
+        if (requestId) {
+            this.contexts.set(requestId, context);
+        }
+        return context;
+    }
+    getContext(requestId) {
+        return this.contexts.get(requestId);
+    }
+    clearContext(requestId) {
+        return this.contexts.delete(requestId);
+    }
+    clearAll() {
+        this.contexts.clear();
+    }
+};
+exports.ContextManager = ContextManager;
+exports.ContextManager = ContextManager = __decorate([
+    (0, core_1.bind)({ scope: core_1.BindingScope.SINGLETON })
+], ContextManager);
+//# sourceMappingURL=context-manager.js.map

package/dist/execution/context-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.js","sourceRoot":"","sources":["../../src/execution/context-manager.ts"],"names":[],"mappings":";;;;;;;;;AAAA,yCAAkD;AAU3C,IAAM,cAAc,GAApB,MAAM,cAAc;IAApB;QACG,aAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAgCzD,CAAC;IA9BC,aAAa,CACX,QAAgB,EAChB,IAA6B,EAC7B,SAAkB;QAElB,MAAM,OAAO,GAAqB;YAChC,QAAQ;YACR,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS;SACV,CAAC;QAEF,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,YAAY,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF,CAAA;AAjCY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,WAAI,EAAC,EAAC,KAAK,EAAE,mBAAY,CAAC,SAAS,EAAC,CAAC;GACzB,cAAc,CAiC1B"}

package/dist/execution/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tool-executor';
+export * from './context-manager';
+export * from './result-formatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/execution/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./tool-executor"), exports);
+__exportStar(require("./context-manager"), exports);
+__exportStar(require("./result-formatter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,oDAAkC;AAClC,qDAAmC"}

package/dist/execution/result-formatter.d.ts

@@ -0,0 +1,16 @@
+import { Content } from '../protocol/types';
+export declare class ResultFormatter {
+    /**
+     * Format the result of a tool execution into MCP Content format
+     */
+    format(result: unknown): Content[];
+    /**
+     * Format an error into MCP Content format
+     */
+    formatError(error: unknown): Content[];
+    private isContentArray;
+    private isContent;
+    private hasContentProperty;
+    private toTextContent;
+}
+//# sourceMappingURL=result-formatter.d.ts.map

package/dist/execution/result-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.d.ts","sourceRoot":"","sources":["../../src/execution/result-formatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAc,MAAM,mBAAmB,CAAC;AAEvD,qBACa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE;IAelC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE;IA8BtC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,aAAa;CAoBtB"}