@loop_ouroboros/mcp-hub-lite 1.2.2 → 1.2.4

package/dist/client/assets/{omit-DlmW8Yd6.js → omit-CB4hTeTH.js}

@@ -1 +1 @@
-import{aa as c,bw as f,bs as s,bx as a,bq as l,by as g,ah as b}from"./index-DTZ9o3XO.js";import{g as v,c as O,f as _,e as p}from"./_baseClone-e9R6V78L.js";var y="[object Object]",P=Function.prototype,L=Object.prototype,u=P.toString,w=L.hasOwnProperty,h=u.call(Object);function j(e){if(!c(e)||f(e)!=y)return!1;var r=v(e);if(r===null)return!0;var t=w.call(r,"constructor")&&r.constructor;return typeof t=="function"&&t instanceof t&&u.call(t)==h}function m(e,r,t){var o=-1,n=e.length;r<0&&(r=-r>n?0:n+r),t=t>n?n:t,t<0&&(t+=n),n=r>t?0:t-r>>>0,r>>>=0;for(var i=Array(n);++o<n;)i[o]=e[o+r];return i}function C(e){var r=e==null?0:e.length;return r?e[r-1]:void 0}function A(e,r){return r.length<2?e:s(e,m(r,0,-1))}var S=Object.prototype,E=S.hasOwnProperty;function F(e,r){r=a(r,e);var t=-1,o=r.length;if(!o)return!0;for(;++t<o;){var n=l(r[t]);if(n==="__proto__"&&!E.call(e,"__proto__")||(n==="constructor"||n==="prototype")&&t<o-1)return!1}var i=A(e,r);return i==null||delete i[l(C(r))]}function G(e){return j(e)?void 0:e}var x=1,T=2,N=4,M=g(function(e,r){var t={};if(e==null)return t;var o=!1;r=b(r,function(i){return i=a(i,e),o||(o=i.length>1),i}),O(e,_(e),t),o&&(t=p(t,x|T|N,G));for(var n=r.length;n--;)F(t,r[n]);return t});export{j as i,M as o};
+import{aa as c,bw as f,bs as s,bx as a,bq as l,by as g,ah as b}from"./index-MqHvQjDP.js";import{g as v,c as O,f as _,e as p}from"./_baseClone-kbJbcBJT.js";var y="[object Object]",P=Function.prototype,L=Object.prototype,u=P.toString,w=L.hasOwnProperty,h=u.call(Object);function j(e){if(!c(e)||f(e)!=y)return!1;var r=v(e);if(r===null)return!0;var t=w.call(r,"constructor")&&r.constructor;return typeof t=="function"&&t instanceof t&&u.call(t)==h}function m(e,r,t){var o=-1,n=e.length;r<0&&(r=-r>n?0:n+r),t=t>n?n:t,t<0&&(t+=n),n=r>t?0:t-r>>>0,r>>>=0;for(var i=Array(n);++o<n;)i[o]=e[o+r];return i}function C(e){var r=e==null?0:e.length;return r?e[r-1]:void 0}function A(e,r){return r.length<2?e:s(e,m(r,0,-1))}var S=Object.prototype,E=S.hasOwnProperty;function F(e,r){r=a(r,e);var t=-1,o=r.length;if(!o)return!0;for(;++t<o;){var n=l(r[t]);if(n==="__proto__"&&!E.call(e,"__proto__")||(n==="constructor"||n==="prototype")&&t<o-1)return!1}var i=A(e,r);return i==null||delete i[l(C(r))]}function G(e){return j(e)?void 0:e}var x=1,T=2,N=4,M=g(function(e,r){var t={};if(e==null)return t;var o=!1;r=b(r,function(i){return i=a(i,e),o||(o=i.length>1),i}),O(e,_(e),t),o&&(t=p(t,x|T|N,G));for(var n=r.length;n--;)F(t,r[n]);return t});export{j as i,M as o};

package/dist/client/assets/{raf-CeCd08aN.js → raf-MWAHt9ca.js}

@@ -1 +1 @@
-import{D as o}from"./index-DTZ9o3XO.js";const e=i=>o?window.requestAnimationFrame(i):setTimeout(i,16),r=i=>o?window.cancelAnimationFrame(i):clearTimeout(i);export{r as c,e as r};
+import{D as o}from"./index-MqHvQjDP.js";const e=i=>o?window.requestAnimationFrame(i):setTimeout(i,16),r=i=>o?window.cancelAnimationFrame(i):clearTimeout(i);export{r as c,e as r};

package/dist/client/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" href="/favicon.ico" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>MCP Server Manager</title>
-    <script type="module" crossorigin src="/assets/index-DTZ9o3XO.js"></script>
+    <script type="module" crossorigin src="/assets/index-MqHvQjDP.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/vue-vendor-CbgVSHIh.js">
     <link rel="stylesheet" crossorigin href="/assets/index-DpH6ZSbs.css">
   </head>

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"}

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"}