@loop_ouroboros/mcp-hub-lite 1.0.0

package/dist/server/src/config/config.schema.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+/**
+ * MCP Server Configuration Schema
+ * Simplified schema for MCP-HUB-LITE Lite version
+ */
+// Server configuration schema (keyed by server name)
+export const ServerConfigSchema = z.object({
+    command: z.string().optional(),
+    args: z.array(z.string()).default([]),
+    env: z.record(z.string(), z.string()).optional(),
+    enabled: z.boolean().default(true),
+    tags: z.record(z.string(), z.string()).optional(),
+    type: z.enum(['stdio', 'sse', 'streamable-http', 'http']).default('stdio'),
+    timeout: z.number().default(60000),
+    url: z.string().optional(),
+    allowedTools: z.array(z.string()).default([]),
+    description: z.string().optional()
+});
+// Server instance schema (each instance contains id, timestamp, hash)
+export const ServerInstanceConfigSchema = z.object({
+    id: z.string(),
+    timestamp: z.number(), // Startup time
+    hash: z.string(),
+    pid: z.number().optional(), // Process ID
+    startTime: z.number().optional() // Startup time (same as timestamp, for compatibility)
+});
+/**
+ * Logging Configuration Schema
+ */
+export const LoggingConfigSchema = z
+    .object({
+    level: z.custom().default('info'),
+    rotationAge: z.string().default('7d'), // e.g., "7d", "30d"
+    jsonPretty: z.boolean().default(true), // Enable pretty JSON formatting in logs
+    mcpCommDebug: z.boolean().default(false), // Enable MCP communication debug logging
+    sessionDebug: z.boolean().default(false) // Enable session debug logging
+})
+    .default({
+    level: 'info',
+    rotationAge: '7d',
+    jsonPretty: true,
+    mcpCommDebug: false,
+    sessionDebug: false
+});
+/**
+ * Security Configuration Schema
+ */
+export const SecurityConfigSchema = z
+    .object({
+    allowedNetworks: z
+        .array(z.string())
+        .default(['127.0.0.1', '192.168.0.0/16', '10.0.0.0/8', '172.16.0.0/12']),
+    maxConcurrentConnections: z.number().min(1).max(1000).default(50),
+    connectionTimeout: z.number().min(1000).default(30000),
+    idleConnectionTimeout: z.number().min(30000).default(300000),
+    sessionTimeout: z
+        .number()
+        .min(60000)
+        .default(30 * 60 * 1000), // Default 30 minutes, min 1 minute
+    sessionFlushInterval: z
+        .number()
+        .min(1000)
+        .default(15 * 60 * 1000), // Default 15 minutes, min 1 second
+    maxConnections: z.number().min(1).max(1000).default(50)
+})
+    .default({
+    allowedNetworks: ['127.0.0.1', '192.168.0.0/16', '10.0.0.0/8', '172.16.0.0/12'],
+    maxConcurrentConnections: 50,
+    connectionTimeout: 30000,
+    idleConnectionTimeout: 300000,
+    sessionTimeout: 30 * 60 * 1000,
+    sessionFlushInterval: 15 * 60 * 1000,
+    maxConnections: 50
+});
+/**
+ * System Configuration Schema
+ */
+export const SystemConfigSchema = z.object({
+    version: z.string().default('1.0.0'),
+    system: z
+        .object({
+        host: z.string().default('localhost'),
+        port: z.number().default(7788),
+        language: z.enum(['zh', 'en']).default('zh'),
+        theme: z.enum(['light', 'dark', 'system']).default('system'),
+        logging: LoggingConfigSchema
+    })
+        .default({
+        host: 'localhost',
+        port: 7788,
+        language: 'zh',
+        theme: 'system',
+        logging: {
+            level: 'info',
+            rotationAge: '7d',
+            jsonPretty: true,
+            mcpCommDebug: false,
+            sessionDebug: false
+        }
+    }),
+    security: SecurityConfigSchema,
+    servers: z.record(z.string(), ServerConfigSchema).default({})
+});

