imean-service-engine 1.3.0 → 1.4.1

package/dist/mod.cjs

@@ -13,6 +13,10 @@ var prettier = require('prettier');
 var crypto2 = require('crypto');
 var zlib = require('zlib');
 var nodeWs = require('@hono/node-ws');
+var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
+var types_js = require('@modelcontextprotocol/sdk/types.js');
+var streaming = require('hono/streaming');
+var ulid = require('ulid');
 var dayjs = require('dayjs');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -85,7 +89,8 @@ function Action(options) {
         printError: options.printError ?? false,
         cache: options.cache,
         ttl: options.ttl,
-        stream: options.stream
+        stream: options.stream,
+        mcp: options.mcp
       };
       prototype[ACTION_METADATA] = existingMetadata;
     });
@@ -121,6 +126,8 @@ var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
   ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
   return ScheduleMode2;
 })(ScheduleMode || {});
+var Plugin = class {
+};
 var logger = winston__default.default.createLogger({
   level: "info",
   transports: [
@@ -520,6 +527,7 @@ var ActionHandler = class {
       const now = Date.now();
       if (cached !== null && (!this.metadata.ttl || cached?.expireAt > now)) {
         span?.setAttribute("cacheHit", true);
+        span?.setAttribute("cacheKey", cacheKey);
         return cached.data;
       }
     }
@@ -783,7 +791,16 @@ var Microservice = class {
     this.options = {
       prefix: "/api",
       name: "microservice",
+      version: "0.0.1",
+      env: "default",
+      printError: false,
+      disableCache: false,
+      generateClient: false,
+      etcd: false,
+      events: {},
+      websocket: { enabled: false },
       cacheAdapter: new MemoryCacheAdapter(),
+      plugins: [],
       ...options
     };
     this.cache = this.options.cacheAdapter;
@@ -802,6 +819,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -826,7 +844,7 @@ var Microservice = class {
         );
         this.actionHandlers.set(`${moduleName}.${actionName}`, handler);
         logger_default.info(
-          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description}`
+          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description} ${actionMetadata.mcp ? "MCP:" + actionMetadata.mcp?.type : ""}`
         );
       }
       const schedules = getScheduleMetadata(ModuleClass.prototype);
@@ -1189,32 +1207,16 @@ Received SIGINT signal`);
       return ctx.json({ success: false, error: error.message });
     }
   };
-  async init() {
-    await this.waitingInitialization;
-  }
-  /**
-   * 获取所有注册的服务
-   */
-  async getServices() {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
+  async initPlugins() {
+    for (const plugin of this.options.plugins) {
+      logger_default.info(`[ \u521D\u59CB\u5316\u63D2\u4EF6 ] ${plugin.constructor.name}`);
+      await plugin.initialize(this).catch((e) => {
+        logger_default.error(`[ \u521D\u59CB\u5316\u63D2\u4EF6\u5931\u8D25 ] ${plugin.constructor.name}: ${e}`);
+      });
     }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const servicesKey = `${namespace}services`;
-    const services = await this.etcdClient.getAll().prefix(servicesKey);
-    return Object.values(services).map((value) => JSON.parse(value));
   }
-  /**
-   * 获取指定服务的实例
-   */
-  async getServiceInstances(serviceName) {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
-    }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const serviceKey = `${namespace}services/${serviceName}`;
-    const instances = await this.etcdClient.getAll().prefix(serviceKey);
-    return Object.values(instances).map((value) => JSON.parse(value));
+  async init() {
+    await this.waitingInitialization;
   }
 };
 
@@ -1239,6 +1241,122 @@ async function startCheck(checkers, pass) {
   logger_default.info("[ \u9884\u68C0\u5B8C\u6210 ]");
   if (pass) await pass();
 }
+var HonoTransport = class {
+  constructor(url, stream, closeStream) {
+    this.url = url;
+    this.stream = stream;
+    this.closeStream = closeStream;
+    this.sessionId = ulid.ulid();
+  }
+  sessionId;
+  onclose;
+  onerror;
+  onmessage;
+  async start() {
+    await this.stream.writeSSE({
+      event: "endpoint",
+      data: `${encodeURI(this.url)}?sessionId=${this.sessionId}`
+    });
+    this.stream.onAbort(() => {
+      this.close();
+    });
+  }
+  async handleMessage(message) {
+    let parsedMessage;
+    try {
+      parsedMessage = types_js.JSONRPCMessageSchema.parse(message);
+    } catch (error) {
+      this.onerror?.(error);
+      throw error;
+    }
+    this.onmessage?.(parsedMessage);
+  }
+  async send(message) {
+    await this.stream.writeln(
+      `event: message
+data: ${JSON.stringify(message)}
+
+`
+    );
+  }
+  async close() {
+    this.onclose?.();
+    this.closeStream();
+  }
+};
+var ModelContextProtocolPlugin = class extends Plugin {
+  mcpServer;
+  transports = {};
+  registerMcpTools(engine) {
+    const modules = engine.getModules(true);
+    for (const module of Object.values(modules)) {
+      for (const action of Object.values(module.actions)) {
+        if (action.mcp?.type !== "tool") {
+          continue;
+        }
+        const args = {};
+        const argsIndex = {};
+        for (const [index, param] of (action.params ?? []).entries()) {
+          args[param.description] = param;
+          argsIndex[param.description] = index;
+        }
+        this.mcpServer.tool(
+          `${module.name}.${action.name}`,
+          action.description ?? "",
+          args,
+          async (params) => {
+            const args2 = Object.values(params);
+            const argsList = [];
+            for (const [key, value] of Object.entries(args2)) {
+              argsList[argsIndex[key]] = value;
+            }
+            const result = await engine.getActionHandler(module.name, action.name).handle(argsList);
+            return {
+              content: [{ type: "text", text: JSON.stringify(result) }]
+            };
+          }
+        );
+      }
+    }
+  }
+  initialize = async (engine) => {
+    const app = engine.getApp();
+    this.mcpServer = new mcp_js.McpServer({
+      name: engine.options.name,
+      version: engine.options.version
+    });
+    this.registerMcpTools(engine);
+    app.get(`${engine.options.prefix}/mcp_sse`, async (ctx) => {
+      return streaming.streamSSE(ctx, async (stream) => {
+        return new Promise(async (resolve) => {
+          const transport = new HonoTransport(
+            `${engine.options.prefix}/mcp_messages`,
+            stream,
+            () => {
+              delete this.transports[transport.sessionId];
+              resolve();
+            }
+          );
+          this.transports[transport.sessionId] = transport;
+          await this.mcpServer.connect(transport);
+        });
+      });
+    });
+    app.post(`${engine.options.prefix}/mcp_messages`, async (ctx) => {
+      const sessionId = ctx.req.query("sessionId");
+      if (!sessionId) {
+        return ctx.text("No transport found for sessionId", 400);
+      }
+      const transport = this.transports[sessionId];
+      const message = await ctx.req.json();
+      await transport.handleMessage(message);
+      return ctx.text("Accepted", 202);
+    });
+    logger_default.info(
+      `ModelContextProtocolPlugin endpoint: ${engine.options.prefix}/mcp_sse`
+    );
+  };
+};
 
 Object.defineProperty(exports, "dayjs", {
   enumerable: true,
@@ -1248,7 +1366,9 @@ exports.Action = Action;
 exports.CacheAdapter = CacheAdapter;
 exports.MemoryCacheAdapter = MemoryCacheAdapter;
 exports.Microservice = Microservice;
+exports.ModelContextProtocolPlugin = ModelContextProtocolPlugin;
 exports.Module = Module;
+exports.Plugin = Plugin;
 exports.RedisCacheAdapter = RedisCacheAdapter;
 exports.Schedule = Schedule;
 exports.ScheduleMode = ScheduleMode;

package/dist/mod.d.cts

@@ -25,6 +25,9 @@ declare class MemoryCacheAdapter extends CacheAdapter {
 }
 
 type CacheFn = (...args: any[]) => any;
+type McpOptions = {
+    type: "tool";
+};
 interface ActionOptions {
     params?: z.ZodType<any>[];
     returns?: z.ZodType<any>;
@@ -34,6 +37,7 @@ interface ActionOptions {
     cache?: boolean | CacheFn;
     ttl?: number;
     stream?: boolean;
+    mcp?: McpOptions;
 }
 interface ActionMetadata extends ActionOptions {
     name: string;
@@ -139,7 +143,7 @@ interface MicroserviceOptions {
     disableCache?: boolean;
     modules: (new () => any)[];
     generateClient?: URL | boolean;
-    etcd?: EtcdConfig;
+    etcd?: EtcdConfig | false;
     events?: StatisticsEventOptions & {
         onStats?: (event: StatisticsEvent) => void | Promise<void>;
         onRegister?: (serviceInfo: ServiceInfo) => void | Promise<void>;
@@ -150,6 +154,7 @@ interface MicroserviceOptions {
         timeout?: number;
     };
     cacheAdapter?: CacheAdapter;
+    plugins?: Plugin[];
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -160,6 +165,9 @@ interface StreamResponse<T = any> {
     done: boolean;
     error?: string;
 }
+declare abstract class Plugin {
+    abstract initialize(engine: Microservice): Promise<void>;
+}
 
 declare class ActionHandler {
     private moduleInstance;
@@ -195,7 +203,7 @@ declare class Microservice {
     private actionHandlers;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
-    options: MicroserviceOptions;
+    options: Required<MicroserviceOptions>;
     cache: CacheAdapter;
     serviceId: string;
     constructor(options: MicroserviceOptions);
@@ -224,7 +232,7 @@ declare class Microservice {
     /**
      * 获取所有模块的元数据
      */
-    private getModules;
+    getModules(withTypes?: boolean): Record<string, ModuleInfo>;
     /**
      * 停止服务
      */
@@ -241,15 +249,8 @@ declare class Microservice {
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
     private handleRequest;
+    private initPlugins;
     init(): Promise<void>;
-    /**
-     * 获取所有注册的服务
-     */
-    getServices(): Promise<ServiceInfo[]>;
-    /**
-     * 获取指定服务的实例
-     */
-    getServiceInstances(serviceName: string): Promise<ServiceInfo[]>;
 }
 
 interface PreStartChecker {
@@ -259,6 +260,13 @@ interface PreStartChecker {
 }
 declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
 
+declare class ModelContextProtocolPlugin extends Plugin {
+    private mcpServer;
+    private transports;
+    private registerMcpTools;
+    initialize: (engine: Microservice) => Promise<void>;
+}
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -278,4 +286,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, MemoryCacheAdapter, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };

package/dist/mod.d.ts

@@ -25,6 +25,9 @@ declare class MemoryCacheAdapter extends CacheAdapter {
 }
 
 type CacheFn = (...args: any[]) => any;
+type McpOptions = {
+    type: "tool";
+};
 interface ActionOptions {
     params?: z.ZodType<any>[];
     returns?: z.ZodType<any>;
@@ -34,6 +37,7 @@ interface ActionOptions {
     cache?: boolean | CacheFn;
     ttl?: number;
     stream?: boolean;
+    mcp?: McpOptions;
 }
 interface ActionMetadata extends ActionOptions {
     name: string;
@@ -139,7 +143,7 @@ interface MicroserviceOptions {
     disableCache?: boolean;
     modules: (new () => any)[];
     generateClient?: URL | boolean;
-    etcd?: EtcdConfig;
+    etcd?: EtcdConfig | false;
     events?: StatisticsEventOptions & {
         onStats?: (event: StatisticsEvent) => void | Promise<void>;
         onRegister?: (serviceInfo: ServiceInfo) => void | Promise<void>;
@@ -150,6 +154,7 @@ interface MicroserviceOptions {
         timeout?: number;
     };
     cacheAdapter?: CacheAdapter;
+    plugins?: Plugin[];
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -160,6 +165,9 @@ interface StreamResponse<T = any> {
     done: boolean;
     error?: string;
 }
+declare abstract class Plugin {
+    abstract initialize(engine: Microservice): Promise<void>;
+}
 
 declare class ActionHandler {
     private moduleInstance;
@@ -195,7 +203,7 @@ declare class Microservice {
     private actionHandlers;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
-    options: MicroserviceOptions;
+    options: Required<MicroserviceOptions>;
     cache: CacheAdapter;
     serviceId: string;
     constructor(options: MicroserviceOptions);
@@ -224,7 +232,7 @@ declare class Microservice {
     /**
      * 获取所有模块的元数据
      */
-    private getModules;
+    getModules(withTypes?: boolean): Record<string, ModuleInfo>;
     /**
      * 停止服务
      */
@@ -241,15 +249,8 @@ declare class Microservice {
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
     private handleRequest;
+    private initPlugins;
     init(): Promise<void>;
-    /**
-     * 获取所有注册的服务
-     */
-    getServices(): Promise<ServiceInfo[]>;
-    /**
-     * 获取指定服务的实例
-     */
-    getServiceInstances(serviceName: string): Promise<ServiceInfo[]>;
 }
 
 interface PreStartChecker {
@@ -259,6 +260,13 @@ interface PreStartChecker {
 }
 declare function startCheck(checkers: PreStartChecker[], pass?: () => void | Promise<void>): Promise<void>;
 
+declare class ModelContextProtocolPlugin extends Plugin {
+    private mcpServer;
+    private transports;
+    private registerMcpTools;
+    initialize: (engine: Microservice) => Promise<void>;
+}
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -278,4 +286,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, MemoryCacheAdapter, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, ModelContextProtocolPlugin, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };

package/dist/mod.js

@@ -13,6 +13,10 @@ import crypto2 from 'node:crypto';
 import { brotliDecompress } from 'node:zlib';
 import { brotliCompress, constants } from 'zlib';
 import { createNodeWebSocket } from '@hono/node-ws';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { JSONRPCMessageSchema } from '@modelcontextprotocol/sdk/types.js';
+import { streamSSE } from 'hono/streaming';
+import { ulid } from 'ulid';
 export { default as dayjs } from 'dayjs';
 
 // mod.ts
@@ -76,7 +80,8 @@ function Action(options) {
         printError: options.printError ?? false,
         cache: options.cache,
         ttl: options.ttl,
-        stream: options.stream
+        stream: options.stream,
+        mcp: options.mcp
       };
       prototype[ACTION_METADATA] = existingMetadata;
     });
@@ -112,6 +117,8 @@ var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
   ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
   return ScheduleMode2;
 })(ScheduleMode || {});
+var Plugin = class {
+};
 var logger = winston.createLogger({
   level: "info",
   transports: [
@@ -511,6 +518,7 @@ var ActionHandler = class {
       const now = Date.now();
       if (cached !== null && (!this.metadata.ttl || cached?.expireAt > now)) {
         span?.setAttribute("cacheHit", true);
+        span?.setAttribute("cacheKey", cacheKey);
         return cached.data;
       }
     }
@@ -774,7 +782,16 @@ var Microservice = class {
     this.options = {
       prefix: "/api",
       name: "microservice",
+      version: "0.0.1",
+      env: "default",
+      printError: false,
+      disableCache: false,
+      generateClient: false,
+      etcd: false,
+      events: {},
+      websocket: { enabled: false },
       cacheAdapter: new MemoryCacheAdapter(),
+      plugins: [],
       ...options
     };
     this.cache = this.options.cacheAdapter;
@@ -793,6 +810,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -817,7 +835,7 @@ var Microservice = class {
         );
         this.actionHandlers.set(`${moduleName}.${actionName}`, handler);
         logger_default.info(
-          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description}`
+          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description} ${actionMetadata.mcp ? "MCP:" + actionMetadata.mcp?.type : ""}`
         );
       }
       const schedules = getScheduleMetadata(ModuleClass.prototype);
@@ -1180,32 +1198,16 @@ Received SIGINT signal`);
       return ctx.json({ success: false, error: error.message });
     }
   };
