@loop_ouroboros/mcp-hub-lite 1.2.2 → 1.2.3

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/services/gateway/request-handlers/initialize-handler.d.ts.map

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loop_ouroboros/mcp-hub-lite",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "A lightweight MCP management platform designed for independent developers",
   "license": "MIT",
   "author": "loop_ouroboros",
@@ -38,10 +38,6 @@
     "start": "node dist/server/src/cli/index.js start",
     "stop": "node dist/server/src/cli/index.js stop",
     "restart": "node dist/server/src/cli/index.js restart",
-    "status": "node dist/server/src/cli/index.js status",
-    "list": "node dist/server/src/cli/index.js list",
-    "ui": "node dist/server/src/cli/index.js ui",
-    "tool-use": "node dist/server/src/cli/index.js tool-use",
     "dev": "run-p dev:client dev:server",
     "dev:client": "vite",
     "dev:server": "tsx src/server/dev-server.ts",