@loop_ouroboros/mcp-hub-lite 1.2.1 → 1.2.3

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/cli/commands/install.d.ts

@@ -0,0 +1,25 @@
+import { Command } from 'commander';
+/**
+ * CLI command for installing a new MCP server to MCP Hub Lite.
+ *
+ * This command provides two modes of operation:
+ *
+ * 1. **Parametric mode** (default): Specify server properties via individual options
+ * 2. **JSON mode** (--json): Pass a complete server configuration as JSON
+ *
+ * ## Parametric Mode
+ *
+ * ```
+ * mcp-hub-lite install <name> <commandOrUrl> [args...]
+ * ```
+ *
+ * ## JSON Mode
+ *
+ * ```
+ * mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp"}'
+ * ```
+ *
+ * @returns {Command} The configured install command instance for registration with Commander.js
+ */
+export declare const installCommand: Command;
+//# sourceMappingURL=install.d.ts.map

package/dist/server/src/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,SA6EvB,CAAC"}

package/dist/server/src/cli/commands/install.js

@@ -0,0 +1,274 @@
+import { Command } from 'commander';
+import { getServerStatus, installServer } from '../server.js';
+import { parseEnvVars, parseHeaders } from '../server.js';
+/**
+ * CLI command for installing a new MCP server to MCP Hub Lite.
+ *
+ * This command provides two modes of operation:
+ *
+ * 1. **Parametric mode** (default): Specify server properties via individual options
+ * 2. **JSON mode** (--json): Pass a complete server configuration as JSON
+ *
+ * ## Parametric Mode
+ *
+ * ```
+ * mcp-hub-lite install <name> <commandOrUrl> [args...]
+ * ```
+ *
+ * ## JSON Mode
+ *
+ * ```
+ * mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp"}'
+ * ```
+ *
+ * @returns {Command} The configured install command instance for registration with Commander.js
+ */
+export const installCommand = new Command('install')
+    .description('Add a new MCP server to MCP Hub Lite')
+    .argument('[name]', 'Server name (required in parametric mode)')
+    .argument('[commandOrUrl]', 'Command (stdio) or URL (sse/streamable-http)')
+    .argument('[args...]', 'Command arguments (stdio only)')
+    .option('-j, --json <config>', 'Server configuration as JSON')
+    .option('-t, --transport <type>', 'Transport type (stdio, sse, streamable-http)', 'stdio')
+    .option('-e, --env <env...>', 'Environment variables (KEY=VALUE)')
+    .option('-H, --header <header...>', 'HTTP headers (Header-Key: Value)')
+    .option('--timeout <seconds>', 'Timeout in seconds', parseInt, 60)
+    .option('--strategy <strategy>', 'Instance selection strategy (random, round-robin, tag-match-unique)', 'random')
+    .option('-a, --auto-start', 'Auto-start the server', true)
+    .option('--no-auto-start', 'Disable auto-start')
+    .option('-d, --description <description>', 'Server description')
+    .addHelpText('after', `
+
+Modes:
+  This command supports two modes - parametric (default) and JSON.
+
+  # Parametric mode (individual options):
+  mcp-hub-lite install github-mcp "npx github-mcp" --env API_KEY=xxx
+
+  # JSON mode (complete config):
+  mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp","env":{"API_KEY":"xxx"}}'
+
+JSON config fields:
+  name (required)           - Server name
+  type                      - Transport type: stdio, sse, streamable-http (default: stdio)
+  command                   - Command for stdio transport
+  url                       - URL for sse/streamable-http transport
+  args                      - Command arguments (stdio)
+  env                       - Environment variables object
+  headers                   - HTTP headers object
+  timeout                   - Timeout in seconds (default: 60)
+  enabled                   - Auto-start enabled (default: true)
+  description               - Server description
+  instanceSelectionStrategy - random, round-robin, tag-match-unique (default: random)
+
+Examples:
+  # Parametric mode
+  mcp-hub-lite install github-mcp "npx github-mcp" --env API_KEY=xxx
+  mcp-hub-lite install api-server https://api.example.com/mcp -t streamable-http -H "Authorization: Bearer xxx"
+
+  # JSON mode
+  mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp","env":{"API_KEY":"xxx"}}'
+  mcp-hub-lite install --json '{"name":"api-server","type":"streamable-http","url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer xxx"}}'
+`)
+    .action(async (name, commandOrUrl, args, options) => {
+    try {
+        // Check if server is running and get connection info
+        const status = await getServerStatus();
+        if (!status.running) {
+            console.error('Error: MCP Hub Lite server is not running.');
+            console.error('Start the server with: mcp-hub-lite start');
+            process.exit(1);
+        }
+        // JSON mode
+        if (options.json) {
+            await handleJsonMode(options.json, status.host, status.port);
+            return;
+        }
+        // Parametric mode
+        await handleParametricMode(name, commandOrUrl, args, options, status.host, status.port);
+    }
+    catch (error) {
+        console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+});
+/**
+ * Handles JSON mode - installs server from complete JSON config
+ */
+async function handleJsonMode(jsonConfig, host, port) {
+    let config;
+    // Parse JSON
+    try {
+        config = JSON.parse(jsonConfig);
+    }
+    catch {
+        console.error('Error: Invalid JSON format in --json option');
+        process.exit(1);
+    }
+    // Validate required fields
+    if (!config.name) {
+        console.error('Error: "name" field is required in JSON config');
+        process.exit(1);
+    }
+    // Validate transport type
+    const transport = config.type || 'stdio';
+    if (!['stdio', 'sse', 'streamable-http'].includes(transport)) {
+        console.error(`Error: Invalid transport type "${config.type}"`);
+        console.error('Valid types: stdio, sse, streamable-http');
+        process.exit(1);
+    }
+    // Validate command/url based on transport
+    const isHttpTransport = transport !== 'stdio';
+    if (isHttpTransport && !config.url) {
+        console.error(`Error: "url" field is required for transport type "${transport}"`);
+        process.exit(1);
+    }
+    if (!isHttpTransport && !config.command) {
+        console.error(`Error: "command" field is required for transport type "${transport}"`);
+        process.exit(1);
+    }
+    // Validate URL format for HTTP transports
+    if (isHttpTransport && config.url) {
+        try {
+            new URL(config.url);
+        }
+        catch {
+            console.error(`Error: Invalid URL "${config.url}"`);
+            process.exit(1);
+        }
+    }
+    // Build install options
+    const installOptions = {
+        name: config.name,
+        ...(isHttpTransport
+            ? { url: config.url }
+            : { command: config.command, args: config.args || [] }),
+        transport: transport,
+        env: config.env || {},
+        headers: config.headers || {},
+        timeout: config.timeout || 60,
+        autoStart: config.enabled !== false,
+        instanceSelectionStrategy: config.instanceSelectionStrategy || 'random',
+        description: config.description
+    };
+    // Install the server
+    await installServer(installOptions, host, port);
+    console.log(`Successfully installed server: ${config.name}`);
+    console.log(`  Type: ${transport}`);
+    if (isHttpTransport) {
+        console.log(`  URL: ${config.url}`);
+    }
+    else {
+        console.log(`  Command: ${config.command}`);
+    }
+    if (Object.keys(installOptions.env).length > 0) {
+        console.log(`  Env: ${JSON.stringify(installOptions.env)}`);
+    }
+    if (Object.keys(installOptions.headers).length > 0) {
+        console.log(`  Headers: ${JSON.stringify(installOptions.headers)}`);
+    }
+    if (installOptions.instanceSelectionStrategy !== 'random') {
+        console.log(`  Strategy: ${installOptions.instanceSelectionStrategy}`);
+    }
+    if (config.description) {
+        console.log(`  Description: ${config.description}`);
+    }
+}
+/**
+ * Handles parametric mode - installs server from individual options
+ */
+async function handleParametricMode(name, commandOrUrl, args, options, host, port) {
+    // Validate required positional arguments
+    if (!name) {
+        console.error('Error: Server name is required in parametric mode');
+        console.error('Or use --json mode for complete config: mcp-hub-lite install --json \'{"name":"..."}\'');
+        process.exit(1);
+    }
+    if (!commandOrUrl) {
+        console.error('Error: Command or URL is required in parametric mode');
+        console.error('Or use --json mode for complete config: mcp-hub-lite install --json \'{"name":"..."}\'');
+        process.exit(1);
+    }
+    // Determine transport type
+    const transportLower = options.transport.toLowerCase();
+    if (!['stdio', 'sse', 'streamable-http'].includes(transportLower)) {
+        console.error(`Error: Invalid transport type "${options.transport}"`);
+        console.error('Valid types: stdio, sse, streamable-http');
+        process.exit(1);
+    }
+    // Parse environment variables
+    let env = {};
+    if (options.env && options.env.length > 0) {
+        try {
+            env = parseEnvVars(options.env);
+        }
+        catch (error) {
+            console.error(`Error: Invalid env format - ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    }
+    // Parse HTTP headers
+    let headers = {};
+    if (options.header && options.header.length > 0) {
+        try {
+            headers = parseHeaders(options.header);
+        }
+        catch (error) {
+            console.error(`Error: Invalid header format - ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    }
+    // Determine if this is a URL (sse/streamable-http) or command (stdio)
+    const isHttpTransport = transportLower !== 'stdio';
+    // Validate that URL is provided for HTTP transports
+    if (isHttpTransport) {
+        try {
+            new URL(commandOrUrl);
+        }
+        catch {
+            console.error(`Error: Invalid URL "${commandOrUrl}" for transport type "${transportLower}"`);
+            process.exit(1);
+        }
+    }
+    // Parse strategy
+    const strategyLower = options.strategy.toLowerCase();
+    if (!['random', 'round-robin', 'tag-match-unique'].includes(strategyLower)) {
+        console.error(`Error: Invalid strategy "${options.strategy}"`);
+        console.error('Valid strategies: random, round-robin, tag-match-unique');
+        process.exit(1);
+    }
+    // Build install options
+    const installOptions = {
+        name,
+        ...(isHttpTransport ? { url: commandOrUrl } : { command: commandOrUrl, args }),
+        transport: transportLower,
+        env,
+        headers,
+        timeout: options.timeout,
+        autoStart: options.autoStart,
+        instanceSelectionStrategy: strategyLower,
+        description: options.description
+    };
+    // Install the server
+    await installServer(installOptions, host, port);
+    console.log(`Successfully installed server: ${name}`);
+    console.log(`  Type: ${transportLower}`);
+    if (isHttpTransport) {
+        console.log(`  URL: ${commandOrUrl}`);
+    }
+    else {
+        console.log(`  Command: ${commandOrUrl}`);
+    }
+    if (Object.keys(env).length > 0) {
+        console.log(`  Env: ${JSON.stringify(env)}`);
+    }
+    if (Object.keys(headers).length > 0) {
+        console.log(`  Headers: ${JSON.stringify(headers)}`);
+    }
+    if (strategyLower !== 'random') {
+        console.log(`  Strategy: ${strategyLower}`);
+    }
+    if (options.description) {
+        console.log(`  Description: ${options.description}`);
+    }
+}

package/dist/server/src/cli/commands/use-guide.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+/**
+ * CLI command for displaying the use guide in Markdown format.
+ *
+ * This command outputs the CLI usage guide, similar to how MCP Hub Lite
+ * provides a use-guide resource for MCP protocol usage.
+ *
+ * @returns {Command} The configured use-guide command instance for registration with Commander.js
+ */
+export declare const useGuideCommand: Command;
+//# sourceMappingURL=use-guide.d.ts.map

package/dist/server/src/cli/commands/use-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-guide.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/use-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmKpC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,SAKxB,CAAC"}