-  async init() {
-    await this.waitingInitialization;
-  }
-  /**
-   * 获取所有注册的服务
-   */
-  async getServices() {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
+  async initPlugins() {
+    for (const plugin of this.options.plugins) {
+      logger_default.info(`[ \u521D\u59CB\u5316\u63D2\u4EF6 ] ${plugin.constructor.name}`);
+      await plugin.initialize(this).catch((e) => {
+        logger_default.error(`[ \u521D\u59CB\u5316\u63D2\u4EF6\u5931\u8D25 ] ${plugin.constructor.name}: ${e}`);
+      });
     }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const servicesKey = `${namespace}services`;
-    const services = await this.etcdClient.getAll().prefix(servicesKey);
-    return Object.values(services).map((value) => JSON.parse(value));
   }
-  /**
-   * 获取指定服务的实例
-   */
-  async getServiceInstances(serviceName) {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
-    }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const serviceKey = `${namespace}services/${serviceName}`;
-    const instances = await this.etcdClient.getAll().prefix(serviceKey);
-    return Object.values(instances).map((value) => JSON.parse(value));
+  async init() {
+    await this.waitingInitialization;
   }
 };
 
@@ -1230,5 +1232,121 @@ async function startCheck(checkers, pass) {
   logger_default.info("[ \u9884\u68C0\u5B8C\u6210 ]");
   if (pass) await pass();
 }
