imean-service-engine 1.4.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 }; }
@@ -523,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;
       }
     }
@@ -1236,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,
@@ -1245,6 +1366,7 @@ exports.Action = Action;
 exports.CacheAdapter = CacheAdapter;
 exports.MemoryCacheAdapter = MemoryCacheAdapter;
 exports.Microservice = Microservice;
+exports.ModelContextProtocolPlugin = ModelContextProtocolPlugin;
 exports.Module = Module;
 exports.Plugin = Plugin;
 exports.RedisCacheAdapter = RedisCacheAdapter;

package/dist/mod.d.cts

@@ -260,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>;
+}
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -279,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, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, 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 };
+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

@@ -260,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>;
+}
+
 /**
  * 用于给微服务模块方法添加的注解
  */
@@ -279,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, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, 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 };
+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
@@ -514,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;
       }
     }
@@ -1227,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, Plugin, 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,87 +1,87 @@
-{
-  "name": "imean-service-engine",
-  "version": "1.4.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",
-    "@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"
-  }
-}
+{
+  "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"
+  }
+}