@loop_ouroboros/mcp-hub-lite 1.2.1 → 1.2.3

package/dist/server/src/cli/commands/use-guide.js

@@ -0,0 +1,175 @@
+import { Command } from 'commander';
+/**
+ * CLI use guide content
+ */
+const USE_GUIDE_CONTENT = `# MCP Hub Lite CLI Use Guide
+
+## Overview
+
+MCP Hub Lite CLI provides command-line interface for managing MCP servers. This guide covers CLI-specific usage only.
+
+## Commands
+
+### start
+
+Start the MCP Hub Lite server.
+
+\`\`\`bash
+# Start in daemon mode (default)
+mcp-hub-lite start
+
+# Start in foreground mode
+mcp-hub-lite start --foreground
+
+# Start with custom port
+mcp-hub-lite start --port 8080
+\`\`\`
+
+### stop
+
+Stop the running MCP Hub Lite server.
+
+\`\`\`bash
+mcp-hub-lite stop
+\`\`\`
+
+### status
+
+Display server status and connected MCP servers.
+
+\`\`\`bash
+mcp-hub-lite status
+\`\`\`
+
+### ui
+
+Open the web UI in default browser.
+
+\`\`\`bash
+mcp-hub-lite ui
+\`\`\`
+
+### list
+
+List all configured MCP servers.
+
+\`\`\`bash
+mcp-hub-lite list
+\`\`\`
+
+### restart
+
+Restart the MCP Hub Lite server.
+
+\`\`\`bash
+mcp-hub-lite restart
+\`\`\`
+
+### install
+
+Add a new MCP server to MCP Hub Lite.
+
+**Parametric Mode:**
+
+\`\`\`bash
+# stdio server
+mcp-hub-lite install github-mcp "npx github-mcp" --env API_KEY=xxx
+
+# HTTP server
+mcp-hub-lite install api-server https://api.example.com/mcp -t streamable-http -H "Authorization: Bearer xxx"
+\`\`\`
+
+**JSON Mode:**
+
+\`\`\`bash
+# stdio server
+mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp","env":{"API_KEY":"xxx"}}'
+
+# HTTP server
+mcp-hub-lite install --json '{"name":"api-server","type":"streamable-http","url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer xxx"}}'
+\`\`\`
+
+**Options:**
+
+| Option                     | Description                                                  |
+| -------------------------- | ------------------------------------------------------------ |
+| \`-t, --transport <type>\`   | Transport type: stdio, sse, streamable-http (default: stdio) |
+| \`-e, --env <env...>\`       | Environment variables (KEY=VALUE)                            |
+| \`-H, --header <header...>\` | HTTP headers (Header-Key: Value)                             |
+| \`--timeout <seconds>\`      | Timeout in seconds (default: 60)                             |
+| \`--strategy <strategy>\`    | Instance selection: random, round-robin, tag-match-unique    |
+| \`-a, --auto-start\`         | Auto-start server (default: true)                            |
+| \`--no-auto-start\`          | Disable auto-start                                           |
+| \`-d, --description <desc>\` | Server description                                           |
+
+**JSON Config Fields:**
+
+| Field                       | Required    | Description                     |
+| --------------------------- | ----------- | ------------------------------- |
+| \`name\`                      | Yes         | Server name                     |
+| \`type\`                      | No          | Transport type (default: stdio) |
+| \`command\`                   | Yes (stdio) | Command to execute              |
+| \`url\`                       | Yes (HTTP)  | Server URL                      |
+| \`args\`                      | No          | Command arguments               |
+| \`env\`                       | No          | Environment variables object    |
+| \`headers\`                   | No          | HTTP headers object             |
+| \`timeout\`                   | No          | Timeout in seconds              |
+| \`enabled\`                   | No          | Auto-start enabled              |
+| \`description\`               | No          | Server description              |
+| \`instanceSelectionStrategy\` | No          | Instance selection strategy     |
+
+### tool-use
+
+Manage MCP server tools via API.
+
+\`\`\`bash
+# List all connected servers
+mcp-hub-lite tool-use list-servers
+
+# List system tools
+mcp-hub-lite tool-use list-tools
+
+# List tools from specific server
+mcp-hub-lite tool-use list-tools --server baidu-search
+
+# Get tool schema
+mcp-hub-lite tool-use get-tool --tool list_tools
+
+# Call a tool
+mcp-hub-lite tool-use call-tool --tool search --server baidu-search --args '{"query":"天气"}'
+\`\`\`
+
+**Options:**
+
+| Option            | Description                                 |
+| ----------------- | ------------------------------------------- |
+| \`--server <name>\` | Server name (default: mcp-hub-lite)         |
+| \`--tool <name>\`   | Tool name (required for get-tool/call-tool) |
+| \`--args <json>\`   | Tool arguments JSON                         |
+| \`--tags <json>\`   | Instance selection tags                     |
+
+**JSON Merge Form:**
+
+\`\`\`bash
+# All parameters in one JSON
+mcp-hub-lite tool-use call-tool --args '{"server":"baidu-search","tool":"search","query":"天气"}'
+\`\`\`
+
+---
+
+_Last updated: 2026-04-20_
+`;
+/**
+ * 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 const useGuideCommand = new Command('use-guide')
+    .description('Output CLI usage guide in Markdown format')
+    .action(() => {
+    process.stdout.write(USE_GUIDE_CONTENT);
+    process.exit(0);
+});

package/dist/server/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8CpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAkBnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgDpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAoBnC"}

package/dist/server/src/cli/index.js

@@ -14,6 +14,8 @@ import { uiCommand } from './commands/ui.js';
 import { listCommand } from './commands/list.js';
 import { restartCommand } from './commands/restart.js';
 import { toolUseCommand } from './commands/tool-use.js';
+import { installCommand } from './commands/install.js';
+import { useGuideCommand } from './commands/use-guide.js';
 /**
  * Check if the CLI is being executed directly (vs imported as module)
  * Handles Windows/npm symlink path resolution issues by comparing package paths
@@ -112,6 +114,8 @@ export function createCli() {
     program.addCommand(listCommand);
     program.addCommand(restartCommand);
     program.addCommand(toolUseCommand);
+    program.addCommand(installCommand);
+    program.addCommand(useGuideCommand);
     return program;
 }
 // Execute the CLI if this file is run directly

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

@@ -176,5 +176,76 @@ export declare function listServers(): Promise<{
     name: string;
     config: import("../config/config-manager.js").ServerConfig;
 }[]>;
+/**
+ * Options for installing a new MCP server.
+ */
+export interface InstallServerOptions {
+    name: string;
+    command?: string;
+    url?: string;
+    transport: 'stdio' | 'sse' | 'streamable-http';
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+    timeout: number;
+    autoStart: boolean;
+    instanceSelectionStrategy: 'random' | 'round-robin' | 'tag-match-unique';
+    description?: string;
+}
+/**
+ * Installs a new MCP server via the web API.
+ *
+ * This function sends a POST request to the /web/servers endpoint to add a new
+ * server configuration. If the instance selection strategy is not 'random', it
+ * sends an additional PUT request to update the strategy.
+ *
+ * @param options - Server installation options
+ * @param host - Server host address
+ * @param port - Server port number
+ * @returns Promise that resolves when installation completes
+ * @throws Error if the server already exists or the API request fails
+ *
+ * @example
+ * ```typescript
+ * await installServer({
+ *   name: 'github-mcp',
+ *   command: 'npx github-mcp',
+ *   transport: 'stdio',
+ *   env: { API_KEY: 'xxx' },
+ *   timeout: 60,
+ *   autoStart: true,
+ *   instanceSelectionStrategy: 'random'
+ * }, 'localhost', 7788);
+ * ```
+ */
+export declare function installServer(options: InstallServerOptions, host: string, port: number): Promise<void>;
+/**
+ * Parses environment variable flags into a key-value object.
+ *
+ * @param envFlags - Array of environment variables in KEY=VALUE format
+ * @returns Record of environment variable key-value pairs
+ * @throws Error if the format is invalid
+ *
+ * @example
+ * ```typescript
+ * parseEnvVars(['API_KEY=xxx', 'DEBUG=true'])
+ * // Returns: { API_KEY: 'xxx', DEBUG: 'true' }
+ * ```
+ */
+export declare function parseEnvVars(envFlags: string[]): Record<string, string>;
+/**
+ * Parses HTTP header flags into a key-value object.
+ *
+ * @param headerFlags - Array of headers in "Key: Value" format
+ * @returns Record of header key-value pairs
+ * @throws Error if the format is invalid
+ *
+ * @example
+ * ```typescript
+ * parseHeaders(['Authorization: Bearer xxx', 'Content-Type: application/json'])
+ * // Returns: { Authorization: 'Bearer xxx', 'Content-Type': 'application/json' }
+ * ```
+ */
+export declare function parseHeaders(headerFlags: string[]): Record<string, string>;
 export {};
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,iBAO5C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0CjF;AAgED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW;;;;;;;;;;;;;;;;;;;KAUhC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,iBAO5C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0CjF;AAgED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW;;;;;;;;;;;;;;;;;;;KAUhC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB,EAAE,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB1E"}

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