+var HonoTransport = class {
+  constructor(url, stream, closeStream) {
+    this.url = url;
+    this.stream = stream;
+    this.closeStream = closeStream;
+    this.sessionId = ulid();
+  }
+  sessionId;
+  onclose;
+  onerror;
+  onmessage;
+  async start() {
+    await this.stream.writeSSE({
+      event: "endpoint",
+      data: `${encodeURI(this.url)}?sessionId=${this.sessionId}`
+    });
+    this.stream.onAbort(() => {
+      this.close();
+    });
+  }
+  async handleMessage(message) {
+    let parsedMessage;
+    try {
+      parsedMessage = JSONRPCMessageSchema.parse(message);
+    } catch (error) {
+      this.onerror?.(error);
+      throw error;
+    }
+    this.onmessage?.(parsedMessage);
+  }
+  async send(message) {
+    await this.stream.writeln(
+      `event: message
+data: ${JSON.stringify(message)}
+
+`
+    );
+  }
+  async close() {
+    this.onclose?.();
+    this.closeStream();
+  }
+};
+var ModelContextProtocolPlugin = class extends Plugin {
+  mcpServer;
+  transports = {};
+  registerMcpTools(engine) {
+    const modules = engine.getModules(true);
+    for (const module of Object.values(modules)) {
+      for (const action of Object.values(module.actions)) {
+        if (action.mcp?.type !== "tool") {
+          continue;
+        }
+        const args = {};
+        const argsIndex = {};
+        for (const [index, param] of (action.params ?? []).entries()) {
+          args[param.description] = param;
+          argsIndex[param.description] = index;
+        }
+        this.mcpServer.tool(
+          `${module.name}.${action.name}`,
+          action.description ?? "",
+          args,
+          async (params) => {
+            const args2 = Object.values(params);
+            const argsList = [];
+            for (const [key, value] of Object.entries(args2)) {
+              argsList[argsIndex[key]] = value;
+            }
+            const result = await engine.getActionHandler(module.name, action.name).handle(argsList);
+            return {
+              content: [{ type: "text", text: JSON.stringify(result) }]
+            };
+          }
+        );
+      }
+    }
+  }
+  initialize = async (engine) => {
+    const app = engine.getApp();
+    this.mcpServer = new McpServer({
+      name: engine.options.name,
+      version: engine.options.version
+    });
+    this.registerMcpTools(engine);
+    app.get(`${engine.options.prefix}/mcp_sse`, async (ctx) => {
+      return streamSSE(ctx, async (stream) => {
+        return new Promise(async (resolve) => {
+          const transport = new HonoTransport(
+            `${engine.options.prefix}/mcp_messages`,
+            stream,
+            () => {
+              delete this.transports[transport.sessionId];
+              resolve();
+            }
+          );
+          this.transports[transport.sessionId] = transport;
+          await this.mcpServer.connect(transport);
+        });
+      });
+    });
+    app.post(`${engine.options.prefix}/mcp_messages`, async (ctx) => {
+      const sessionId = ctx.req.query("sessionId");
+      if (!sessionId) {
+        return ctx.text("No transport found for sessionId", 400);
+      }
+      const transport = this.transports[sessionId];
+      const message = await ctx.req.json();
+      await transport.handleMessage(message);
+      return ctx.text("Accepted", 202);
+    });
+    logger_default.info(
+      `ModelContextProtocolPlugin endpoint: ${engine.options.prefix}/mcp_sse`
+    );
+  };
+};
 
