@loop_ouroboros/mcp-hub-lite 1.2.4 → 1.2.6

package/dist/server/src/services/hub-tools/server-selector.js

@@ -3,14 +3,15 @@ import { InstanceSelector, TagMatchUniqueError } from './instance-selector.js';
 import { logger } from '../../utils/logger.js';
 import { LOG_MODULES } from '../../utils/logger/log-modules.js';
 /**
- * Gets the description for a server, using a default if none is provided.
+ * Gets the description for a server, using the server name as default if none is provided.
  *
  * @param serverConfig - Server configuration object (may contain description in template)
  * @param serverName - Name of the server
- * @returns The server description or a default one
+ * @returns The server description or the server name with usage note if no description is configured
  */
 export function getServerDescription(serverConfig, serverName) {
-    return serverConfig?.template?.description || `Connected MCP server: ${serverName}`;
+    return (serverConfig?.template?.description ||
+        `${serverName} (You can check the tool list to understand its capabilities and update the description.)`);
 }
 /**
  * Type guard to validate that a server object has valid name and configuration.

package/dist/server/src/services/hub-tools/system-tool-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tool-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/system-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAU/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,EAAE,CA6IvD"}
+{"version":3,"file":"system-tool-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/system-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAW/D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,EAAE,CAiKvD"}

package/dist/server/src/services/hub-tools/system-tool-definitions.js

@@ -1,4 +1,4 @@
-import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL } from '../../models/system-tools.constants.js';
+import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL } from '../../models/system-tools.constants.js';
 /**
  * Retrieves the complete list of system tools provided by this service.
  *
@@ -91,7 +91,7 @@ export function getSystemTools() {
                         required: ['serverName', 'toolName']
                     },
                     annotations: {
-                        title: 'Get Tool Details',
+                        title: 'Get Tool Schema',
                         readOnlyHint: true,
                         destructiveHint: false,
                         idempotentHint: true,
@@ -103,7 +103,7 @@ export function getSystemTools() {
                 systemTools.push({
                     name: toolName,
                     description: 'Call a specific tool from an external MCP server. ' +
-                        'System tools (list_servers, list_tools, get_tool, update_server_description) ' +
+                        'System tools (list_servers, list_tools, get_tool, list_tags, update_server_description) ' +
                         'must be called directly via tools/call, not through this tool.',
                     inputSchema: {
                         type: 'object',
@@ -154,6 +154,26 @@ export function getSystemTools() {
                     }
                 });
                 break;
+            case LIST_TAGS_TOOL:
+                systemTools.push({
+                    name: toolName,
+                    description: 'List all instance tags for a specific MCP server',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            serverName: { type: 'string', description: 'Name of the MCP server' }
+                        },
+                        required: ['serverName']
+                    },
+                    annotations: {
+                        title: 'List Instance Tags',
+                        readOnlyHint: true,
+                        destructiveHint: false,
+                        idempotentHint: true,
+                        openWorldHint: false
+                    }
+                });
+                break;
             default:
                 // This should never happen due to TypeScript type checking
                 throw new Error(`Unknown system tool: ${toolName}`);

package/dist/server/src/services/hub-tools.service.d.ts

@@ -1,7 +1,7 @@
 import type { Tool, ToolSummary } from '../../shared/models/tool.model.js';
 import type { Resource } from '../../shared/models/resource.model.js';
-import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL } from '../models/system-tools.constants.js';
-import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToolParams, CallToolParams, UpdateServerDescriptionParams } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL } from '../models/system-tools.constants.js';
+import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToolParams, CallToolParams, UpdateServerDescriptionParams, ListTagsParams } from '../models/system-tools.constants.js';
 /**
  * Central service for managing system tools and MCP server interactions in the MCP Hub Lite gateway.
  *
@@ -51,10 +51,6 @@ import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToo
  * ```
  */
 export declare class HubToolsService {
-    /**
-     * Cached dynamic resource list to avoid regenerating on every request
-     */
-    private generatedResourcesCache;
     constructor();
     /**
      * Retrieves the complete list of system tools provided by this service.
@@ -122,6 +118,25 @@ export declare class HubToolsService {
         serverName: string;
         description: string;
     }>;
+    /**
+     * Lists all instance tags for a specific MCP server.
+     *
+     * This method retrieves all instances of the specified server and returns their tags,
+     * useful for understanding which instances are available and how to select them
+     * when using tag-match-unique instance selection strategy.
+     *
+     * @param {ListTagsParams} args - Server name
+     * @returns {Promise<{ serverName: string; instances: Array<{ index: number; id: string; tags: Record<string, string> }> }>} Instance tags information
+     * @throws {Error} If the specified server is not found
+     */
+    listTags(args: ListTagsParams): Promise<{
+        serverName: string;
+        instances: Array<{
+            index: number;
+            id: string;
+            tags: Record<string, string>;
+        }>;
+    }>;
     /**
      * Calls a specific system tool directly with type-safe conditional return types.
      *
@@ -134,13 +149,20 @@ export declare class HubToolsService {
      * @returns {Promise<ConditionalReturnType>} Tool execution result with accurate type safety matching actual method return types
      * @throws {Error} If the system tool is not found or execution fails
      */
-    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_TOOL ? ListToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? UpdateServerDescriptionParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? Record<string, string> : T extends typeof LIST_TOOLS_TOOL ? {
+    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_TOOL ? ListToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? UpdateServerDescriptionParams : T extends typeof LIST_TAGS_TOOL ? ListTagsParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? Record<string, string> : T extends typeof LIST_TOOLS_TOOL ? {
         serverName: string;
         tools: ToolSummary[];
     } : T extends typeof GET_TOOL_TOOL ? Tool | undefined : T extends typeof CALL_TOOL_TOOL ? unknown : T extends typeof UPDATE_SERVER_DESCRIPTION_TOOL ? {
         success: boolean;
         serverName: string;
         description: string;
+    } : T extends typeof LIST_TAGS_TOOL ? {
+        serverName: string;
+        instances: Array<{
+            index: number;
+            id: string;
+            tags: Record<string, string>;
+        }>;
     } : never>;
     /**
      * Calls a specific tool from a specific MCP server with comprehensive event tracking.

package/dist/server/src/services/hub-tools.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-tools.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-tools.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hub-tools.service.d.ts","sourceRoot":"","sources":["../../../../src/services/hub-tools.service.ts"],"names":[],"mappings":"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"}

package/dist/server/src/services/hub-tools.service.js

@@ -6,9 +6,11 @@ import { logger, LOG_MODULES } from '../utils/logger.js';
 import { stringifyForLogging } from '../utils/json-utils.js';
 import { normalizeToolName } from '../utils/name-converter.js';
 import { McpError } from '@modelcontextprotocol/sdk/types.js';
-import { MCP_HUB_LITE_SERVER, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, SYSTEM_TOOL_NAMES } from '../models/system-tools.constants.js';
+import { MCP_HUB_LITE_SERVER, LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL, SYSTEM_TOOL_NAMES } from '../models/system-tools.constants.js';
 import { ToolArgsParser } from '../utils/tool-args-parser.js';
 import { hasValidId, selectBestInstance, getServerDescription, getSystemTools, generateDynamicResources, readResource as readResourceUtil } from './hub-tools/index.js';
+import { InstanceSelector } from './hub-tools/instance-selector.js';
+import { InstanceSelectionStrategy } from '../models/server.model.js';
 /**
  * Central service for managing system tools and MCP server interactions in the MCP Hub Lite gateway.
  *
@@ -58,27 +60,9 @@ import { hasValidId, selectBestInstance, getServerDescription, getSystemTools, g
  * ```
  */
 export class HubToolsService {
-    /**
-     * Cached dynamic resource list to avoid regenerating on every request
-     */
-    generatedResourcesCache = null;
+    // Cache removed - listResources() now calls generateDynamicResources() directly
     constructor() {
-        // Listen for server status change events to invalidate resource cache
-        eventBus.subscribe(EventTypes.SERVER_STATUS_CHANGE, () => {
-            this.generatedResourcesCache = null;
-        });
-        eventBus.subscribe(EventTypes.SERVER_CONNECTED, () => {
-            this.generatedResourcesCache = null;
-        });
-        eventBus.subscribe(EventTypes.SERVER_DISCONNECTED, () => {
-            this.generatedResourcesCache = null;
-        });
-        eventBus.subscribe(EventTypes.RESOURCES_UPDATED, () => {
-            this.generatedResourcesCache = null;
-        });
-        eventBus.subscribe(EventTypes.TOOLS_UPDATED, () => {
-            this.generatedResourcesCache = null;
-        });
+        // No cache-related initialization needed
     }
     /**
      * Retrieves the complete list of system tools provided by this service.
@@ -107,9 +91,9 @@ export class HubToolsService {
         const servers = hubManager.getAllServers();
         const result = {};
         for (const server of servers.filter(hasValidId)) {
-            // Check if server is actually connected
-            const status = mcpConnectionManager.getStatusByName(server.name);
-            if (!status?.connected) {
+            // Use getConnectedIndexes for reliable multi-instance support
+            const indexes = mcpConnectionManager.getConnectedIndexes(server.name);
+            if (indexes.length === 0) {
                 continue;
             }
             // Use non-strict mode for management operations to avoid tag-match-unique errors
@@ -136,6 +120,9 @@ export class HubToolsService {
      * @throws {Error} If the specified server is not found or not connected
      */
     async listToolsInServer(args) {
+        if (!args.serverName) {
+            throw new Error('serverName is required');
+        }
         // Handle MCP Hub Lite server (return system tools list)
         if (typeof args.serverName === 'string' && args.serverName === MCP_HUB_LITE_SERVER) {
             // Generate tool list using the same logic as tools/list
@@ -152,6 +139,11 @@ export class HubToolsService {
                 tools: toolSummaries
             };
         }
+        // Check if server has any connected instances before trying to get tools
+        const indexes = mcpConnectionManager.getConnectedIndexes(args.serverName);
+        if (indexes.length === 0) {
+            throw new Error(`Server not found: ${args.serverName}`);
+        }
         // Use server name level cache to get tools directly without triggering instance selection
         // This avoids tag-match-unique errors for multi-instance servers when listing tools
         const tools = mcpConnectionManager.getToolsByServerName(args.serverName);
@@ -193,6 +185,11 @@ export class HubToolsService {
             }
             return undefined;
         }
+        // Check if server has any connected instances before trying to get tools
+        const indexes = mcpConnectionManager.getConnectedIndexes(args.serverName);
+        if (indexes.length === 0) {
+            throw new Error(`Server not found: ${args.serverName}`);
+        }
         // Use server name level cache to get tools directly without triggering instance selection
         // This avoids tag-match-unique errors for multi-instance servers when getting tool details
         const tools = mcpConnectionManager.getToolsByServerName(args.serverName);
@@ -237,6 +234,33 @@ export class HubToolsService {
             description
         };
     }
+    /**
+     * Lists all instance tags for a specific MCP server.
+     *
+     * This method retrieves all instances of the specified server and returns their tags,
+     * useful for understanding which instances are available and how to select them
+     * when using tag-match-unique instance selection strategy.
+     *
+     * @param {ListTagsParams} args - Server name
+     * @returns {Promise<{ serverName: string; instances: Array<{ index: number; id: string; tags: Record<string, string> }> }>} Instance tags information
+     * @throws {Error} If the specified server is not found
+     */
+    async listTags(args) {
+        const serverConfig = hubManager.getServerByName(args.serverName);
+        if (!serverConfig) {
+            throw new Error(`Server not found: ${args.serverName}`);
+        }
+        const instances = hubManager.getServerInstancesByName(args.serverName);
+        const instanceTags = instances.map((instance) => ({
+            index: instance.index ?? 0,
+            id: instance.id || '',
+            tags: instance.tags || {}
+        }));
+        return {
+            serverName: args.serverName,
+            instances: instanceTags
+        };
+    }
     /**
      * Calls a specific system tool directly with type-safe conditional return types.
      *
@@ -281,6 +305,10 @@ export class HubToolsService {
                     result = await this.updateServerDescription(toolArgs);
                     break;
                 }
+                case LIST_TAGS_TOOL: {
+                    result = await this.listTags(toolArgs);
+                    break;
+                }
                 default:
                     throw new Error(`System tool "${toolName}" not found`);
             }
@@ -317,14 +345,17 @@ export class HubToolsService {
             serverName = parsedTool.serverName;
             toolName = parsedTool.toolName;
         }
-        // Handle MCP Hub Lite server (system tool call or find tool in all servers)
-        if (!serverName || serverName === 'undefined') {
-            serverName = MCP_HUB_LITE_SERVER;
+        // Validate serverName is required
+        if (!serverName) {
+            throw new Error('serverName is required');
         }
+        // Handle MCP Hub Lite server (system tool call or find tool in all servers)
         if (typeof serverName === 'string' && serverName === MCP_HUB_LITE_SERVER) {
-            // System tools cannot be called via call_tool - they must be called directly
+            // System tools (except call_tool) cannot be called via call_tool - they must be called directly
+            // call_tool is the gateway tool for calling external tools, so it should be allowed
             if (Array.isArray(SYSTEM_TOOL_NAMES) &&
-                SYSTEM_TOOL_NAMES.includes(toolName)) {
+                SYSTEM_TOOL_NAMES.includes(toolName) &&
+                toolName !== CALL_TOOL_TOOL) {
                 throw new McpError(-32801, `System tools cannot be called via 'call_tool'. Use 'tools/call' with the system tool name directly. ` +
                     `Example: use 'list_servers' directly instead of call_tool(serverName: "mcp-hub-lite", toolName: "list_servers").`);
             }
@@ -377,7 +408,40 @@ export class HubToolsService {
             // Server not found in hubManager, try direct call by name through mcpConnectionManager
             logger.debug(`Server not found in hubManager, trying direct call by name: ${serverName}`, LOG_MODULES.HUB_TOOLS);
             // Use selectBestInstance with non-strict mode to find an available instance
-            const fallbackServerInfo = selectBestInstance(serverName, undefined, false);
+            let fallbackServerInfo = selectBestInstance(serverName, undefined, false);
+            // If selectBestInstance returns undefined (e.g., TAG_MATCH_UNIQUE strategy without tags),
+            // fall back to directly selecting an enabled instance with RANDOM strategy
+            if (!fallbackServerInfo) {
+                logger.debug(`selectBestInstance returned undefined for ${serverName}, trying direct instance selection with RANDOM strategy`, LOG_MODULES.HUB_TOOLS);
+                const serverConfig = hubManager.getServerByName(serverName);
+                if (serverConfig && serverConfig.instances.length > 0) {
+                    // Filter: use runtime connected status, NOT config enabled flag
+                    // enabled=false means "do not auto-start" but user can manually start it
+                    const connectedInstances = serverConfig.instances.filter((instance) => {
+                        if (instance.index === undefined)
+                            return false;
+                        const status = mcpConnectionManager.getStatus(serverName, instance.index);
+                        return status?.connected;
+                    });
+                    if (connectedInstances.length > 0) {
+                        // Use RANDOM strategy regardless of server's configured strategy
+                        const selectedInstance = InstanceSelector.selectInstance(serverName, {
+                            ...serverConfig,
+                            template: {
+                                ...serverConfig.template,
+                                instanceSelectionStrategy: InstanceSelectionStrategy.RANDOM
+                            }
+                        }, undefined);
+                        if (selectedInstance) {
+                            fallbackServerInfo = {
+                                name: serverName,
+                                config: serverConfig,
+                                instance: selectedInstance
+                            };
+                        }
+                    }
+                }
+            }
             if (!fallbackServerInfo) {
                 logger.error(`Server not found: ${serverName}`, LOG_MODULES.HUB_TOOLS);
                 throw new Error(`Server not found: ${serverName}`);
@@ -525,12 +589,8 @@ export class HubToolsService {
      * @returns {Promise<Resource[]>} Array of MCP resource objects representing Hub resources
      */
     async listResources() {
-        if (this.generatedResourcesCache) {
-            return this.generatedResourcesCache;
-        }
-        const resources = generateDynamicResources();
-        this.generatedResourcesCache = resources;
-        return resources;
+        // Always regenerate to ensure fresh data based on runtime status
+        return generateDynamicResources();
     }
     /**
      * Reads content from a specific Hub resource URI.

package/dist/server/src/services/system-tool-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/services/system-tool-handler.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,oBAAoB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC;CA8DpB"}
+{"version":3,"file":"system-tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/services/system-tool-handler.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;WACU,oBAAoB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,OAAO,CAAC;CA2EpB"}

package/dist/server/src/services/system-tool-handler.js

@@ -1,7 +1,7 @@
 import { hubToolsService } from './hub-tools.service.js';
 import { McpError } from '@modelcontextprotocol/sdk/types.js';
 import { logger, LOG_MODULES } from '../utils/logger.js';
-import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, MCP_HUB_LITE_SERVER } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL, LIST_TAGS_TOOL } from '../models/system-tools.constants.js';
 import { stringifyForLogging } from '../utils/json-utils.js';
 /**
  * Unified system tool call handler
@@ -20,31 +20,44 @@ export class SystemToolHandler {
                     break;
                 case LIST_TOOLS_TOOL: {
                     const listToolsArgs = toolArgs;
+                    if (!listToolsArgs.serverName) {
+                        throw new McpError(-32802, 'serverName is required');
+                    }
                     result = await hubToolsService.listToolsInServer(listToolsArgs);
                     break;
                 }
                 case GET_TOOL_TOOL: {
                     const getToolArgs = toolArgs;
+                    if (!getToolArgs.serverName) {
+                        throw new McpError(-32802, 'serverName is required');
+                    }
                     result = await hubToolsService.getTool(getToolArgs);
                     break;
                 }
                 case CALL_TOOL_TOOL: {
                     const callToolArgs = toolArgs;
-                    let serverName = callToolArgs.serverName;
-                    if (!serverName || serverName === 'undefined') {
-                        serverName = MCP_HUB_LITE_SERVER;
+                    if (!callToolArgs.serverName) {
+                        throw new McpError(-32802, 'serverName is required');
                     }
-                    result = await hubToolsService.callTool({
-                        ...callToolArgs,
-                        serverName
-                    });
+                    result = await hubToolsService.callTool(callToolArgs);
                     break;
                 }
                 case UPDATE_SERVER_DESCRIPTION_TOOL: {
                     const updateDescArgs = toolArgs;
+                    if (!updateDescArgs.serverName) {
+                        throw new McpError(-32802, 'serverName is required');
+                    }
                     result = await hubToolsService.updateServerDescription(updateDescArgs);
                     break;
                 }
+                case LIST_TAGS_TOOL: {
+                    const listTagsArgs = toolArgs;
+                    if (!listTagsArgs.serverName) {
+                        throw new McpError(-32802, 'serverName is required');
+                    }
+                    result = await hubToolsService.listTags(listTagsArgs);
+                    break;
+                }
                 default:
                     throw new McpError(-32801, `Unknown system tool: ${toolName}`);
             }

package/dist/server/src/utils/name-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"name-converter.d.ts","sourceRoot":"","sources":["../../../../src/utils/name-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa1D"}
+{"version":3,"file":"name-converter.d.ts","sourceRoot":"","sources":["../../../../src/utils/name-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe1D"}

package/dist/server/src/utils/name-converter.js

@@ -14,6 +14,8 @@
  * normalizeToolName('chat_completions') // returns 'chat_completions'
  */
 export function normalizeToolName(toolName) {
+    if (!toolName)
+        return '';
     return (toolName
         // Insert underscore before uppercase letters (for camelCase handling)
         // e.g., 'chatCompletions' -> 'chat_Completions'

package/dist/server/tests/unit/services/hub-tools/instance-selector.test.js

@@ -17,8 +17,13 @@ describe('InstanceSelector', () => {
         headers: {},
         tags: {}
     };
+    // Mock statusChecker that simulates connected instances
+    const mockConnectedStatus = () => ({ connected: true });
+    const mockDisconnectedStatus = () => ({ connected: false });
     describe('random strategy', () => {
-        it('should select random instance from enabled instances', () => {
+        it('should select random instance from connected instances', () => {
+            // Local mock that simulates idx=2 being disconnected
+            const localMockConnectedStatus = (_name, idx) => idx === 2 ? { connected: false } : { connected: true };
             const config = {
                 template: {
                     ...baseTemplate,
@@ -31,11 +36,11 @@ describe('InstanceSelector', () => {
                 ],
                 tagDefinitions: []
             };
-            const selected = InstanceSelector.selectInstance('test-server', config);
+            const selected = InstanceSelector.selectInstance('test-server', config, undefined, localMockConnectedStatus);
             expect(selected).toBeDefined();
             expect(['1', '2']).toContain(selected.id);
         });
-        it('should return undefined when no enabled instances', () => {
+        it('should return undefined when no connected instances', () => {
             const config = {
                 template: {
                     ...baseTemplate,
@@ -47,12 +52,12 @@ describe('InstanceSelector', () => {
                 ],
                 tagDefinitions: []
             };
-            const selected = InstanceSelector.selectInstance('test-server', config);
+            const selected = InstanceSelector.selectInstance('test-server', config, undefined, mockDisconnectedStatus);
             expect(selected).toBeUndefined();
         });
     });
     describe('round-robin strategy', () => {
-        it('should cycle through enabled instances', () => {
+        it('should cycle through connected instances', () => {
             const config = {
                 template: {
                     ...baseTemplate,
@@ -65,10 +70,10 @@ describe('InstanceSelector', () => {
                 ],
                 tagDefinitions: []
             };
-            const selected1 = InstanceSelector.selectInstance('test-server-rr', config);
-            const selected2 = InstanceSelector.selectInstance('test-server-rr', config);
-            const selected3 = InstanceSelector.selectInstance('test-server-rr', config);
-            const selected4 = InstanceSelector.selectInstance('test-server-rr', config);
+            const selected1 = InstanceSelector.selectInstance('test-server-rr', config, undefined, mockConnectedStatus);
+            const selected2 = InstanceSelector.selectInstance('test-server-rr', config, undefined, mockConnectedStatus);
+            const selected3 = InstanceSelector.selectInstance('test-server-rr', config, undefined, mockConnectedStatus);
+            const selected4 = InstanceSelector.selectInstance('test-server-rr', config, undefined, mockConnectedStatus);
             expect(selected1.id).toBe('1');
             expect(selected2.id).toBe('2');
             expect(selected3.id).toBe('3');
@@ -91,7 +96,7 @@ describe('InstanceSelector', () => {
             };
             const selected = InstanceSelector.selectInstance('test-server', config, {
                 tags: { env: 'prod', region: 'us' }
-            });
+            }, mockConnectedStatus);
             expect(selected).toBeDefined();
             expect(selected.id).toBe('2');
         });
@@ -110,7 +115,7 @@ describe('InstanceSelector', () => {
             expect(() => {
                 InstanceSelector.selectInstance('test-server', config, {
                     tags: { env: 'staging' }
-                });
+                }, mockConnectedStatus);
             }).toThrow('No instance found matching tags');
         });
         it('should throw error when multiple instances match tags', () => {
@@ -128,7 +133,7 @@ describe('InstanceSelector', () => {
             expect(() => {
                 InstanceSelector.selectInstance('test-server', config, {
                     tags: { env: 'prod' }
-                });
+                }, mockConnectedStatus);
             }).toThrow('Multiple instances match tags');
         });
         it('should return the single instance when no tags provided and only one instance exists', () => {
@@ -140,7 +145,7 @@ describe('InstanceSelector', () => {
                 instances: [{ ...baseInstance, id: '1', index: 0 }],
                 tagDefinitions: []
             };
-            const selected = InstanceSelector.selectInstance('test-server', config);
+            const selected = InstanceSelector.selectInstance('test-server', config, undefined, mockConnectedStatus);
             expect(selected).toBeDefined();
             expect(selected.id).toBe('1');
         });
@@ -157,7 +162,7 @@ describe('InstanceSelector', () => {
                 tagDefinitions: []
             };
             expect(() => {
-                InstanceSelector.selectInstance('test-server', config);
+                InstanceSelector.selectInstance('test-server', config, undefined, mockConnectedStatus);
             }).toThrow('No tags provided for tag-match-unique strategy with 2 instances. Available: [0:{}, 1:{}]. Pass matching tags to select.');
         });
     });
@@ -171,7 +176,7 @@ describe('InstanceSelector', () => {
                 instances: [{ ...baseInstance, id: '1', index: 0 }],
                 tagDefinitions: []
             };
-            const selected = InstanceSelector.selectInstance('test-server', config);
+            const selected = InstanceSelector.selectInstance('test-server', config, undefined, mockConnectedStatus);
             expect(selected).toBeDefined();
             expect(selected.id).toBe('1');
         });
@@ -187,7 +192,7 @@ describe('InstanceSelector', () => {
                 tagDefinitions: []
                 // No instanceSelectionStrategy field
             };
-            const selected = InstanceSelector.selectInstance('test-server', config);
+            const selected = InstanceSelector.selectInstance('test-server', config, undefined, mockConnectedStatus);
             expect(selected).toBeDefined();
             expect(['1', '2']).toContain(selected.id);
         });