package/dist/server/src/config/server-config-manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Server configuration management utilities.
+ * Handles CRUD operations for server configurations and instances.
+ */
+import type { ServerConfig, ServerInstanceConfig } from './config.schema.js';
+/**
+ * Adds multiple server configurations to the system in a single operation.
+ *
+ * @param servers - Array of server objects containing name and partial configuration
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The updated servers configuration
+ */
+export declare function addServers(servers: Array<{
+    name: string;
+    config: Partial<ServerConfig>;
+}>, currentServers: Record<string, ServerConfig>, serverInstances: Record<string, ServerInstanceConfig[]>): Record<string, ServerConfig>;
+/**
+ * Adds a new server configuration to the system.
+ *
+ * @param name - The unique name for the server
+ * @param config - The server configuration (partial, will be validated)
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The validated and complete server configuration
+ */
+export declare function addServer(name: string, config: Partial<ServerConfig>, currentServers: Record<string, ServerConfig>, serverInstances: Record<string, ServerInstanceConfig[]>): ServerConfig;
+/**
+ * Adds a new server instance for the specified server.
+ *
+ * @param name - The name of the server to add an instance for
+ * @param instance - The server instance configuration (partial, will be validated)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The validated and complete server instance configuration
+ */
+export declare function addServerInstance(name: string, instance: Partial<ServerInstanceConfig>, serverInstances: Record<string, ServerInstanceConfig[]>): ServerInstanceConfig;
+/**
+ * Updates an existing server configuration with the provided changes.
+ *
+ * @param name - The name of the server to update
+ * @param updates - The partial configuration updates to apply
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @returns True if the server was updated, false if it didn't exist
+ */
+export declare function updateServer(name: string, updates: Partial<ServerConfig>, currentServers: Record<string, ServerConfig>): boolean;
+/**
+ * Updates an existing server instance configuration with the provided changes.
+ *
+ * @param name - The name of the server containing the instance to update
+ * @param index - The index of the instance to update in the instances array
+ * @param updates - The partial instance configuration updates to apply
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the instance was updated, false if it didn't exist
+ */
+export declare function updateServerInstance(name: string, index: number, updates: Partial<ServerInstanceConfig>, serverInstances: Record<string, ServerInstanceConfig[]>): boolean;
+/**
+ * Removes a server configuration and all its instances from the system.
+ *
+ * @param name - The name of the server to remove
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the server was removed, false if it didn't exist
+ */
+export declare function removeServer(name: string, currentServers: Record<string, ServerConfig>, serverInstances: Record<string, ServerInstanceConfig[]>): boolean;
+/**
+ * Removes a specific server instance from the system.
+ *
+ * @param name - The name of the server containing the instance to remove
+ * @param index - The index of the instance to remove from the instances array
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the instance was removed, false if it didn't exist
+ */
+export declare function removeServerInstance(name: string, index: number, serverInstances: Record<string, ServerInstanceConfig[]>): boolean;
+//# sourceMappingURL=server-config-manager.d.ts.map

package/dist/server/src/config/server-config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config-manager.d.ts","sourceRoot":"","sources":["../../../../src/config/server-config-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAc7E;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,CAAC,EAC/D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAU9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,YAAY,CAiBd;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,oBAAoB,CActB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAC3C,OAAO,CAkBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,OAAO,CAiBT;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,GACtD,OAAO,CAST"}

package/dist/server/src/config/server-config-manager.js

