@loop_ouroboros/mcp-hub-lite 1.0.0

package/dist/server/src/index.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+/**
+ * MCP Hub Lite CLI Entry Point
+ *
+ * This module serves as the primary command-line interface for the MCP Hub Lite application,
+ * providing a comprehensive set of commands to manage the MCP (Model Context Protocol) gateway service.
+ *
+ * The CLI enables users to start, stop, restart, and monitor the MCP Hub Lite server through
+ * intuitive subcommands, making it easy to manage the lifecycle of the MCP gateway service
+ * from the terminal.
+ *
+ * Key Features:
+ * - **Server Management**: Start, stop, restart, and check status of the MCP Hub Lite server
+ * - **Daemon Mode**: Automatically runs the server in background mode with proper log rotation
+ * - **STDIO Mode**: Supports direct STDIO communication for MCP protocol integration
+ * - **Process Monitoring**: Tracks server process via PID files and provides real-time status
+ * - **Web UI Integration**: Opens the web-based management interface directly from CLI
+ * - **Server Listing**: Displays all configured and managed MCP servers in a tabular format
+ * - **Error Handling**: Provides detailed error messages and troubleshooting guidance
+ * - **Log Management**: Implements automatic log rotation for long-running server instances
+ *
+ * Usage Examples:
+ * ```bash
+ * # Start server in background (default)
+ * mcp-hub-lite start
+ *
+ * # 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
+ *
+ * # Check system status
+ * mcp-hub-lite status
+ *
+ * # List all managed MCP servers
+ * mcp-hub-lite list
+ *
+ * # Open web UI
+ * mcp-hub-lite ui
+ * ```
+ *
+ * The CLI automatically handles daemonization when started without the `--foreground` flag,
+ * redirecting logs to rotated log files in the user's home directory under `~/.mcp-hub-lite/logs/`.
+ *
+ * @module src/index
+ * @since 0.0.1
+ * @see {@link https://github.com/modelcontextprotocol} for MCP protocol specification
+ */
+import { Command } from 'commander';
+import { runServer } from './server/runner.js';
+import { configManager } from './config/config-manager.js';
+import { PidManager } from './pid/manager.js';
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+import { LogRotator } from './utils/log-rotator.js';
+const program = new Command();
+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) {
+        const args = [process.argv[1], 'start', '--foreground'];
+        if (options.port)
+            args.push('--port', options.port);
+        if (options.host)
+            args.push('--host', options.host);
+        const logDir = path.join(os.homedir(), '.mcp-hub-lite', 'logs');
+        const logRotator = new LogRotator(logDir, 'mcp-hub', undefined, () => configManager.getConfig());
+        // Rotate old logs before starting
+        logRotator.rotateLogs();
+        const logFile = logRotator.getCurrentLogFilePath();
+        const logStream = fs.openSync(logFile, 'a');
+        console.log(`Starting server in background...`);
+        console.log(`Logs: ${logFile}`);
+        const subprocess = spawn(process.argv[0], args, {
+            detached: true,
+            stdio: ['ignore', logStream, logStream]
+        });
+        subprocess.unref();
+        // Wait for server to initialize and write PID file
+        const startTime = Date.now();
+        const maxWaitTime = 5000; // 5 seconds max wait
+        const checkInterval = 200; // Check every 200ms
+        await new Promise((resolve) => {
+            const checkPid = setInterval(() => {
+                const elapsed = Date.now() - startTime;
+                // Check if PID file exists
+                if (PidManager.pidFileExists()) {
+                    clearInterval(checkPid);
+                    const pid = PidManager.getPid();
+                    console.log(`✓ Server started successfully (PID: ${pid})`);
+                    console.log(`\nAccess the web UI at: http://${options.host || 'localhost'}:${options.port || 7788}`);
+                    resolve();
+                    return;
+                }
+                // Timeout - check if subprocess is still running
+                if (elapsed > maxWaitTime) {
+                    clearInterval(checkPid);
+                    console.error(`\n✗ Server failed to start within ${maxWaitTime}ms`);
+                    // Try to read the last few lines of log to provide helpful error message
+                    try {
+                        const logContent = fs.readFileSync(logFile, 'utf-8');
+                        const logLines = logContent.trim().split('\n');
+                        const recentLines = logLines.slice(-10); // Last 10 lines
+                        // Check for common error patterns
+                        const portInUsePattern = /EADDRINUSE.*:(\d+)/;
+                        const alreadyRunningPattern = /MCP Hub Lite is already running/;
+                        for (const line of recentLines) {
+                            if (alreadyRunningPattern.test(line)) {
+                                console.error(`\n⚠️  MCP Hub Lite is already running!`);
+                                console.error(`   Use 'npm run stop' to stop the existing instance.`);
+                                break;
+                            }
+                            else if (portInUsePattern.test(line)) {
+                                const match = line.match(portInUsePattern);
+                                const port = match ? match[1] : 'unknown';
+                                console.error(`\n⚠️  Port ${port} is already in use by another application.`);
+                                console.error(`   Solutions:`);
+                                console.error(`   1. Stop the application using port ${port}`);
+                                console.error(`   2. Use a different port: npm run start -- --port <PORT>`);
+                                break;
+                            }
+                        }
+                    }
+                    catch {
+                        // Ignore log read errors
+                    }
+                    console.error(`\n📄 Check full logs for details: ${logFile}\n`);
+                    process.exit(1);
+                }
+            }, checkInterval);
+        });
+        process.exit(0);
+    }
+    await runServer({
+        stdio: options.stdio,
+        port: options.port ? parseInt(options.port) : undefined,
+        host: options.host
+    });
+});
+program
+    .command('list')
+    .description('List all managed MCP servers')
+    .action(async () => {
+    const config = configManager.getConfig();
+    const url = `http://${config.system.host}:${config.system.port}/web/servers`;
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timeoutId);
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status}`);
+        const servers = await response.json();
+        console.table(servers);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Failed to list servers:', error.message);
+        console.error('Is the server running?');
+        process.exit(1);
+    }
+});
+program
+    .command('status')
+    .description('Show system status')
+    .action(async () => {
+    const config = configManager.getConfig();
+    const pid = PidManager.getPid();
+    const isRunning = PidManager.isRunning();
+    // ANSI color codes
+    const colors = {
+        reset: '\x1b[0m',
+        bold: '\x1b[1m',
+        cyan: '\x1b[36m',
+        green: '\x1b[32m',
+        red: '\x1b[31m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m'
+    };
+    // Display basic system info
+    console.log(`${colors.bold}MCP Hub Lite - System Status${colors.reset}`);
+    console.log('============================');
+    console.log(`${colors.cyan}Process ID:${colors.reset} ${isRunning ? pid : 'Not running'}`);
+    console.log(`${colors.cyan}Port:${colors.reset} ${config.system.port}`);
+    console.log(`${colors.cyan}Host:${colors.reset} ${config.system.host}`);
+    console.log(`${colors.cyan}Status:${colors.reset} ${isRunning ? `${colors.green}Running${colors.reset}` : `${colors.red}Stopped${colors.reset}`}`);
+    console.log('');
+    // Display MCP connection example
+    console.log(`${colors.bold}MCP Integration:${colors.reset}`);
+    console.log('================');
+    console.log(`${colors.yellow}Endpoint:${colors.reset} http://${config.system.host}:${config.system.port}/mcp`);
+    console.log(`${colors.yellow}Transport:${colors.reset} HTTP-Stream`);
+    console.log('');
+    const mcpClientConfig = {
+        mcpServers: {
+            'mcp-hub-lite': {
+                type: 'http',
+                url: `http://${config.system.host}:${config.system.port}/mcp`
+            }
+        }
+    };
+    console.log(JSON.stringify(mcpClientConfig, null, 2));
+    console.log('');
+    // Try to fetch server list if running
+    if (isRunning) {
+        try {
+            const url = `http://${config.system.host}:${config.system.port}/web/servers`;
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, { signal: controller.signal });
+            clearTimeout(timeoutId);
+            const servers = (await response.json());
+            if (servers.length > 0) {
+                console.log(`${colors.bold}Managed MCP Servers:${colors.reset}`);
+                console.log('===================');
+                console.table(servers);
+            }
+            else {
+                console.log('No managed MCP servers configured.');
+            }
+        }
+        catch (error) {
+            console.error('Warning: Failed to fetch server list:', error.message);
+        }
+    }
+    else {
+        console.log('Server is not running. Start it with: npm run start');
+    }
+    process.exit(0);
+});
+program
+    .command('stop')
+    .description('Stop the running MCP Hub Lite server')
+    .action(() => {
+    const pid = PidManager.getPid();
+    if (!pid) {
+        console.error('No running server found (PID file missing).');
+        process.exit(1);
+    }
+    try {
+        console.log(`Stopping server (PID: ${pid})...`);
+        process.kill(pid, 'SIGTERM');
+        console.log('Stop signal sent.');
+        // Wait a bit for signal to process
+        setTimeout(() => {
+            process.exit(0);
+        }, 100);
+    }
+    catch (error) {
+        if (error.code === 'ESRCH') {
+            console.error('Server process not found (stale PID file?). Cleaning up...');
+            PidManager.removePid();
+            process.exit(0);
+        }
+        else {
+            console.error('Failed to stop server:', error.message);
+            process.exit(1);
+        }
+    }
+});
+program
+    .command('restart')
+    .description('Restart the MCP Hub Lite server')
+    .action(async () => {
+    // 1. Stop
+    const pid = PidManager.getPid();
+    if (pid) {
+        try {
+            console.log(`Stopping server (PID: ${pid})...`);
+            process.kill(pid, 'SIGTERM');
+            // Simple wait loop
+            let tries = 0;
+            while (PidManager.isRunning() && tries < 10) {
+                await new Promise((r) => setTimeout(r, 500));
+                tries++;
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ESRCH')
+                console.error('Error stopping:', error.message);
+        }
+    }
+    // 2. Start
+    // Get the path to the executable (node) and the script (dist/index.js)
+    const args = ['start'];
+    // Check if we are running from node or binary
+    const isNode = process.argv[0].endsWith('node') || process.argv[0].endsWith('node.exe');
+    const childArgs = isNode ? [process.argv[1], ...args] : [...args];
+    try {
+        const child = spawn(process.argv[0], childArgs, {
+            detached: false,
+            stdio: 'inherit',
+            cwd: process.cwd() // Ensure we run in same directory
+        });
+        child.on('close', (code) => {
+            process.exit(code || 0);
+        });
+    }
+    catch (e) {
+        console.error('Failed to restart server:', e.message);
+        process.exit(1);
+    }
+});
+program
+    .command('ui')
+    .description('Open the Web UI')
+    .action(async () => {
+    const config = configManager.getConfig();
+    const url = `http://${config.system.host}:${config.system.port}`;
+    console.log(`Opening Web UI at ${url}...`);
+    const { exec } = await import('child_process');
+    const start = process.platform == 'darwin' ? 'open' : process.platform == 'win32' ? 'start' : 'xdg-open';
+    exec(`${start} ${url}`, (error) => {
+        if (error) {
+            console.error('Failed to open browser:', error.message);
+            process.exit(1);
+        }
+        else {
+            console.log('Browser opened successfully');
+            process.exit(0);
+        }
+    });
+});
+// Handle default execution (if no args provided, maybe just show help or start?)
+// For now, if no args, we default to help.
+// But existing behavior was "start server".
+// To keep backward compatibility or easy usage:
+if (process.argv.length === 2) {
+    // No args provided. We can default to start?
+    // Usually CLI tools show help.
+    // But since this IS the server binary, maybe defaulting to start is better if it's meant to be run as `npm start`.
+    // Let's check package.json scripts. "start": "npm start" -> "node dist/index.js".
+    // If I change it to require "start" subcommand, `npm start` will fail unless I update package.json.
+    // I should update package.json script to "mcp-hub-lite start" or handle default.
+    // I'll update package.json script later. For now, let's make it show help.
+}
+// Parse command-line arguments and execute the appropriate command
+// This is the main entry point that processes all CLI commands
+program.parse();

package/dist/server/src/models/event.model.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Event data models
+ * Contains all data interface definitions used by the event bus
+ */
+import type { ServerConfig, ServerInstanceConfig } from '../config/config.schema.js';
+import type { Tool } from '../../shared/models/tool.model.js';
+import type { Resource } from '../../shared/models/resource.model.js';
+import type { LogLevel } from '../../shared/types/common.types.js';
+export interface ServerAddedEventData {
+    name: string;
+    config: ServerConfig;
+}
+export interface ServerUpdatedEventData {
+    name: string;
+    config: ServerConfig;
+}
+export type ServerDeletedEventData = string;
+export interface ServerInstanceAddedEventData {
+    name: string;
+    instance: ServerInstanceConfig;
+}
+export interface ServerInstanceUpdatedEventData {
+    name: string;
+    index: number;
+    updates: Partial<ServerInstanceConfig>;
+}
+export interface ServerInstanceDeletedEventData {
+    name: string;
+    index: number;
+}
+export interface ServerConnectedEventData {
+    serverId: string;
+    status: 'online';
+    timestamp: number;
+}
+export interface ServerDisconnectedEventData {
+    serverId: string;
+    status: 'offline';
+    timestamp: number;
+}
+export interface ServerStatusChangeEventData {
+    serverId: string;
+    status: 'online' | 'offline' | 'error';
+    error?: string;
+    timestamp: number;
+}
+export interface ToolsUpdatedEventData {
+    serverId: string;
+    tools: Tool[];
+}
+export interface ToolCallStartedEventData {
+    requestId: string;
+    serverId: string;
+    serverName: string;
+    toolName: string;
+    timestamp: number;
+    args: Record<string, unknown>;
+}
+export interface ToolCallCompletedEventData {
+    requestId: string;
+    serverId: string;
+    serverName: string;
+    toolName: string;
+    timestamp: number;
+    result: unknown;
+}
+export interface ToolCallErrorEventData {
+    requestId: string;
+    serverId: string;
+    serverName: string;
+    toolName: string;
+    timestamp: number;
+    error: string;
+    stack?: string;
+}
+export interface ResourcesUpdatedEventData {
+    serverId: string;
+    resources: Resource[];
+}
+export interface LogEntryEventData {
+    serverId: string;
+    logs: Array<{
+        level: LogLevel;
+        message: string;
+        timestamp: number;
+    }>;
+}
+export interface LogsClearedEventData {
+    serverId: string;
+}
+export interface ConfigurationUpdatedEventData {
+    timestamp: number;
+    config: unknown;
+    changes?: unknown;
+}
+export interface ClientConnectedEventData {
+    timestamp: number;
+    client: unknown;
+}
+export interface ClientDisconnectedEventData {
+    timestamp: number;
+    clientId: string;
+    client?: unknown;
+}
+export type EventData = unknown;
+//# sourceMappingURL=event.model.d.ts.map

package/dist/server/src/models/event.model.d.ts.map

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

package/dist/server/src/models/event.model.js

@@ -0,0 +1,5 @@
+/**
+ * Event data models
+ * Contains all data interface definitions used by the event bus
+ */
+export {};

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

@@ -0,0 +1,19 @@
+import type { ServerStatus, ServerTransport } from '../../shared/types/common.types.js';
+import type { ServerConfig as SharedServerConfig } from '../../shared/models/server.model';
+export interface ServerConfig extends Omit<SharedServerConfig, 'type'> {
+    id: string;
+    name: string;
+    command: string;
+    args: string[];
+    type: ServerTransport;
+    enabled: boolean;
+}
+export interface ServerState {
+    status: ServerStatus;
+    lastCheck: number;
+    error?: string;
+    pid?: number;
+}
+export interface Server extends ServerConfig, ServerState {
+}
+//# sourceMappingURL=server.model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.model.d.ts","sourceRoot":"","sources":["../../../../src/models/server.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtF,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,MAAO,SAAQ,YAAY,EAAE,WAAW;CAAG"}

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

@@ -0,0 +1 @@
+export {};

package/dist/server/src/models/system-tools.constants.d.ts

@@ -0,0 +1,73 @@
+/**
+ * System tools constants for MCP Hub Lite
+ * Centralized definition of system tool names and gateway server names
+ */
+export type ListServersParams = Record<string, never>;
+export interface FindServersParams {
+    pattern: string;
+    searchIn?: 'name' | 'description' | 'both';
+    caseSensitive?: boolean;
+}
+export interface ListAllToolsInServerParams {
+    serverName: string;
+    requestOptions?: {
+        sessionId?: string;
+        tags?: Record<string, string>;
+    };
+}
+export interface FindToolsInServerParams {
+    serverName: string;
+    pattern: string;
+    searchIn?: 'name' | 'description' | 'both';
+    caseSensitive?: boolean;
+    requestOptions?: {
+        sessionId?: string;
+        tags?: Record<string, string>;
+    };
+}
+export interface GetToolParams {
+    serverName: string;
+    toolName: string;
+    requestOptions?: {
+        sessionId?: string;
+        tags?: Record<string, string>;
+    };
+}
+export interface CallToolParams {
+    serverName: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    requestOptions?: {
+        sessionId?: string;
+        tags?: Record<string, string>;
+    };
+}
+export interface FindToolsParams {
+    pattern: string;
+    searchIn?: 'name' | 'description' | 'both';
+    caseSensitive?: boolean;
+}
+export type SystemToolArgs = ListServersParams | FindServersParams | ListAllToolsInServerParams | FindToolsInServerParams | GetToolParams | CallToolParams | FindToolsParams;
+export declare const LIST_SERVERS_TOOL = "list_servers";
+export declare const FIND_SERVERS_TOOL = "find_servers";
+export declare const LIST_ALL_TOOLS_IN_SERVER_TOOL = "list_all_tools_in_server";
+export declare const FIND_TOOLS_IN_SERVER_TOOL = "find_tools_in_server";
+export declare const GET_TOOL_TOOL = "get_tool";
+export declare const CALL_TOOL_TOOL = "call_tool";
+export declare const FIND_TOOLS_TOOL = "find_tools";
+/**
+ * List of all system tool names
+ * This array is used to identify system tools across the application
+ */
+export declare const SYSTEM_TOOL_NAMES: readonly ["list_servers", "find_servers", "list_all_tools_in_server", "find_tools_in_server", "get_tool", "call_tool", "find_tools"];
+/**
+ * Type definition for system tool names
+ * Provides type safety when working with system tool names
+ */
+export type SystemToolName = (typeof SYSTEM_TOOL_NAMES)[number];
+/**
+ * MCP Hub Lite server name - represents both the system tools server and the gateway server
+ * This single name is used for both system tool identification and gateway server naming
+ */
+export declare const MCP_HUB_LITE_SERVER = "mcp-hub-lite";
+//# sourceMappingURL=system-tools.constants.d.ts.map

package/dist/server/src/models/system-tools.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-tools.constants.d.ts","sourceRoot":"","sources":["../../../../src/models/system-tools.constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAGD,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,0BAA0B,GAC1B,uBAAuB,GACvB,aAAa,GACb,cAAc,GACd,eAAe,CAAC;AAGpB,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AACxE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sIAQpB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC"}

package/dist/server/src/models/system-tools.constants.js

@@ -0,0 +1,31 @@
+/**
+ * System tools constants for MCP Hub Lite
+ * Centralized definition of system tool names and gateway server names
+ */
+// Individual system tool name constants
+export const LIST_SERVERS_TOOL = 'list_servers';
+export const FIND_SERVERS_TOOL = 'find_servers';
+export const LIST_ALL_TOOLS_IN_SERVER_TOOL = 'list_all_tools_in_server';
+export const FIND_TOOLS_IN_SERVER_TOOL = 'find_tools_in_server';
+export const GET_TOOL_TOOL = 'get_tool';
+export const CALL_TOOL_TOOL = 'call_tool';
+export const FIND_TOOLS_TOOL = 'find_tools';
+/**
+ * List of all system tool names
+ * This array is used to identify system tools across the application
+ */
+export const SYSTEM_TOOL_NAMES = [
+    LIST_SERVERS_TOOL,
+    FIND_SERVERS_TOOL,
+    LIST_ALL_TOOLS_IN_SERVER_TOOL,
+    FIND_TOOLS_IN_SERVER_TOOL,
+    GET_TOOL_TOOL,
+    CALL_TOOL_TOOL,
+    FIND_TOOLS_TOOL
+];
+// Individual gateway server name constant
+/**
+ * MCP Hub Lite server name - represents both the system tools server and the gateway server
+ * This single name is used for both system tool identification and gateway server naming
+ */
+export const MCP_HUB_LITE_SERVER = 'mcp-hub-lite';