@loop_ouroboros/mcp-hub-lite 1.2.1 → 1.2.2

package/dist/server/shared/models/server.model.d.ts

@@ -160,6 +160,7 @@ export declare const ServerTemplateSchema: z.ZodObject<{
         "round-robin": "round-robin";
         "tag-match-unique": "tag-match-unique";
     }>>;
+    readyPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ServerTemplate = z.infer<typeof ServerTemplateSchema>;
 /**
@@ -190,6 +191,7 @@ export declare const ServerConfigSchema: z.ZodObject<{
             "round-robin": "round-robin";
             "tag-match-unique": "tag-match-unique";
         }>>;
+        readyPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
     instances: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -229,6 +231,7 @@ export declare const LoggingConfigSchema: z.ZodDefault<z.ZodObject<{
     jsonPretty: z.ZodDefault<z.ZodBoolean>;
     mcpCommDebug: z.ZodDefault<z.ZodBoolean>;
     apiDebug: z.ZodDefault<z.ZodBoolean>;
+    gatewayDebug: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>>;
 export type LoggingConfig = z.infer<typeof LoggingConfigSchema>;
 /**
@@ -242,6 +245,17 @@ export declare const SecurityConfigSchema: z.ZodDefault<z.ZodObject<{
     maxConnections: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>>;
 export type SecurityConfig = z.infer<typeof SecurityConfigSchema>;
+/**
+ * Startup Configuration Schema
+ * Unified configuration for server startup behavior
+ */
+export declare const StartupConfigSchema: z.ZodDefault<z.ZodObject<{
+    startupDelay: z.ZodDefault<z.ZodNumber>;
+    readyTimeout: z.ZodDefault<z.ZodNumber>;
+    maxConnectRetries: z.ZodDefault<z.ZodNumber>;
+    connectRetryDelay: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;
+export type StartupConfig = z.infer<typeof StartupConfigSchema>;
 /**
  * System Configuration Schema (v1.1 - Primary)
  */
@@ -265,7 +279,14 @@ export declare const SystemConfigSchema: z.ZodObject<{
             jsonPretty: z.ZodDefault<z.ZodBoolean>;
             mcpCommDebug: z.ZodDefault<z.ZodBoolean>;
             apiDebug: z.ZodDefault<z.ZodBoolean>;
+            gatewayDebug: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
+        startup: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+            startupDelay: z.ZodDefault<z.ZodNumber>;
+            readyTimeout: z.ZodDefault<z.ZodNumber>;
+            maxConnectRetries: z.ZodDefault<z.ZodNumber>;
+            connectRetryDelay: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
     security: z.ZodDefault<z.ZodObject<{
         allowedNetworks: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -298,6 +319,7 @@ export declare const SystemConfigSchema: z.ZodObject<{
                 "round-robin": "round-robin";
                 "tag-match-unique": "tag-match-unique";
             }>>;
+            readyPatterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>;
         instances: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;

package/dist/server/shared/models/server.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.model.d.ts","sourceRoot":"","sources":["../../../../shared/models/server.model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.model.d.ts","sourceRoot":"","sources":["../../../../shared/models/server.model.ts"],"names":[],"mappings":"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"}

package/dist/server/shared/models/server.model.js

@@ -129,7 +129,10 @@ export const ServerTemplateSchema = ServerEnvConfigSchema.extend({
         InstanceSelectionStrategy.ROUND_ROBIN,
         InstanceSelectionStrategy.TAG_MATCH_UNIQUE
     ])
-        .optional()
+        .optional(),
+    // Ready patterns for startup detection (stdout/stderr output containing any pattern = server ready)
+    // Using .optional() without .default() - code should use readyPatterns ?? [] for default value
+    readyPatterns: z.array(z.string()).optional()
 });
 // ====== Server Config Schema (v1.1) ======
 /**
@@ -151,14 +154,16 @@ export const LoggingConfigSchema = z
     rotationAge: z.string().default('7d'),
     jsonPretty: z.boolean().default(true),
     mcpCommDebug: z.boolean().default(false),
-    apiDebug: z.boolean().default(false)
+    apiDebug: z.boolean().default(false),
+    gatewayDebug: z.boolean().default(false)
 })
     .default({
     level: 'info',
     rotationAge: '7d',
     jsonPretty: true,
     mcpCommDebug: false,
-    apiDebug: false
+    apiDebug: false,
+    gatewayDebug: false
 });
 // ====== Security Configuration Schema ======
 /**
@@ -181,6 +186,28 @@ export const SecurityConfigSchema = z
     idleConnectionTimeout: 300000,
     maxConnections: 50
 });
+// ====== Startup Configuration Schema ======
+/**
+ * Startup Configuration Schema
+ * Unified configuration for server startup behavior
+ */
+export const StartupConfigSchema = z
+    .object({
+    // Sequential startup delay between instances (ms)
+    startupDelay: z.number().min(0).max(60000).default(3000),
+    // Ready pattern detection timeout (ms)
+    readyTimeout: z.number().min(10000).max(300000).default(120000),
+    // Maximum connection retry attempts
+    maxConnectRetries: z.number().min(0).max(10).default(3),
+    // Base delay for exponential backoff retry (ms)
+    connectRetryDelay: z.number().min(1000).max(30000).default(5000)
+})
+    .default({
+    startupDelay: 3000,
+    readyTimeout: 120000,
+    maxConnectRetries: 3,
+    connectRetryDelay: 5000
+});
 // ====== System Configuration Schema ======
 /**
  * System Configuration Schema (v1.1 - Primary)
@@ -193,7 +220,9 @@ export const SystemConfigSchema = z.object({
         port: z.number().default(7788),
         language: z.enum(['zh', 'en']).default('zh'),
         theme: z.enum(['light', 'dark', 'system']).default('system'),
-        logging: LoggingConfigSchema
+        logging: LoggingConfigSchema,
+        // Using .optional() without .default() - code should use startup ?? {defaults} for default value
+        startup: StartupConfigSchema.optional()
     })
         .default({
         host: 'localhost',
@@ -205,7 +234,14 @@ export const SystemConfigSchema = z.object({
             rotationAge: '7d',
             jsonPretty: true,
             mcpCommDebug: false,
-            apiDebug: false
+            apiDebug: false,
+            gatewayDebug: false
+        },
+        startup: {
+            startupDelay: 3000,
+            readyTimeout: 120000,
+            maxConnectRetries: 3,
+            connectRetryDelay: 5000
         }
     }),
     security: SecurityConfigSchema,

package/dist/server/src/api/mcp/gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../../../src/api/mcp/gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAM7E;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,iBAqH9D"}
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../../../src/api/mcp/gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAU7E;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,iBA6H9D"}

package/dist/server/src/api/mcp/gateway.js

@@ -3,7 +3,7 @@
  * Handles all MCP protocol requests at /mcp endpoint
  */
 import { logger, LOG_MODULES } from '../../utils/logger/index.js';
-import { stringifyForLogging, getMcpCommDebugSetting } from '../../utils/json-utils.js';
+import { stringifyForLogging, getMcpCommDebugSetting, getGatewayDebugSetting } from '../../utils/json-utils.js';
 import { wrapReplyForDebug } from './debug-response-wrapper.js';
 import { createSessionTransport } from '../../services/gateway/global-transport.js';
 /**
@@ -44,17 +44,25 @@ export async function mcpGatewayRoutes(fastify) {
         wrapReplyForDebug(reply, '');
         reply.hijack();
         try {
-            logger.debug(`About to create session transport for MCP request`, LOG_MODULES.GATEWAY);
+            if (getGatewayDebugSetting()) {
+                logger.debug(`About to create session transport for MCP request`, LOG_MODULES.GATEWAY);
+            }
             const { transport, server } = await createSessionTransport();
-            logger.debug(`Created session transport successfully, handling MCP request`, LOG_MODULES.GATEWAY);
+            if (getGatewayDebugSetting()) {
+                logger.debug(`Created session transport successfully, handling MCP request`, LOG_MODULES.GATEWAY);
+            }
             try {
                 await transport.handleRequest(request.raw, reply.raw, request.body);
-                logger.debug(`Successfully handled MCP request with server: ${server.constructor.name}`, LOG_MODULES.GATEWAY);
+                if (getGatewayDebugSetting()) {
+                    logger.debug(`Successfully handled MCP request with server: ${server.constructor.name}`, LOG_MODULES.GATEWAY);
+                }
             }
             finally {
                 // Resources will be automatically cleaned up by garbage collection
                 // since transport and server are local to this request scope
-                logger.debug(`Session transport request completed, resources will be GC'd`, LOG_MODULES.GATEWAY);
+                if (getGatewayDebugSetting()) {
+                    logger.debug(`Session transport request completed, resources will be GC'd`, LOG_MODULES.GATEWAY);
+                }
             }
         }
         catch (error) {

package/dist/server/src/api/web/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,iBAkF/D"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,iBA6G/D"}

package/dist/server/src/api/web/resources.js

@@ -64,8 +64,32 @@ export async function webResourceRoutes(fastify) {
             // Use hubToolsService.readResource to handle Hub URI -> MCP URI conversion
             // This properly maps hub://servers/{name}/{instanceIndex}/{mcpPath} to MCP native URI
             try {
-                // hubToolsService.readResource already returns MCP format for forwarding case
-                return await hubToolsService.readResource(uri);
+                const result = await hubToolsService.readResource(uri);
+                // Check if result is already in MCP ReadResourceResult format { contents: [...] }
+                if (result && typeof result === 'object' && 'contents' in result) {
+                    return result;
+                }
+                // Wrap non-MCP format results into { contents: [...] } format
+                // This handles: ServerMetadata, Tool[], Resource[], string (use-guide), etc.
+                let mimeType = 'application/json';
+                let text;
+                if (typeof result === 'string') {
+                    mimeType = 'text/markdown';
+                    text = result;
+                }
+                else {
+                    mimeType = 'application/json';
+                    text = JSON.stringify(result, null, 2);
+                }
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType,
+                            text
+                        }
+                    ]
+                };
             }
             catch (error) {
                 const errorObj = error;

package/dist/server/src/config/config-loader.js

@@ -75,7 +75,7 @@ export function loadConfig(configPath, autoMigrate = true) {
                 if (parsed.success) {
                     const configWithSortedServers = {
                         ...parsed.data,
-                        servers: Object.fromEntries(Object.entries(parsed.data.servers).sort(([a], [b]) => a.localeCompare(b)))
+                        servers: Object.fromEntries(Object.entries(parsed.data.servers).sort(([a], [b]) => a[0].localeCompare(b[0])))
                     };
                     // Ensure all server instances have proper indexes
                     for (const serverName of Object.keys(configWithSortedServers.servers)) {

package/dist/server/src/config/config-migrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-migrator.d.ts","sourceRoot":"","sources":["../../../../src/config/config-migrator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAkB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAyMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAwDjG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAMnE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAsCA;AAID;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7C,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB,GAAG,IAAI,CA+B5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAC5C,KAAK,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAapE"}
+{"version":3,"file":"config-migrator.d.ts","sourceRoot":"","sources":["../../../../src/config/config-migrator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAkB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AA0MD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,CAwDjG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAMnE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAyBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAsCA;AAID;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAC7C,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB,GAAG,IAAI,CA+B5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAC5C,KAAK,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAapE"}

package/dist/server/src/config/config-migrator.js

@@ -53,6 +53,7 @@ function convertToServerTemplate(v1Config) {
         url: v1Config.url,
         aggregatedTools: v1Config.allowedTools || [],
         description: v1Config.description
+        // readyPatterns is optional and will default to undefined
     };
 }
 /**

package/dist/server/src/index.js

@@ -27,9 +27,6 @@
  * # Start server in foreground for debugging
  * mcp-hub-lite start --foreground
  *
- * # Start in STDIO mode for MCP protocol
- * mcp-hub-lite start --stdio
- *
  * # Stop the running server
  * mcp-hub-lite stop
  *
@@ -64,13 +61,12 @@ program.name('mcp-hub-lite').description('MCP Hub Lite CLI').version('0.0.1');
 program
     .command('start')
     .description('Start the MCP Hub Lite server')
-    .option('--stdio', 'Run in stdio mode for MCP protocol')
     .option('-p, --port <number>', 'Port to run on')
     .option('-h, --host <string>', 'Host to bind to')
     .option('-f, --foreground', 'Run in foreground (blocking)')
     .action(async (options) => {
-    // Daemon mode by default unless --foreground or --stdio is specified
-    if (!options.foreground && !options.stdio) {
+    // Daemon mode by default unless --foreground is specified
+    if (!options.foreground) {
         const args = [process.argv[1], 'start', '--foreground'];
         if (options.port)
             args.push('--port', options.port);
@@ -145,7 +141,6 @@ program
         process.exit(0);
     }
     await runServer({
-        stdio: options.stdio,
         port: options.port ? parseInt(options.port) : undefined,
         host: options.host
     });

package/dist/server/src/server/dev-server.js

@@ -1,9 +1,9 @@
 import { buildApp } from '../app.js';
 import { configManager } from '../config/config-manager.js';
-import { resolveInstanceConfig } from '../config/config-migrator.js';
 import { logger, LOG_MODULES } from '../utils/logger.js';
 import { mcpConnectionManager } from '../services/mcp-connection-manager.js';
 import { PidManager } from '../pid/manager.js';
+import { collectConnectTasks, executeConnectTasks, ensureServerInstances } from './startup.js';
 // Set log level to debug for development server
 logger.setLevel('debug');
 // Enable dev logging to file (this also enables communication debug logging)
@@ -17,7 +17,6 @@ let app = null;
  * - Debug-level logging enabled for detailed development insights
  * - Development log file output for persistent debugging information
  * - Automatic connection to all enabled MCP servers configured in the system
- * - OpenTelemetry tracing initialization for observability
  * - PID file management for process tracking
  * - Graceful shutdown handling for SIGTERM and SIGINT signals
  *
@@ -55,7 +54,6 @@ let app = null;
  * @see {@link buildApp} - Creates the Fastify application instance
  * @see {@link configManager} - Manages server configuration and MCP server instances
  * @see {@link mcpConnectionManager} - Handles MCP server connections and communication
- * @see {@link telemetryManager} - Manages OpenTelemetry tracing and observability
  * @see {@link PidManager} - Handles PID file creation and cleanup
  */
 async function startDevServer() {
@@ -67,50 +65,7 @@ async function startDevServer() {
         logger.info('------------------------------------------------', LOG_MODULES.DEV_SERVER);
         app = await buildApp();
         const config = configManager.getConfig();
-        // Auto-connect to enabled servers
-        logger.info('Initializing server connections...', LOG_MODULES.DEV_SERVER);
-        const serverConfigs = configManager.getServers();
-        for (const { name: serverName, config: serverConfig } of serverConfigs) {
-            // Check if there are existing instances
-            const existingInstances = configManager.getServerInstancesByName(serverName);
-            if (existingInstances.length === 0) {
-                // Auto-create instance for enabled servers
-                try {
-                    const newInstance = await configManager.addServerInstance(serverName, {});
-                    // Connect the new instance
-                    const resolvedConfig = resolveInstanceConfig(serverConfig, newInstance.id);
-                    if (resolvedConfig && resolvedConfig.enabled !== false) {
-                        mcpConnectionManager
-                            .connect(serverName, newInstance.index ?? 0, {
-                            ...resolvedConfig,
-                            id: newInstance.id
-                        })
-                            .catch((err) => {
-                            logger.error(`Failed to auto-connect to ${serverName}:`, err, LOG_MODULES.DEV_SERVER);
-                        });
-                    }
-                }
-                catch (err) {
-                    logger.error(`Failed to create instance for ${serverName}:`, err, LOG_MODULES.DEV_SERVER);
-                }
-            }
-            else {
-                // Connect existing instances
-                existingInstances.forEach((instance) => {
-                    if (instance.enabled !== false) {
-                        const resolvedConfig = resolveInstanceConfig(serverConfig, instance.id);
-                        if (resolvedConfig) {
-                            mcpConnectionManager
-                                .connect(serverName, instance.index ?? 0, { ...resolvedConfig, id: instance.id })
-                                .catch((err) => {
-                                logger.error(`Failed to auto-connect to ${serverName}:`, err, LOG_MODULES.DEV_SERVER);
-                            });
-                        }
-                    }
-                });
-            }
-        }
-        // Listen on configured port
+        // Start listening FIRST, then trigger connection tasks
         await app.listen({
             port: config.system.port,
             host: config.system.host
@@ -118,6 +73,13 @@ async function startDevServer() {
         logger.info(`MCP Hub Lite Dev Server running at http://${config.system.host}:${config.system.port}`, LOG_MODULES.DEV_SERVER);
         // Write PID file after server starts successfully
         PidManager.writePid();
+        // Auto-create instances for enabled servers without existing instances
+        await ensureServerInstances(LOG_MODULES.DEV_SERVER);
+        // Trigger connection tasks (fire-and-forget, with sequential delay)
+        logger.info('Initializing server connections...', LOG_MODULES.DEV_SERVER);
+        const tasks = collectConnectTasks();
+        const baseDelay = config.system.startup?.startupDelay ?? 3000;
+        executeConnectTasks(tasks, baseDelay, LOG_MODULES.DEV_SERVER);
     }
     catch (err) {
         logger.error('Failed to start dev server:', err, LOG_MODULES.DEV_SERVER);
@@ -132,7 +94,6 @@ async function startDevServer() {
  * This function performs a clean shutdown sequence to ensure:
  * - All MCP server connections are properly disconnected
  * - The Fastify HTTP server is closed gracefully
- * - OpenTelemetry tracing resources are properly shut down
  * - PID file is removed to prevent stale process detection
  * - All resources are cleaned up before process exit
  *

package/dist/server/src/server/runner.d.ts

@@ -1,27 +1,21 @@
 /**
- * Starts the MCP Hub Lite server in either HTTP mode or stdio MCP gateway mode.
+ * Starts the MCP Hub Lite server.
  *
  * This function is the main entry point for running the MCP Hub Lite server in production.
- * It handles two distinct operational modes:
- *
- * 1. **HTTP Server Mode** (default): Runs a full Fastify HTTP server with REST API,
- *    WebSocket support, and web interface on the specified host and port.
- *
- * 2. **Stdio MCP Gateway Mode**: Runs as an MCP (Model Context Protocol) gateway
- *    that communicates via stdin/stdout streams, suitable for integration with
- *    MCP-compatible clients like IDEs or AI assistants.
+ * It handles the HTTP server mode with REST API, WebSocket support, and web interface
+ * on the specified host and port.
  *
  * The function performs the following key operations:
- * - Validates and checks port availability (HTTP mode only)
- * - Automatically connects to all enabled MCP servers from configuration
+ * - Validates and checks port availability
+ * - Starts the Fastify HTTP server
+ * - Triggers connection to all enabled MCP servers from configuration
  * - Sets up graceful shutdown handlers for SIGTERM and SIGINT signals
  * - Manages PID file creation and cleanup for process tracking
  * - Handles both successful startup and error scenarios with appropriate logging
  *
  * @param options - Configuration options for server startup
- * @param options.stdio - When true, runs in stdio MCP gateway mode instead of HTTP server mode
- * @param options.port - Override the configured port number (HTTP mode only)
- * @param options.host - Override the configured host address (HTTP mode only)
+ * @param options.port - Override the configured port number
+ * @param options.host - Override the configured host address
  *
  * @returns Promise that resolves when the server is successfully started,
  *          or rejects with an error if startup fails
@@ -30,27 +24,21 @@
  *                 or other critical issues. The process will exit with code 1 in such cases.
  *
  * @example
- * // Start in default HTTP mode
+ * // Start with default config
  * await runServer();
  *
  * @example
- * // Start in stdio MCP gateway mode
- * await runServer({ stdio: true });
- *
- * @example
- * // Start HTTP server on custom port and host
+ * // Start on custom port and host
  * await runServer({ port: 8080, host: '0.0.0.0' });
  *
  * @remarks
- * - In HTTP mode, the function will check if the specified port is already in use
- *   and provide detailed error messages for port conflicts
- * - In stdio mode, port checking is skipped as no network ports are used
+ * - The function will check if the specified port is already in use and provide
+ *   detailed error messages for port conflicts
  * - The function automatically connects to all enabled servers configured in .mcp-hub.json
  * - Graceful shutdown ensures proper cleanup of connections and PID files when receiving termination signals
  * - This function is typically called from the CLI entry point (`src/index.ts`)
  */
 export declare function runServer(options?: {
-    stdio?: boolean;
     port?: number;
     host?: string;
 }): Promise<void>;

package/dist/server/src/server/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/server/runner.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,iBAuI9F"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/server/runner.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,iBAuD7E"}