@@ -0,0 +1,157 @@
+/**
+ * Server configuration management utilities.
+ * Handles CRUD operations for server configurations and instances.
+ */
+import { ServerConfigSchema, ServerInstanceConfigSchema } from './config.schema.js';
+import { convertHttpToStreamableHttp } from './type-converter.js';
+/**
+ * Generates a unique server instance ID.
+ *
+ * @param serverName - Name of the server
+ * @returns A unique instance ID
+ */
+function generateInstanceId(serverName) {
+    const ts = Date.now();
+    return `${serverName}-${ts}-${Math.random().toString(36).substr(2, 5)}`;
+}
+/**
+ * Adds multiple server configurations to the system in a single operation.
+ *
+ * @param servers - Array of server objects containing name and partial configuration
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The updated servers configuration
+ */
+export function addServers(servers, currentServers, serverInstances) {
+    for (const { name, config } of servers) {
+        // Unified type conversion: convert http to streamable-http
+        const convertedConfig = convertHttpToStreamableHttp(config);
+        currentServers[name] = ServerConfigSchema.parse(convertedConfig);
+        if (!serverInstances[name])
+            serverInstances[name] = [];
+    }
+    // Ensure server configurations are sorted by name
+    return Object.fromEntries(Object.entries(currentServers).sort(([a], [b]) => a.localeCompare(b)));
+}
+/**
+ * Adds a new server configuration to the system.
+ *
+ * @param name - The unique name for the server
+ * @param config - The server configuration (partial, will be validated)
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The validated and complete server configuration
+ */
+export function addServer(name, config, currentServers, serverInstances) {
+    // Unified type conversion: convert http to streamable-http
+    const convertedConfig = convertHttpToStreamableHttp(config);
+    const validated = ServerConfigSchema.parse(convertedConfig);
+    currentServers[name] = validated;
+    if (!serverInstances[name])
+        serverInstances[name] = [];
+    // Ensure server configurations are sorted by name
+    const sortedServers = Object.fromEntries(Object.entries(currentServers).sort(([a], [b]) => a.localeCompare(b)));
+    // Update the reference
+    Object.keys(currentServers).forEach((key) => delete currentServers[key]);
+    Object.assign(currentServers, sortedServers);
+    return validated;
+}
+/**
+ * Adds a new server instance for the specified server.
+ *
+ * @param name - The name of the server to add an instance for
+ * @param instance - The server instance configuration (partial, will be validated)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns The validated and complete server instance configuration
+ */
+export function addServerInstance(name, instance, serverInstances) {
+    if (!serverInstances[name])
+        serverInstances[name] = [];
+    // Minimal identity generation logic
+    if (!instance.id) {
+        const ts = Date.now();
+        instance.id = generateInstanceId(name);
+        instance.timestamp = ts;
+        instance.hash = Math.random().toString(36);
+    }
+    const validated = ServerInstanceConfigSchema.parse(instance);
+    serverInstances[name].push(validated);
+    return validated;
+}
+/**
+ * Updates an existing server configuration with the provided changes.
+ *
+ * @param name - The name of the server to update
+ * @param updates - The partial configuration updates to apply
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @returns True if the server was updated, false if it didn't exist
+ */
+export function updateServer(name, updates, currentServers) {
+    if (currentServers[name]) {
+        // Unified type conversion: convert http to streamable-http
+        const convertedUpdates = convertHttpToStreamableHttp(updates);
+        currentServers[name] = { ...currentServers[name], ...convertedUpdates };
+        // Ensure server configurations are sorted by name
+        const sortedServers = Object.fromEntries(Object.entries(currentServers).sort(([a], [b]) => a.localeCompare(b)));
+        // Update the reference
+        Object.keys(currentServers).forEach((key) => delete currentServers[key]);
+        Object.assign(currentServers, sortedServers);
+        return true;
+    }
+    return false;
+}
+/**
+ * Updates an existing server instance configuration with the provided changes.
+ *
+ * @param name - The name of the server containing the instance to update
+ * @param index - The index of the instance to update in the instances array
+ * @param updates - The partial instance configuration updates to apply
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the instance was updated, false if it didn't exist
+ */
+export function updateServerInstance(name, index, updates, serverInstances) {
+    if (serverInstances[name]?.[index]) {
+        serverInstances[name][index] = { ...serverInstances[name][index], ...updates };
+        return true;
+    }
+    return false;
+}
+/**
+ * Removes a server configuration and all its instances from the system.
+ *
+ * @param name - The name of the server to remove
+ * @param currentServers - Current servers configuration object (will be modified)
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the server was removed, false if it didn't exist
+ */
+export function removeServer(name, currentServers, serverInstances) {
+    if (currentServers[name]) {
+        delete currentServers[name];
+        delete serverInstances[name];
+        // Ensure server configurations are sorted by name
+        const sortedServers = Object.fromEntries(Object.entries(currentServers).sort(([a], [b]) => a.localeCompare(b)));
+        // Update the reference
+        Object.keys(currentServers).forEach((key) => delete currentServers[key]);
+        Object.assign(currentServers, sortedServers);
+        return true;
+    }
+    return false;
+}
+/**
+ * Removes a specific server instance from the system.
+ *
+ * @param name - The name of the server containing the instance to remove
+ * @param index - The index of the instance to remove from the instances array
+ * @param serverInstances - Current server instances record (will be modified)
+ * @returns True if the instance was removed, false if it didn't exist
+ */
+export function removeServerInstance(name, index, serverInstances) {
+    if (serverInstances[name]) {
+        serverInstances[name].splice(index, 1);
+        if (serverInstances[name].length === 0) {
+            delete serverInstances[name];
+        }
+        return true;
+    }
+    return false;
+}

package/dist/server/src/config/type-converter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type conversion utilities for configuration management.
+ * Handles backward compatibility type conversions.
+ */
+/**
+ * Unified type conversion method: convert type: 'http' to type: 'streamable-http'
+ * Ensure compatibility across all scenarios (loading, adding, updating)
+ *
+ * @param config - The configuration object to convert
+ * @returns The converted configuration object
+ */
+export declare function convertHttpToStreamableHttp(config: unknown): unknown;
+//# sourceMappingURL=type-converter.d.ts.map

package/dist/server/src/config/type-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-converter.d.ts","sourceRoot":"","sources":["../../../../src/config/type-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CA2BpE"}

package/dist/server/src/config/type-converter.js

@@ -0,0 +1,37 @@
+/**
+ * Type conversion utilities for configuration management.
+ * Handles backward compatibility type conversions.
+ */
+/**
+ * Unified type conversion method: convert type: 'http' to type: 'streamable-http'
+ * Ensure compatibility across all scenarios (loading, adding, updating)
+ *
+ * @param config - The configuration object to convert
+ * @returns The converted configuration object
+ */
+export function convertHttpToStreamableHttp(config) {
+    if (!config)
+        return config;
+    // If it's an array, process each element
+    if (Array.isArray(config)) {
+        return config.map((item) => convertHttpToStreamableHttp(item));
+    }
+    // If it's an object, create a copy to avoid directly modifying the original object
+    if (typeof config === 'object' && config !== null) {
+        const result = {};
+        for (const [key, value] of Object.entries(config)) {
+            if (key === 'type' && value === 'http') {
+                result[key] = 'streamable-http';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                result[key] = convertHttpToStreamableHttp(value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    // Return primitive types directly
+    return config;
+}

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":""}