@@ -244,3 +244,141 @@ export async function listServers() {
         instances: serverInstances[server.name] || []
     }));
 }
+/**
+ * Installs a new MCP server via the web API.
+ *
+ * This function sends a POST request to the /web/servers endpoint to add a new
+ * server configuration. If the instance selection strategy is not 'random', it
+ * sends an additional PUT request to update the strategy.
+ *
+ * @param options - Server installation options
+ * @param host - Server host address
+ * @param port - Server port number
+ * @returns Promise that resolves when installation completes
+ * @throws Error if the server already exists or the API request fails
+ *
+ * @example
+ * ```typescript
+ * await installServer({
+ *   name: 'github-mcp',
+ *   command: 'npx github-mcp',
+ *   transport: 'stdio',
+ *   env: { API_KEY: 'xxx' },
+ *   timeout: 60,
+ *   autoStart: true,
+ *   instanceSelectionStrategy: 'random'
+ * }, 'localhost', 7788);
+ * ```
+ */
+export async function installServer(options, host, port) {
+    // Build request payload
+    const payload = {
+        name: options.name,
+        config: {
+            type: options.transport,
+            command: options.command,
+            url: options.url,
+            args: options.args || [],
+            env: options.env || {},
+            headers: options.headers || {},
+            timeout: options.timeout * 1000,
+            enabled: options.autoStart,
+            description: options.description,
+            instanceSelectionStrategy: options.instanceSelectionStrategy !== 'random'
+                ? options.instanceSelectionStrategy
+                : undefined
+        }
+    };
+    // Call POST /web/servers to install
+    const response = await fetch(`http://${host}:${port}/web/servers`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload)
+    });
+    if (!response.ok) {
+        const errorData = (await response.json().catch(() => ({ message: response.statusText })));
+        const errorMessage = errorData.message || response.statusText;
+        if (errorMessage.includes('already exists')) {
+            throw new Error(`Server "${options.name}" already exists`);
+        }
+        throw new Error(`Failed to install server: ${errorMessage}`);
+    }
+    // If strategy is not random, update via PUT
+    if (options.instanceSelectionStrategy !== 'random') {
+        const putResponse = await fetch(`http://${host}:${port}/web/servers/${options.name}`, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ instanceSelectionStrategy: options.instanceSelectionStrategy })
+        });
+        if (!putResponse.ok) {
+            const errorData = (await putResponse
+                .json()
+                .catch(() => ({ message: putResponse.statusText })));
+            throw new Error(`Server installed but failed to set strategy: ${errorData.message || putResponse.statusText}`);
+        }
+    }
+}
+/**
+ * Parses environment variable flags into a key-value object.
+ *
+ * @param envFlags - Array of environment variables in KEY=VALUE format
+ * @returns Record of environment variable key-value pairs
+ * @throws Error if the format is invalid
+ *
+ * @example
+ * ```typescript
+ * parseEnvVars(['API_KEY=xxx', 'DEBUG=true'])
+ * // Returns: { API_KEY: 'xxx', DEBUG: 'true' }
+ * ```
+ */
+export function parseEnvVars(envFlags) {
+    const env = {};
+    for (const item of envFlags) {
+        const equalIndex = item.indexOf('=');
+        if (equalIndex === -1) {
+            throw new Error(`Invalid env format: ${item}, expected KEY=VALUE`);
+        }
+        const key = item.substring(0, equalIndex);
+        const value = item.substring(equalIndex + 1);
+        if (!key) {
+            throw new Error(`Invalid env format: ${item}, KEY cannot be empty`);
+        }
+        if (value === undefined) {
+            throw new Error(`Invalid env format: ${item}, VALUE cannot be empty`);
+        }
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * Parses HTTP header flags into a key-value object.
+ *
+ * @param headerFlags - Array of headers in "Key: Value" format
+ * @returns Record of header key-value pairs
+ * @throws Error if the format is invalid
+ *
+ * @example
+ * ```typescript
+ * parseHeaders(['Authorization: Bearer xxx', 'Content-Type: application/json'])
+ * // Returns: { Authorization: 'Bearer xxx', 'Content-Type': 'application/json' }
+ * ```
+ */
+export function parseHeaders(headerFlags) {
+    const headers = {};
+    for (const item of headerFlags) {
+        const colonIndex = item.indexOf(':');
+        if (colonIndex === -1) {
+            throw new Error(`Invalid header format: ${item}, expected "Key: Value"`);
+        }
+        const key = item.substring(0, colonIndex).trim();
+        const value = item.substring(colonIndex + 1).trim();
+        if (!key) {
+            throw new Error(`Invalid header format: ${item}, KEY cannot be empty`);
+        }
+        if (!value) {
+            throw new Error(`Invalid header format: ${item}, VALUE cannot be empty`);
+        }
+        headers[key] = value;
+    }
+    return headers;
+}

package/dist/server/src/cli/use-guide.md

@@ -0,0 +1,156 @@
+# MCP Hub Lite CLI Use Guide
+
+## Overview
+
+MCP Hub Lite CLI provides command-line interface for managing MCP servers. This guide covers CLI-specific usage only.
+
+## Commands
+
+### start
+
+Start the MCP Hub Lite server.
+
+```bash
+# Start in daemon mode (default)
+mcp-hub-lite start
+
+# Start in foreground mode
+mcp-hub-lite start --foreground
+
+# Start with custom port
+mcp-hub-lite start --port 8080
+```
+
+### stop
+
+Stop the running MCP Hub Lite server.
+
+```bash
+mcp-hub-lite stop
+```
+
+### status
+
+Display server status and connected MCP servers.
+
+```bash
+mcp-hub-lite status
+```
+
+### ui
+
+Open the web UI in default browser.
+
+```bash
+mcp-hub-lite ui
+```
+
+### list
+
+List all configured MCP servers.
+
+```bash
+mcp-hub-lite list
+```
+
+### restart
+
+Restart the MCP Hub Lite server.
+
+```bash
+mcp-hub-lite restart
+```
+
+### install
+
+Add a new MCP server to MCP Hub Lite.
+
+**Parametric Mode:**
+
+```bash
+# stdio server
+mcp-hub-lite install github-mcp "npx github-mcp" --env API_KEY=xxx
+
+# HTTP server
+mcp-hub-lite install api-server https://api.example.com/mcp -t streamable-http -H "Authorization: Bearer xxx"
+```
+
+**JSON Mode:**
+
+```bash
+# stdio server
+mcp-hub-lite install --json '{"name":"github-mcp","type":"stdio","command":"npx github-mcp","env":{"API_KEY":"xxx"}}'
+
+# HTTP server
+mcp-hub-lite install --json '{"name":"api-server","type":"streamable-http","url":"https://api.example.com/mcp","headers":{"Authorization":"Bearer xxx"}}'
+```
+
+**Options:**
+
+| Option                     | Description                                                  |
+| -------------------------- | ------------------------------------------------------------ |
+| `-t, --transport <type>`   | Transport type: stdio, sse, streamable-http (default: stdio) |
+| `-e, --env <env...>`       | Environment variables (KEY=VALUE)                            |
+| `-H, --header <header...>` | HTTP headers (Header-Key: Value)                             |
+| `--timeout <seconds>`      | Timeout in seconds (default: 60)                             |
+| `--strategy <strategy>`    | Instance selection: random, round-robin, tag-match-unique    |
+| `-a, --auto-start`         | Auto-start server (default: true)                            |
+| `--no-auto-start`          | Disable auto-start                                           |
+| `-d, --description <desc>` | Server description                                           |
+
+**JSON Config Fields:**
+
+| Field                       | Required    | Description                     |
+| --------------------------- | ----------- | ------------------------------- |
+| `name`                      | Yes         | Server name                     |
+| `type`                      | No          | Transport type (default: stdio) |
+| `command`                   | Yes (stdio) | Command to execute              |
+| `url`                       | Yes (HTTP)  | Server URL                      |
+| `args`                      | No          | Command arguments               |
+| `env`                       | No          | Environment variables object    |
+| `headers`                   | No          | HTTP headers object             |
+| `timeout`                   | No          | Timeout in seconds              |
+| `enabled`                   | No          | Auto-start enabled              |
+| `description`               | No          | Server description              |
+| `instanceSelectionStrategy` | No          | Instance selection strategy     |
+
+### tool-use
+
+Manage MCP server tools via API.
+
+```bash
+# List all connected servers
+mcp-hub-lite tool-use list-servers
+
+# List system tools
+mcp-hub-lite tool-use list-tools
+
+# List tools from specific server
+mcp-hub-lite tool-use list-tools --server baidu-search
+
+# Get tool schema
+mcp-hub-lite tool-use get-tool --tool list_tools
+
+# Call a tool
+mcp-hub-lite tool-use call-tool --tool search --server baidu-search --args '{"query":"天气"}'
+```
+
+**Options:**
+
+| Option            | Description                                 |
+| ----------------- | ------------------------------------------- |
+| `--server <name>` | Server name (default: mcp-hub-lite)         |
+| `--tool <name>`   | Tool name (required for get-tool/call-tool) |
+| `--args <json>`   | Tool arguments JSON                         |
+| `--tags <json>`   | Instance selection tags                     |
+
+**JSON Merge Form:**
+
+```bash
+# All parameters in one JSON
+mcp-hub-lite tool-use call-tool --args '{"server":"baidu-search","tool":"search","query":"天气"}'
+```
+
+---
+
+_Last updated: 2026-04-20_

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
     });