-export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, Module, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };
+export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, ModelContextProtocolPlugin, Module, Plugin, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };

package/package.json

@@ -1,85 +1,87 @@
-{
-  "name": "imean-service-engine",
-  "version": "1.3.0",
-  "description": "microservice engine",
-  "keywords": [
-    "microservice",
-    "websocket",
-    "http",
-    "node"
-  ],
-  "author": "imean",
-  "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://git.imean.tech/imean/imean-microservice-framework.git"
-  },
-  "main": "dist/mod.js",
-  "module": "dist/mod.js",
-  "types": "dist/mod.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/mod.d.ts",
-      "import": "./dist/mod.js",
-      "require": "./dist/mod.cjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "tsx watch dev/index.ts",
-    "build": "tsup",
-    "test": "vitest run",
-    "prepublishOnly": "npm run build && npm run test"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.13.7",
-    "@hono/node-ws": "^1.0.6",
-    "dayjs": "^1.11.13",
-    "ejson": "^2.2.3",
-    "etcd3": "^1.1.2",
-    "fs-extra": "^11.3.0",
-    "hono": "^4.6.17",
-    "lru-cache": "^11.0.2",
-    "prettier": "^3.4.2",
-    "winston": "^3.17.0",
-    "zod": "^3.24.1"
-  },
-  "peerDependencies": {
-    "@opentelemetry/api": "^1.x",
-    "ioredis": "^5.6.0"
-  },
-  "devDependencies": {
-    "@opentelemetry/auto-instrumentations-node": "^0.55.3",
-    "@opentelemetry/exporter-logs-otlp-proto": "^0.57.1",
-    "@opentelemetry/exporter-metrics-otlp-proto": "^0.57.1",
-    "@opentelemetry/exporter-trace-otlp-proto": "^0.57.1",
-    "@opentelemetry/instrumentation-winston": "^0.44.0",
-    "@opentelemetry/sdk-logs": "^0.57.1",
-    "@opentelemetry/sdk-metrics": "^1.30.1",
-    "@opentelemetry/sdk-node": "^0.57.1",
-    "@opentelemetry/sdk-trace-node": "^1.30.1",
-    "@opentelemetry/winston-transport": "^0.10.0",
-    "@types/ejson": "^2.2.2",
-    "@types/fs-extra": "^11.0.4",
-    "@types/ioredis-mock": "^8.2.5",
-    "@types/node": "^20.0.0",
-    "@vitest/coverage-v8": "^3.0.4",
-    "imean-service-client": "^1.5.0",
-    "ioredis-mock": "^8.9.0",
-    "opentelemetry-instrumentation-fetch-node": "^1.2.3",
-    "tslib": "^2.8.1",
-    "tsup": "^8.0.1",
-    "tsx": "^4.19.2",
-    "typescript": "^5.3.3",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.0.3"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "imean-service-engine",
+  "version": "1.4.1",
+  "description": "microservice engine",
+  "keywords": [
+    "microservice",
+    "websocket",
+    "http",
+    "node"
+  ],
+  "author": "imean",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.imean.tech/imean/imean-microservice-framework.git"
+  },
+  "main": "dist/mod.js",
+  "module": "dist/mod.js",
+  "types": "dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "import": "./dist/mod.js",
+      "require": "./dist/mod.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsx watch dev/index.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.7",
+    "@hono/node-ws": "^1.0.6",
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "dayjs": "^1.11.13",
+    "ejson": "^2.2.3",
+    "etcd3": "^1.1.2",
+    "fs-extra": "^11.3.0",
+    "hono": "^4.6.17",
+    "lru-cache": "^11.0.2",
+    "prettier": "^3.4.2",
+    "ulid": "^3.0.0",
+    "winston": "^3.17.0",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.x",
+    "ioredis": "^5.6.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/auto-instrumentations-node": "^0.55.3",
+    "@opentelemetry/exporter-logs-otlp-proto": "^0.57.1",
+    "@opentelemetry/exporter-metrics-otlp-proto": "^0.57.1",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.57.1",
+    "@opentelemetry/instrumentation-winston": "^0.44.0",
+    "@opentelemetry/sdk-logs": "^0.57.1",
+    "@opentelemetry/sdk-metrics": "^1.30.1",
+    "@opentelemetry/sdk-node": "^0.57.1",
+    "@opentelemetry/sdk-trace-node": "^1.30.1",
+    "@opentelemetry/winston-transport": "^0.10.0",
+    "@types/ejson": "^2.2.2",
+    "@types/fs-extra": "^11.0.4",
+    "@types/ioredis-mock": "^8.2.5",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^3.0.4",
+    "imean-service-client": "^1.5.0",
+    "ioredis-mock": "^8.9.0",
+    "opentelemetry-instrumentation-fetch-node": "^1.2.3",
+    "tslib": "^2.8.1",
+    "tsup": "^8.0.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.3.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}