@loop_ouroboros/mcp-hub-lite 1.2.1 → 1.2.3

package/dist/server/src/services/gateway/request-handlers/initialize-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/initialize-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+DlE"}
+{"version":3,"file":"initialize-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/initialize-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqElE"}

package/dist/server/src/services/gateway/request-handlers/initialize-handler.js

@@ -1,4 +1,5 @@
 import { logger, LOG_MODULES } from '../../../utils/logger/index.js';
+import { getGatewayDebugSetting } from '../../../utils/json-utils.js';
 import { MCP_HUB_LITE_SERVER } from '../../../models/system-tools.constants.js';
 import { getAppVersion, getProtocolVersion } from '../../../utils/version.js';
 import { InitializedNotificationSchema, InitializeRequestSchema, PingRequestSchema } from './initialize.constants.js';
@@ -13,8 +14,10 @@ export function registerInitializeHandlers(server) {
             const { name, version } = request.params.clientInfo;
             const protocolVersion = request.params?.protocolVersion || getProtocolVersion();
             const clientCapabilities = request.params?.capabilities;
-            logger.debug(`Initialized client: Name=${name}, Version=${version}, ProtocolVersion=${protocolVersion}`, LOG_MODULES.GATEWAY);
-            if (clientCapabilities?.roots) {
+            if (getGatewayDebugSetting()) {
+                logger.debug(`Initialized client: Name=${name}, Version=${version}, ProtocolVersion=${protocolVersion}`, LOG_MODULES.GATEWAY);
+            }
+            if (getGatewayDebugSetting() && clientCapabilities?.roots) {
                 logger.debug(`Client ${name} supports roots capability`, LOG_MODULES.GATEWAY);
             }
         }
@@ -41,11 +44,15 @@ export function registerInitializeHandlers(server) {
         return { pong: true };
     });
     server.server.setNotificationHandler(InitializedNotificationSchema, async (notification) => {
-        logger.debug('Received initialized notification from client', LOG_MODULES.GATEWAY);
-        logger.debug(`Initialized notification details: ${JSON.stringify(notification)}`, LOG_MODULES.GATEWAY);
+        if (getGatewayDebugSetting()) {
+            logger.debug('Received initialized notification from client', LOG_MODULES.GATEWAY);
+            logger.debug(`Initialized notification details: ${JSON.stringify(notification)}`, LOG_MODULES.GATEWAY);
+        }
         try {
             // Process the notification
-            logger.debug('Successfully processed initialized notification', LOG_MODULES.GATEWAY);
+            if (getGatewayDebugSetting()) {
+                logger.debug('Successfully processed initialized notification', LOG_MODULES.GATEWAY);
+            }
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);

package/dist/server/src/services/hub-manager.service.d.ts

@@ -62,6 +62,8 @@ export declare class HubManagerService {
     addServer(name: string, config: Partial<ServerTemplate>): Promise<ServerConfig>;
     /**
      * Adds a new instance to an existing server.
+     * Note: This method only creates the instance without auto-connect.
+     * Use connectServerInstances() explicitly to connect after adding instances.
      */
     addServerInstance(name: string, instance: Partial<ServerInstance>): Promise<ServerInstance>;
     /**

package/dist/server/src/services/hub-manager.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-manager.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAKxC;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,GAAE,aAA6B;IAIlD;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5E;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAI9D;;OAEG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,GAAG,SAAS;IAe/E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIxD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAStD;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAQtF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrF;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAwB1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkBhG;;OAEG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlD;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;OAEG;IACG,qCAAqC,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAwBhC;AAED,eAAO,MAAM,UAAU,mBAA0B,CAAC"}
+{"version":3,"file":"hub-manager.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAKxC;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,GAAE,aAA6B;IAIlD;;OAEG;IACG,0BAA0B,CAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;KAAE,CAAC,GAChE,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E;;OAEG;IACG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlE;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;IAI9D;;OAEG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,GACT;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,GAAG,SAAS;IAe/E;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIvD;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAIxD;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAStD;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAQtF;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrF;;;;OAIG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC;IAQ1B;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAkBhG;;OAEG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlD;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetE;;OAEG;IACG,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D;;OAEG;IACG,qCAAqC,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAwBhC;AAED,eAAO,MAAM,UAAU,mBAA0B,CAAC"}

package/dist/server/src/services/hub-manager.service.js

@@ -32,10 +32,7 @@ export class HubManagerService {
      */
     async addServerInstancesWithoutConnect(serverNames) {
         for (const name of serverNames) {
-            await this.configManager.addServerInstance(name, {});
-            const instances = this.getServerInstancesByName(name);
-            const lastInstance = instances[instances.length - 1];
-            eventBus.publish(EventTypes.SERVER_INSTANCE_ADDED, { name, instance: lastInstance });
+            await this.addServerInstance(name, {});
         }
     }
     /**
@@ -133,22 +130,12 @@ export class HubManagerService {
     }
     /**
      * Adds a new instance to an existing server.
+     * Note: This method only creates the instance without auto-connect.
+     * Use connectServerInstances() explicitly to connect after adding instances.
      */
     async addServerInstance(name, instance) {
         const newInstance = await this.configManager.addServerInstance(name, instance);
         logger.info(`Server instance added for server: [${name}]`, LOG_MODULES.HUB_MANAGER);
-        const resolvedConfig = this.getResolvedServerConfig(name, newInstance.id);
-        if (resolvedConfig && resolvedConfig.enabled !== false) {
-            try {
-                await mcpConnectionManager.connect(name, newInstance.index ?? 0, {
-                    ...resolvedConfig,
-                    id: newInstance.id
-                });
-            }
-            catch (error) {
-                logger.error(`Failed to auto-connect server instance for ${name}:`, error, LOG_MODULES.HUB_MANAGER);
-            }
-        }
         eventBus.publish(EventTypes.SERVER_INSTANCE_ADDED, { name, instance: newInstance });
         return newInstance;
     }

package/dist/server/src/utils/json-utils.d.ts

@@ -24,6 +24,7 @@ type ConfigGetter = () => {
             jsonPretty: boolean;
             mcpCommDebug: boolean;
             apiDebug: boolean;
+            gatewayDebug: boolean;
         };
     };
 };
@@ -65,6 +66,12 @@ export declare function getMcpCommDebugSetting(): boolean;
  * @returns boolean indicating whether to enable API debug logging
  */
 export declare function getApiDebugSetting(): boolean;
+/**
+ * Get Gateway debug setting from config getter.
+ *
+ * @returns boolean indicating whether to enable Gateway debug logging
+ */
+export declare function getGatewayDebugSetting(): boolean;
 /**
  * Stringify object for logging with dynamic pretty formatting based on LOG_JSON_PRETTY environment variable
  * @param obj Object to stringify

package/dist/server/src/utils/json-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/json-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAiED;;GAEG;AACH,KAAK,YAAY,GAAG,MAAM;IACxB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC;YACpB,YAAY,EAAE,OAAO,CAAC;YACtB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAiB9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAClD,MAAM,CAOR"}
+{"version":3,"file":"json-utils.d.ts","sourceRoot":"","sources":["../../../../src/utils/json-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAiED;;GAEG;AACH,KAAK,YAAY,GAAG,MAAM;IACxB,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,OAAO,CAAC;YACpB,YAAY,EAAE,OAAO,CAAC;YACtB,QAAQ,EAAE,OAAO,CAAC;YAClB,YAAY,EAAE,OAAO,CAAC;SACvB,CAAC;KACH,CAAC;CACH,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAiB9C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAUhD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,OAAO,EACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAClD,MAAM,CAOR"}

package/dist/server/src/utils/json-utils.js

@@ -181,6 +181,23 @@ export function getApiDebugSetting() {
     }
     return getDefaultForDevMode(false);
 }
+/**
+ * Get Gateway debug setting from config getter.
+ *
+ * @returns boolean indicating whether to enable Gateway debug logging
+ */
+export function getGatewayDebugSetting() {
+    if (_configGetter) {
+        try {
+            const config = _configGetter();
+            return config.system.logging.gatewayDebug;
+        }
+        catch {
+            // Fall through to default if config getter fails
+        }
+    }
+    return getDefaultForDevMode(false);
+}
 /**
  * Stringify object for logging with dynamic pretty formatting based on LOG_JSON_PRETTY environment variable
  * @param obj Object to stringify

package/dist/server/src/utils/logger/log-modules.d.ts

@@ -117,6 +117,9 @@ export declare const LOG_MODULES: {
     readonly NOTIFICATIONS_MESSAGE: {
         module: string;
     };
+    readonly STDERR: {
+        module: string;
+    };
     /**
      * Creates a dynamic log module for custom or runtime-generated module names.
      * Use this for server-specific logging or other dynamic contexts.

package/dist/server/src/utils/logger/log-modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-modules.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/log-modules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8DtB;;;;;;;;;;;OAWG;mCACmB,MAAM;;;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,WAAW,EAAE,SAAS,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"log-modules.d.ts","sourceRoot":"","sources":["../../../../../src/utils/logger/log-modules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiEtB;;;;;;;;;;;OAWG;mCACmB,MAAM;;;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,WAAW,EAAE,SAAS,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC"}

package/dist/server/src/utils/logger/log-modules.js

@@ -65,6 +65,8 @@ export const LOG_MODULES = {
     MCP_STATUS: { module: 'MCPStatus' },
     // Notifications
     NOTIFICATIONS_MESSAGE: { module: 'notifications/message' },
+    // Stderr output
+    STDERR: { module: 'stderr' },
     /**
      * Creates a dynamic log module for custom or runtime-generated module names.
      * Use this for server-specific logging or other dynamic contexts.

package/dist/server/src/utils/port-checker.d.ts

@@ -13,4 +13,22 @@ export interface PortCheckResult {
  * Check if port is in use
  */
 export declare function checkPort(port: number): Promise<PortCheckResult>;
+/**
+ * Checks port availability and exits process if port is in use.
+ *
+ * This function checks if the specified port is already occupied and handles
+ * conflict scenarios with detailed error messages.
+ *
+ * @param port - The port number to check
+ * @returns Promise that resolves when port is available, never rejects
+ *
+ * @example
+ * ```typescript
+ * await checkPortWithExit(7788);
+ * // If port is available, continues execution
+ * // If port is in use by this project, shows error and exits with code 1
+ * // If port is in use by another application, shows error and exits with code 1
+ * ```
+ */
+export declare function checkPortWithExit(port: number): Promise<void>;
 //# sourceMappingURL=port-checker.d.ts.map

package/dist/server/src/utils/port-checker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"port-checker.d.ts","sourceRoot":"","sources":["../../../../src/utils/port-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAatE"}
+{"version":3,"file":"port-checker.d.ts","sourceRoot":"","sources":["../../../../src/utils/port-checker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAatE;AAmPD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BnE"}

package/dist/server/src/utils/port-checker.js

@@ -5,6 +5,7 @@
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import { PidManager } from '../pid/manager.js';
+import { logger, LOG_MODULES } from './logger.js';
 const execAsync = promisify(exec);
 /**
  * Check if port is in use
@@ -240,3 +241,40 @@ async function isSelfProjectProcess(pid, commandLine) {
     ];
     return projectSignatures.some((signature) => commandLine.includes(signature));
 }
+/**
+ * Checks port availability and exits process if port is in use.
+ *
+ * This function checks if the specified port is already occupied and handles
+ * conflict scenarios with detailed error messages.
+ *
+ * @param port - The port number to check
+ * @returns Promise that resolves when port is available, never rejects
+ *
+ * @example
+ * ```typescript
+ * await checkPortWithExit(7788);
+ * // If port is available, continues execution
+ * // If port is in use by this project, shows error and exits with code 1
+ * // If port is in use by another application, shows error and exits with code 1
+ * ```
+ */
+export async function checkPortWithExit(port) {
+    const portCheck = await checkPort(port);
+    if (portCheck.inUse) {
+        if (portCheck.isSelfProject) {
+            logger.error(`MCP Hub Lite is already running on port ${port} (PID: ${portCheck.pid})`, LOG_MODULES.SERVER);
+            logger.error(`Use 'npm run stop' or 'mcp-hub-lite stop' to stop the running instance.`, LOG_MODULES.SERVER);
+        }
+        else {
+            logger.error(`Port ${port} is already in use by another application:`, LOG_MODULES.SERVER);
+            if (portCheck.processName) {
+                logger.error(`  Process: ${portCheck.processName} (PID: ${portCheck.pid})`, LOG_MODULES.SERVER);
+            }
+            if (portCheck.commandLine) {
+                logger.error(`  Command: ${portCheck.commandLine}`, LOG_MODULES.SERVER);
+            }
+            logger.error(`Please stop the conflicting application or use a different port.`, LOG_MODULES.SERVER);
+        }
+        process.exit(1);
+    }
+}

package/dist/server/src/utils/transports/stdio-transport.d.ts

@@ -6,6 +6,8 @@ import { PassThrough } from 'stream';
 export interface StdioTransportOptions {
     compositeKey?: string;
     logStorage?: LogStorageService;
+    readyPatterns?: string[];
+    readyTimeout: number;
 }
 /**
  * A transport implementation for communicating with MCP (Model Context Protocol) servers
@@ -30,6 +32,8 @@ export declare class StdioTransport implements Transport {
     private _compositeKey?;
     private _logStorage?;
     private _stderrStream;
+    private _readyPatterns?;
+    private _readyTimeout;
     onclose?: () => void;
     onerror?: (error: Error) => void;
     onmessage?: (message: JSONRPCMessage) => void;
@@ -56,6 +60,14 @@ export declare class StdioTransport implements Transport {
      * @throws {Error} If the transport is already started
      */
     start(): Promise<void>;
+    /**
+     * Waits for the server to emit a ready pattern in stderr.
+     *
+     * @param patterns - Array of string patterns to match (any match = ready)
+     * @param timeout - Timeout in milliseconds
+     * @returns Promise that resolves when a pattern is matched, or rejects on timeout
+     */
+    private waitForReady;
     /**
      * Gets the stderr stream for the child process.
      *

package/dist/server/src/utils/transports/stdio-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../../../../src/utils/transports/stdio-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,aAAa,CAA4B;IAE1C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;;;;;OAMG;gBACS,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAiB/F;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C5B;;;;;;OAMG;IACH,IAAI,MAAM,uBAET;IAED;;;;OAIG;IACH,IAAW,GAAG,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}
+{"version":3,"file":"stdio-transport.d.ts","sourceRoot":"","sources":["../../../../../src/utils/transports/stdio-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,qBAAqB,EACtB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,cAAc,CAAC,CAAW;IAClC,OAAO,CAAC,aAAa,CAAkB;IAEhC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC;;;;;;OAMG;gBACS,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAmB/F;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2D5B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;;;;OAMG;IACH,IAAI,MAAM,uBAET;IAED;;;;OAIG;IACH,IAAW,GAAG,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;;;OAOG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/server/src/utils/transports/stdio-transport.js

@@ -1,5 +1,5 @@
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { logger } from '../logger.js';
+import { logger, LOG_MODULES } from '../logger.js';
 import { PassThrough } from 'stream';
 /**
  * A transport implementation for communicating with MCP (Model Context Protocol) servers
@@ -24,6 +24,8 @@ export class StdioTransport {
     _compositeKey;
     _logStorage;
     _stderrStream = null;
+    _readyPatterns;
+    _readyTimeout = 120000;
     onclose;
     onerror;
     onmessage;
@@ -49,6 +51,8 @@ export class StdioTransport {
         this._serverName = serverName;
         this._compositeKey = options?.compositeKey;
         this._logStorage = options?.logStorage;
+        this._readyPatterns = options?.readyPatterns;
+        this._readyTimeout = options?.readyTimeout ?? 120000;
         this._stderrStream = new PassThrough();
     }
     /**
@@ -76,6 +80,12 @@ export class StdioTransport {
         };
         // Start the underlying transport
         await this._transport.start();
+        // Ready detection: wait for server to output ready pattern
+        if (this._readyPatterns && this._readyPatterns.length > 0) {
+            logger.info(`Waiting for server ready patterns: ${JSON.stringify(this._readyPatterns)}`, LOG_MODULES.STDIO_TRANSPORT);
+            await this.waitForReady(this._readyPatterns, this._readyTimeout);
+            logger.info(`Server ready pattern detected, proceeding with MCP handshake`, LOG_MODULES.STDIO_TRANSPORT);
+        }
         // Handle stderr data by listening to the transport's stderr stream
         if (this._transport.stderr) {
             this._transport.stderr.on('data', (chunk) => {
@@ -86,7 +96,10 @@ export class StdioTransport {
                 this.onstderr?.(dataStr);
                 // Log stderr output (per MCP spec, stderr is not necessarily errors)
                 const serverIdentifier = this._compositeKey || this._serverName || 'Unknown Server';
-                logger.serverLog('info', serverIdentifier, dataStr, { pid: this.pid });
+                logger.serverLog('info', serverIdentifier, dataStr, {
+                    pid: this.pid,
+                    module: LOG_MODULES.STDERR.module
+                });
                 if (this._logStorage && this._compositeKey) {
                     this._logStorage.append(this._compositeKey, 'info', dataStr);
                 }
@@ -98,6 +111,42 @@ export class StdioTransport {
             });
         }
     }
+    /**
+     * Waits for the server to emit a ready pattern in stderr.
+     *
+     * @param patterns - Array of string patterns to match (any match = ready)
+     * @param timeout - Timeout in milliseconds
+     * @returns Promise that resolves when a pattern is matched, or rejects on timeout
+     */
+    waitForReady(patterns, timeout) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                reject(new Error(`Server did not emit any ready pattern within ${timeout}ms`));
+            }, timeout);
+            // Hook into stderr before it's set up in start()
+            // The ready detection needs to intercept stderr BEFORE the normal stderr handler
+            const readyStderrHandler = (chunk) => {
+                const dataStr = chunk.toString('utf8').trim();
+                if (!dataStr)
+                    return;
+                // Check if any pattern matches
+                for (const pattern of patterns) {
+                    if (dataStr.includes(pattern)) {
+                        clearTimeout(timeoutId);
+                        // Remove this listener - normal stderr handling will be set up in start()
+                        this._transport.stderr?.off('data', readyStderrHandler);
+                        logger.info(`Server ready pattern matched: "${pattern}"`, LOG_MODULES.STDIO_TRANSPORT);
+                        resolve();
+                        return;
+                    }
+                }
+            };
+            // Add the ready detection listener to stderr
+            if (this._transport.stderr) {
+                this._transport.stderr.on('data', readyStderrHandler);
+            }
+        });
+    }
     /**
      * Gets the stderr stream for the child process.
      *

package/dist/server/src/utils/transports/transport-factory.d.ts

@@ -7,12 +7,16 @@ export declare class TransportFactory {
      * Create transport client
      * @param server Server configuration, including base configuration and instance configuration
      * @param compositeKey Optional composite key (serverName-serverIndex) for log storage integration
+     * @param options Optional transport options including readyPatterns and readyTimeout
      * @returns Transport client instance
      * @throws Error if server type is not supported or configuration is invalid
      */
     static createTransport(server: ServerRuntimeConfig & {
         name: string;
-    }, compositeKey?: string): import('@modelcontextprotocol/sdk/shared/transport.js').Transport;
+    }, compositeKey?: string, options?: {
+        readyPatterns?: string[];
+        readyTimeout?: number;
+    }): import('@modelcontextprotocol/sdk/shared/transport.js').Transport;
     /**
      * Build system environment variables
      * Add necessary system environment variables for stdio transport

package/dist/server/src/utils/transports/transport-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport-factory.d.ts","sourceRoot":"","sources":["../../../../../src/utils/transports/transport-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAC9C,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,+CAA+C,EAAE,SAAS;IA6DpE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAW7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CA8CxC"}
+{"version":3,"file":"transport-factory.d.ts","sourceRoot":"","sources":["../../../../../src/utils/transports/transport-factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,EAAE,mBAAmB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAC9C,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,+CAA+C,EAAE,SAAS;IA+DpE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAW7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CA8CxC"}

package/dist/server/src/utils/transports/transport-factory.js

@@ -10,10 +10,11 @@ export class TransportFactory {
      * Create transport client
      * @param server Server configuration, including base configuration and instance configuration
      * @param compositeKey Optional composite key (serverName-serverIndex) for log storage integration
+     * @param options Optional transport options including readyPatterns and readyTimeout
      * @returns Transport client instance
      * @throws Error if server type is not supported or configuration is invalid
      */
