imean-service-engine 1.3.0 → 1.4.0

package/dist/mod.cjs

@@ -85,7 +85,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 +122,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: [
@@ -783,7 +786,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 +814,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -826,7 +839,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 +1202,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;
   }
 };
 
@@ -1249,6 +1246,7 @@ exports.CacheAdapter = CacheAdapter;
 exports.MemoryCacheAdapter = MemoryCacheAdapter;
 exports.Microservice = Microservice;
 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 {
@@ -278,4 +279,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, 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 {
@@ -278,4 +279,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, 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

@@ -76,7 +76,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 +113,8 @@ var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
   ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
   return ScheduleMode2;
 })(ScheduleMode || {});
+var Plugin = class {
+};
 var logger = winston.createLogger({
   level: "info",
   transports: [
@@ -774,7 +777,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 +805,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -817,7 +830,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 +1193,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;
   }
 };
 
@@ -1231,4 +1228,4 @@ async function startCheck(checkers, pass) {
   if (pass) await pass();
 }
 
-export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, Module, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };
+export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, Module, Plugin, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imean-service-engine",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "microservice engine",
   "keywords": [
     "microservice",
@@ -39,6 +39,7 @@
   "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",
@@ -46,6 +47,7 @@
     "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"
   },