-    static createTransport(server, compositeKey) {
+    static createTransport(server, compositeKey, options) {
         const transportConfig = this.validateAndConvertConfig(server);
         // Use type assertion to ensure TypeScript can correctly infer types
         const config = transportConfig;
@@ -30,7 +31,9 @@ export class TransportFactory {
                     stderr: 'pipe'
                 }, server.name, {
                     compositeKey,
-                    logStorage: compositeKey ? logStorage : undefined
+                    logStorage: compositeKey ? logStorage : undefined,
+                    readyPatterns: options?.readyPatterns,
+                    readyTimeout: options?.readyTimeout ?? 120000
                 });
             case 'sse':
                 if (!config.url) {

package/dist/server/tests/integration/gateway/fault-tolerance.test.js

@@ -1,6 +1,7 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import { mcpConnectionManager } from '../../../src/services/mcp-connection-manager.js';
 import { hubManager } from '../../../src/services/hub-manager.service.js';
+import { configManager } from '../../../src/config/config-manager.js';
 import { resolveInstanceConfig } from '../../../src/config/config-migrator.js';
 // Mock MCP SDK Client
 const mockConnect = vi.fn();
@@ -32,8 +33,17 @@ vi.mock('@utils/transports/transport-factory.js', () => {
 describe('Gateway Fault Tolerance', () => {
     let mockServerInstance;
     beforeEach(async () => {
-        // Clear all mocks
+        // Clear mock call history
         vi.clearAllMocks();
+        // Mock config to reduce retry delay in tests (maxRetries: 1, delay: 10ms)
+        vi.spyOn(configManager, 'getConfig').mockReturnValue({
+            system: {
+                startup: {
+                    maxConnectRetries: 1,
+                    connectRetryDelay: 10
+                }
+            }
+        });
         // Add test server (v1.1 format)
         await hubManager.addServer('test-server', {
             command: 'node',
@@ -51,7 +61,8 @@ describe('Gateway Fault Tolerance', () => {
         };
     });
     it('should handle connection failure gracefully', async () => {
-        mockConnect.mockRejectedValueOnce(new Error('Connection failed'));
+        // Use mockRejectedValue instead of mockRejectedValueOnce to avoid retry delay
+        mockConnect.mockRejectedValue(new Error('Connection failed'));
         // Directly use hubManager.getServerById to get complete server configuration
         const serverInfo = hubManager.getServerById(mockServerInstance.id);
         if (!serverInfo) {

package/dist/server/tests/integration/gateway/mcp-connection.test.js

@@ -1,6 +1,7 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import { mcpConnectionManager } from '../../../src/services/mcp-connection-manager.js';
 import { hubManager } from '../../../src/services/hub-manager.service.js';
+import { configManager } from '../../../src/config/config-manager.js';
 import { resolveInstanceConfig } from '../../../src/config/config-migrator.js';
 // Mock MCP SDK Client
 const mockConnect = vi.fn();
@@ -34,8 +35,17 @@ describe('MCP Connection Integration', () => {
     let serverId;
     let serverIndex;
     beforeEach(async () => {
-        // Clear all mocks
+        // Clear mock call history but keep implementations
         vi.clearAllMocks();
+        // Mock config to reduce retry delay in tests (maxRetries: 1, delay: 10ms)
+        vi.spyOn(configManager, 'getConfig').mockReturnValue({
+            system: {
+                startup: {
+                    maxConnectRetries: 1,
+                    connectRetryDelay: 10
+                }
+            }
+        });
         // Add test server (v1.1 format)
         await hubManager.addServer(serverName, {
             command: 'node',
@@ -74,7 +84,8 @@ describe('MCP Connection Integration', () => {
         expect(status?.connected).toBe(true);
     });
     it('should handle connection errors properly', async () => {
-        mockConnect.mockRejectedValueOnce(new Error('Connection refused'));
+        // Use mockRejectedValue instead of mockRejectedValueOnce to avoid retry delay
+        mockConnect.mockRejectedValue(new Error('Connection refused'));
         const serverInfo = hubManager.getServerById(serverId);
         if (!serverInfo) {
             throw new Error('Server not found');

package/dist/server/tests/unit/config/config-migrator.test.js

@@ -45,7 +45,8 @@ describe('Config Migrator', () => {
                 rotationAge: '7d',
                 jsonPretty: true,
                 mcpCommDebug: false,
-                apiDebug: false
+                apiDebug: false,
+                gatewayDebug: false
             }
         },
         security: {
@@ -111,7 +112,8 @@ describe('Config Migrator', () => {
                         rotationAge: '7d',
                         jsonPretty: true,
                         mcpCommDebug: false,
-                        apiDebug: false
+                        apiDebug: false,
+                        gatewayDebug: false
                     }
                 },
                 security: {

package/dist/server/tests/unit/config/config.schema.test.js

@@ -217,7 +217,8 @@ describe('Config Schema (v1.1)', () => {
                         rotationAge: '7d',
                         jsonPretty: true,
                         mcpCommDebug: false,
-                        apiDebug: false
+                        apiDebug: false,
+                        gatewayDebug: false
                     }
                 },
                 security: {