@loop_ouroboros/mcp-hub-lite 1.2.4 → 1.2.6

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.6] - 2026-04-29
+
+### Hub Tools
+
+- use runtime connected status for instance selection
+- clarify instance filtering comment
+- fix listMcpResources returning incomplete server resources by using two-pass approach to check all instances connection status
+
+### Utils
+
+- add null check to normalizeToolName
+
+---
+
+## [1.2.5] - 2026-04-28
+
+### Hub Tools
+
+- enhance hub-tools system with improved tool handling
+- add list_tags tool constants and update CLAUDE.md docs
+- add comprehensive use guide documentation
+- improve default server description text
+- remove stale cache in listResources
+- clarify instance filtering comment
+- fix listMcpResources returning incomplete server resources by using two-pass approach to check all instances connection status
+- align resource generation logic with /web/mcp/status API behavior
+
+### Utils
+
+- add null check to normalizeToolName
+
+---
+
 ## [1.2.4] - 2026-04-25
 
 ### Frontend

package/dist/server/src/api/web/hub-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-tools.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/hub-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAoB1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,iBAsJ/D"}
+{"version":3,"file":"hub-tools.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/hub-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAqB1C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,iBAuK/D"}

package/dist/server/src/api/web/hub-tools.js

@@ -77,6 +77,21 @@ export async function webHubToolsRoutes(fastify) {
             });
         }
     });
+    // GET /web/hub-tools/servers/:serverName/tags - List all instance tags for a specific server
+    fastify.get('/web/hub-tools/servers/:serverName/tags', async (request, reply) => {
+        try {
+            const { serverName } = request.params;
+            const params = { serverName };
+            const result = await hubToolsService.listTags(params);
+            return result;
+        }
+        catch (error) {
+            return reply.code(404).send({
+                error: 'Server not found',
+                message: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    });
     // GET /web/hub-tools/servers/:serverName/tools/:toolName - Get specific tool details
     fastify.get('/web/hub-tools/servers/:serverName/tools/:toolName', async (request, reply) => {
         try {

package/dist/server/src/api/web/mcp-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-status.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/mcp-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,iBAuKhE"}
+{"version":3,"file":"mcp-status.d.ts","sourceRoot":"","sources":["../../../../../src/api/web/mcp-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAQ1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,iBA6KhE"}

package/dist/server/src/api/web/mcp-status.js

@@ -43,6 +43,8 @@ export async function webMcpStatusRoutes(fastify) {
                         id: server.name,
                         name: server.name,
                         type: server.config.template.type,
+                        displayName: undefined,
+                        tags: {},
                         status: {
                             connected: false,
                             lastCheck: Date.now(),
@@ -60,6 +62,8 @@ export async function webMcpStatusRoutes(fastify) {
                             id: instance.id || '',
                             name: server.name,
                             type: resolvedConfig?.type || server.config.template.type,
+                            displayName: instance.displayName,
+                            tags: instance.tags,
                             status: mcpConnectionManager.getStatus(server.name, instance.index ?? 0) || {
                                 connected: false,
                                 lastCheck: Date.now(),

package/dist/server/src/cli/commands/status.js

@@ -97,16 +97,24 @@ function printFormattedStatus(status) {
             let maxNameLen = 'Server Name'.length;
             let maxTypeLen = 'Type'.length;
             const maxStatusLen = 'Disconnected'.length;
+            let maxDisplayNameLen = 'DisplayName'.length;
+            let maxTagsLen = 'Tags'.length;
             for (const server of servers) {
                 maxNameLen = Math.max(maxNameLen, (server.name || '').length);
                 maxTypeLen = Math.max(maxTypeLen, (server.type || '').length);
+                const displayName = server.displayName || '';
+                const tags = JSON.stringify(server.tags || {});
+                maxDisplayNameLen = Math.max(maxDisplayNameLen, displayName.length);
+                maxTagsLen = Math.max(maxTagsLen, tags.length);
             }
             // Simple table without complex borders
             const headerName = 'Server Name'.padEnd(maxNameLen);
             const headerType = 'Type'.padEnd(maxTypeLen);
             const headerStatus = 'Status'.padEnd(maxStatusLen);
-            console.log(`${cyan}${headerName}  ${headerType}  ${headerStatus}  Tools  Resources${reset}`);
-            console.log(`${dim}${'─'.repeat(maxNameLen + maxTypeLen + maxStatusLen + 20)}${reset}`);
+            const headerDisplayName = 'DisplayName'.padEnd(maxDisplayNameLen);
+            const headerTags = 'Tags'.padEnd(maxTagsLen);
+            console.log(`${cyan}${headerName}  ${headerType}  ${headerStatus}  Tools  Resources  ${headerDisplayName}  ${headerTags}${reset}`);
+            console.log(`${dim}${'─'.repeat(maxNameLen + maxTypeLen + maxStatusLen + 26 + maxDisplayNameLen + maxTagsLen)}${reset}`);
             for (const server of servers) {
                 const name = (server.name || '').padEnd(maxNameLen);
                 const type = (server.type || '').padEnd(maxTypeLen);
@@ -115,7 +123,9 @@ function printFormattedStatus(status) {
                     : `${red}Disconnected${reset}`.padEnd(maxStatusLen + 9);
                 const tools = server.toolsCount.toString().padStart(5);
                 const resources = server.resourcesCount.toString().padStart(9);
-                console.log(`${name}  ${type}  ${statusText}  ${tools}  ${resources}`);
+                const displayName = (server.displayName || '').padEnd(maxDisplayNameLen);
+                const tags = JSON.stringify(server.tags || {}).padEnd(maxTagsLen);
+                console.log(`${name}  ${type}  ${statusText}  ${tools}  ${resources}  ${displayName}  ${tags}`);
                 if (server.error) {
                     console.log(`  ${red}Error: ${server.error}${reset}`);
                 }

package/dist/server/src/cli/commands/tool-use.d.ts

@@ -3,7 +3,7 @@ import { Command } from 'commander';
  * CLI command for dynamic MCP server tool operations via API.
  *
  * This command provides a simplified CLI interface for interacting with MCP server tools,
- * supporting four actions: list-servers, list-tools, get-tool, and call-tool. It wraps
+ * supporting five actions: list-servers, list-tools, list-tags, get-tool, and call-tool. It wraps
  * the HTTP API endpoints and requires the MCP Hub Lite server to be running.
  *
  * ## Command Format
@@ -21,6 +21,7 @@ import { Command } from 'commander';
  *
  * - `list-servers` - List all connected MCP servers
  * - `list-tools` - List all tools from the specified server
+ * - `list-tags` - List all instance tags for a specific MCP server
  * - `get-tool` - Get complete schema for a specific tool (requires --tool)
  * - `call-tool` - Call a tool on the specified server (requires --tool)
  *
@@ -55,6 +56,9 @@ import { Command } from 'commander';
  * # List third-party server tools
  * mcp-hub-lite tool-use list-tools --server baidu-search
  *
+ * # List instance tags for a server
+ * mcp-hub-lite tool-use list-tags --server chrome-devtools
+ *
  * # Get system tool schema
  * mcp-hub-lite tool-use get-tool --tool list_tools --server mcp-hub-lite
  *

package/dist/server/src/cli/commands/tool-use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-use.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/tool-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AACH,eAAO,MAAM,cAAc,SAwLvB,CAAC"}
+{"version":3,"file":"tool-use.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/tool-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+FG;AACH,eAAO,MAAM,cAAc,SAkNvB,CAAC"}

package/dist/server/src/cli/commands/tool-use.js

@@ -4,7 +4,7 @@ import { getServerStatus } from '../server.js';
  * CLI command for dynamic MCP server tool operations via API.
  *
  * This command provides a simplified CLI interface for interacting with MCP server tools,
- * supporting four actions: list-servers, list-tools, get-tool, and call-tool. It wraps
+ * supporting five actions: list-servers, list-tools, list-tags, get-tool, and call-tool. It wraps
  * the HTTP API endpoints and requires the MCP Hub Lite server to be running.
  *
  * ## Command Format
@@ -22,6 +22,7 @@ import { getServerStatus } from '../server.js';
  *
  * - `list-servers` - List all connected MCP servers
  * - `list-tools` - List all tools from the specified server
+ * - `list-tags` - List all instance tags for a specific MCP server
  * - `get-tool` - Get complete schema for a specific tool (requires --tool)
  * - `call-tool` - Call a tool on the specified server (requires --tool)
  *
@@ -56,6 +57,9 @@ import { getServerStatus } from '../server.js';
  * # List third-party server tools
  * mcp-hub-lite tool-use list-tools --server baidu-search
  *
+ * # List instance tags for a server
+ * mcp-hub-lite tool-use list-tags --server chrome-devtools
+ *
  * # Get system tool schema
  * mcp-hub-lite tool-use get-tool --tool list_tools --server mcp-hub-lite
  *
@@ -93,8 +97,8 @@ import { getServerStatus } from '../server.js';
  * @returns {Command} The configured mcp-tool-use command instance for registration with Commander.js
  */
 export const toolUseCommand = new Command('tool-use')
-    .description('Manage MCP server tools via API (list-servers, list-tools, get-tool, call-tool)')
-    .argument('<action>', 'Action: list-servers, list-tools, get-tool, call-tool')
+    .description('Manage MCP server tools via API (list-servers, list-tools, list-tags, get-tool, call-tool)')
+    .argument('<action>', 'Action: list-servers, list-tools, list-tags, get-tool, call-tool')
     .option('--server <serverName>', 'Server name to target (omit or empty for system tools)')
     .option('--tool <toolName>', 'Tool name (required for get-tool and call-tool actions)')
     .option('--args <json>', 'JSON string of tool arguments, or combined JSON with server/tool/args fields')
@@ -111,6 +115,9 @@ Examples:
   # List third-party server tools
   mcp-hub-lite tool-use list-tools --server baidu-search
 
+  # List instance tags for a server
+  mcp-hub-lite tool-use list-tags --server chrome-devtools
+
   # Get system tool schema
   mcp-hub-lite tool-use get-tool --tool list_tools
 
@@ -208,6 +215,22 @@ Examples:
                 console.log(JSON.stringify(result, null, 2));
                 break;
             }
+            case 'list-tags': {
+                if (!effectiveServer || effectiveServer === defaultServer) {
+                    effectiveServer = 'mcp-hub-lite';
+                }
+                const tagsParam = options.tags ? `?tags=${encodeURIComponent(options.tags)}` : '';
+                const response = await fetch(`${baseUrl}/web/hub-tools/servers/${effectiveServer}/tags${tagsParam}`, {
+                    headers: { Accept: 'application/json' }
+                });
+                if (!response.ok) {
+                    const error = await response.json().catch(() => ({ message: response.statusText }));
+                    throw new Error(error.message || `API error: ${response.status}`);
+                }
+                const result = await response.json();
+                console.log(JSON.stringify(result, null, 2));
+                break;
+            }
             case 'call-tool': {
                 if (!effectiveTool) {
                     console.error('Error: toolName is required for call-tool action');
@@ -242,7 +265,7 @@ Examples:
             }
             default: {
                 console.error(`Unknown action: ${action}`);
-                console.error('Valid actions: list-servers, list-tools, get-tool, call-tool');
+                console.error('Valid actions: list-servers, list-tools, list-tags, get-tool, call-tool');
                 process.exit(1);
             }
         }

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

@@ -10,6 +10,8 @@ interface ServerOptions {
 interface McpServerStatus {
     name: string;
     type: string;
+    displayName?: string;
+    tags?: Record<string, string>;
     connected: boolean;
     toolsCount: number;
     resourcesCount: number;

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,iBAO5C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0CjF;AAgED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW;;;;;;;;;;;;;;;;;;;KAUhC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB,EAAE,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB1E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/cli/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,iBAO5C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0CjF;AAoED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW;;;;;;;;;;;;;;;;;;;KAUhC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,iBAAiB,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB,EAAE,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB1E"}

package/dist/server/src/cli/server.js

@@ -173,6 +173,8 @@ async function fetchRuntimeStatus(host, port) {
         const result = statusData.map((item) => ({
             name: item.name,
             type: item.type,
+            displayName: item.displayName,
+            tags: item.tags,
             connected: item.status.connected,
             toolsCount: item.status.toolsCount,
             resourcesCount: item.status.resourcesCount,

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

@@ -32,17 +32,21 @@ export interface UpdateServerDescriptionParams {
     serverName: string;
     description: string;
 }
-export type SystemToolArgs = ListServersParams | ListToolsInServerParams | GetToolParams | CallToolParams | UpdateServerDescriptionParams;
+export interface ListTagsParams {
+    serverName: string;
+}
+export type SystemToolArgs = ListServersParams | ListToolsInServerParams | GetToolParams | CallToolParams | UpdateServerDescriptionParams | ListTagsParams;
 export declare const LIST_SERVERS_TOOL = "list_servers";
 export declare const LIST_TOOLS_TOOL = "list_tools";
 export declare const GET_TOOL_TOOL = "get_tool";
 export declare const CALL_TOOL_TOOL = "call_tool";
 export declare const UPDATE_SERVER_DESCRIPTION_TOOL = "update_server_description";
+export declare const LIST_TAGS_TOOL = "list_tags";
 /**
  * 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", "list_tools", "get_tool", "call_tool", "update_server_description"];
+export declare const SYSTEM_TOOL_NAMES: readonly ["list_servers", "list_tools", "get_tool", "call_tool", "update_server_description", "list_tags"];
 /**
  * Type definition for system tool names
  * Provides type safety when working with system tool names

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

@@ -1 +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,uBAAuB;IACtC,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,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,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,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,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,uBAAuB,GACvB,aAAa,GACb,cAAc,GACd,6BAA6B,CAAC;AAGlC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,+FAMpB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC"}
+{"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,uBAAuB;IACtC,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,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,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,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,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,uBAAuB,GACvB,aAAa,GACb,cAAc,GACd,6BAA6B,GAC7B,cAAc,CAAC;AAGnB,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,8BAA8B,8BAA8B,CAAC;AAC1E,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,4GAOpB,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

@@ -8,6 +8,7 @@ export const LIST_TOOLS_TOOL = 'list_tools';
 export const GET_TOOL_TOOL = 'get_tool';
 export const CALL_TOOL_TOOL = 'call_tool';
 export const UPDATE_SERVER_DESCRIPTION_TOOL = 'update_server_description';
+export const LIST_TAGS_TOOL = 'list_tags';
 /**
  * List of all system tool names
  * This array is used to identify system tools across the application
@@ -17,7 +18,8 @@ export const SYSTEM_TOOL_NAMES = [
     LIST_TOOLS_TOOL,
     GET_TOOL_TOOL,
     CALL_TOOL_TOOL,
-    UPDATE_SERVER_DESCRIPTION_TOOL
+    UPDATE_SERVER_DESCRIPTION_TOOL,
+    LIST_TAGS_TOOL
 ];
 // Individual gateway server name constant
 /**

package/dist/server/src/services/connection/connection-manager.d.ts

@@ -475,6 +475,12 @@ export declare class McpConnectionManager {
      * @returns ServerStatus or undefined if not connected
      */
     getStatusByName(name: string): ServerStatus | undefined;
+    /**
+     * Gets all connected instance indexes for a server.
+     * @param serverName - Server name
+     * @returns Array of connected instance indexes, empty if none connected
+     */
+    getConnectedIndexes(serverName: string): number[];
     /**
      * Gets the composite key of the first connected instance for a server name.
      * This is a backward compatibility method for code that expects getServerIdByName.

package/dist/server/src/services/connection/connection-manager.d.ts.map

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

package/dist/server/src/services/connection/connection-manager.js

@@ -995,6 +995,29 @@ export class McpConnectionManager {
         }
         return undefined;
     }
+    /**
+     * Gets all connected instance indexes for a server.
+     * @param serverName - Server name
+     * @returns Array of connected instance indexes, empty if none connected
+     */
+    getConnectedIndexes(serverName) {
+        // Directly iterate instances via hubManager, check each via getStatus
+        // This bypasses serverNameToCompositeKeys which may have stale/missing entries
+        // Note: We do NOT filter by instance.enabled here because:
+        // - enabled=false means "do not auto-start" (config), not "cannot be connected" (runtime)
+        // - A user can manually start an enabled=false instance, which should still appear in list_servers
+        const instances = hubManager.getServerInstancesByName(serverName);
+        const connectedIndexes = [];
+        for (const instance of instances) {
+            if (instance.index !== undefined) {
+                const status = this.getStatus(serverName, instance.index);
+                if (status?.connected) {
+                    connectedIndexes.push(instance.index);
+                }
+            }
+        }
+        return connectedIndexes;
+    }
     /**
      * Gets the composite key of the first connected instance for a server name.
      * This is a backward compatibility method for code that expects getServerIdByName.

package/dist/server/src/services/gateway/request-handlers/system-tools-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tools-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/system-tools-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyLnE"}
+{"version":3,"file":"system-tools-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/services/gateway/request-handlers/system-tools-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmNnE"}

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

@@ -6,7 +6,7 @@ import { McpError } from '@modelcontextprotocol/sdk/types.js';
 import { logger } from '../../../utils/index.js';
 import { LOG_MODULES } from '../../../utils/logger/log-modules.js';
 import { hubToolsService } from '../../hub-tools.service.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 { 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';
 /**
  * Register system tools handlers on the MCP server.
  *
@@ -192,4 +192,31 @@ export function registerSystemToolsHandlers(server) {
             }
         }
     });
+    // List tags
+    const ListTagsRequestSchema = z.object({
+        method: z.literal(LIST_TAGS_TOOL),
+        params: z.object({
+            serverName: z.string()
+        }),
+        id: z.union([z.string(), z.number()]),
+        jsonrpc: z.literal('2.0')
+    });
+    server.server.setRequestHandler(ListTagsRequestSchema, async (request) => {
+        try {
+            const result = await hubToolsService.listTags(request.params);
+            return result;
+        }
+        catch (error) {
+            logger.error(`List tags error:`, error, LOG_MODULES.SYSTEM_TOOLS_HANDLER);
+            if (error instanceof McpError) {
+                throw error;
+            }
+            else if (error instanceof Error) {
+                throw new McpError(-32802, error.message);
+            }
+            else {
+                throw new McpError(-32802, String(error));
+            }
+        }
+    });
 }

package/dist/server/src/services/gateway/tool-list-generator.js

@@ -55,7 +55,7 @@ export function generateGatewayToolsList(toolMap) {
                 if (!hasAggregatedTools) {
                     continue;
                 }
-                if (!aggregatedTools.includes(tool.name)) {
+                if (!Array.isArray(aggregatedTools) || !aggregatedTools.includes(tool.name)) {
                     continue;
                 }
             }

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

@@ -17,11 +17,18 @@ export declare class InstanceSelector {
     private static roundRobinCounters;
     /**
      * Select best instance based on configured strategy
+     *
+     * @param serverName - Name of the server
+     * @param serverConfig - Server configuration
+     * @param requestOptions - Optional request options for instance selection
+     * @param statusChecker - Optional function to check instance connection status (for testing)
      */
     static selectInstance(serverName: string, serverConfig: ServerConfig, requestOptions?: {
         sessionId?: string;
         tags?: Record<string, string>;
-    }): ServerInstance | undefined;
+    }, statusChecker?: (serverName: string, index: number) => {
+        connected?: boolean;
+    } | undefined): ServerInstance | undefined;
     private static selectRandomInstance;
     private static selectRoundRobinInstance;
     private static selectTagMatchUniqueInstance;

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

@@ -1 +1 @@
-{"version":3,"file":"instance-selector.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/instance-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGnF;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,aAAa,EAAE,MAAM;aACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;aACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAF3D,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA,EACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,YAAA;CAmB9E;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA6B;IAE9D;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GACrE,cAAc,GAAG,SAAS;IA+B7B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAUvC,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAiC5C"}
+{"version":3,"file":"instance-selector.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/instance-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAInF;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,aAAa,EAAE,MAAM;aACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;aACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAF3D,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAA,EACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,YAAA;CAmB9E;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA6B;IAE9D;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EACtE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,GACzF,cAAc,GAAG,SAAS;IAwC7B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAUvC,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAiC5C"}

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

@@ -1,4 +1,5 @@
 import { InstanceSelectionStrategy } from '../../models/server.model.js';
+import { mcpConnectionManager } from '../mcp-connection-manager.js';
 /**
  * Error thrown when tag-match-unique instance selection fails.
  * Passes raw data so the error class itself can format the message.
@@ -39,28 +40,41 @@ export class InstanceSelector {
     static roundRobinCounters = new Map();
     /**
      * Select best instance based on configured strategy
+     *
+     * @param serverName - Name of the server
+     * @param serverConfig - Server configuration
+     * @param requestOptions - Optional request options for instance selection
+     * @param statusChecker - Optional function to check instance connection status (for testing)
      */
-    static selectInstance(serverName, serverConfig, requestOptions) {
+    static selectInstance(serverName, serverConfig, requestOptions, statusChecker) {
         const { instances } = serverConfig;
         const instanceSelectionStrategy = serverConfig.template.instanceSelectionStrategy || InstanceSelectionStrategy.RANDOM;
-        // Filter enabled instances
-        const enabledInstances = instances.filter((instance) => instance.enabled !== false);
-        if (enabledInstances.length === 0) {
+        // Use provided statusChecker or default to mcpConnectionManager.getStatus
+        const checkStatus = statusChecker || ((name, idx) => mcpConnectionManager.getStatus(name, idx));
+        // Filter instances - use runtime connected status, NOT config enabled flag
+        // enabled=false means "do not auto-start" but user can manually start it
+        const connectedInstances = instances.filter((instance) => {
+            if (instance.index === undefined)
+                return false;
+            const status = checkStatus(serverName, instance.index);
+            return status?.connected;
+        });
+        if (connectedInstances.length === 0) {
             return undefined;
         }
         // Single instance case - return directly
-        if (enabledInstances.length === 1) {
-            return enabledInstances[0];
+        if (connectedInstances.length === 1) {
+            return connectedInstances[0];
         }
         switch (instanceSelectionStrategy) {
             case InstanceSelectionStrategy.RANDOM:
-                return this.selectRandomInstance(enabledInstances);
+                return this.selectRandomInstance(connectedInstances);
             case InstanceSelectionStrategy.ROUND_ROBIN:
-                return this.selectRoundRobinInstance(serverName, enabledInstances);
+                return this.selectRoundRobinInstance(serverName, connectedInstances);
             case InstanceSelectionStrategy.TAG_MATCH_UNIQUE:
-                return this.selectTagMatchUniqueInstance(enabledInstances, requestOptions?.tags);
+                return this.selectTagMatchUniqueInstance(connectedInstances, requestOptions?.tags);
             default:
-                return enabledInstances[0]; // Fallback to first instance
+                return connectedInstances[0]; // Fallback to first instance
         }
     }
     static selectRandomInstance(instances) {

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

@@ -1 +1 @@
-{"version":3,"file":"resource-generator.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/resource-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAUlE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AA6ID;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,uEACoC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,IAAI,QAAQ,EAAE,CAgErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,QAAQ,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAyGzD"}
+{"version":3,"file":"resource-generator.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/resource-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAUlE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AA6ID;;GAEG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,uEACoC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,IAAI,QAAQ,EAAE,CAqErD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,cAAc,GAAG,QAAQ,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAyGzD"}

package/dist/server/src/services/hub-tools/resource-generator.js

@@ -178,36 +178,40 @@ export function generateDynamicResources() {
         if (!hasValidId(server)) {
             continue;
         }
-        // Check if any instance is enabled
-        const hasEnabledInstance = server.config.instances.some((i) => i.enabled !== false);
-        if (!hasEnabledInstance) {
+        // Check if any instances are connected using getConnectedIndexes
+        const connectedIndexes = mcpConnectionManager.getConnectedIndexes(server.name);
+        if (connectedIndexes.length === 0) {
             continue;
         }
-        // Iterate over all instances to expose each instance's resources
+        // Second pass: generate resources for each connected instance
         for (const instance of server.config.instances) {
-            if (instance.enabled === false) {
+            const idx = instance.index;
+            if (idx === undefined) {
                 continue;
             }
-            const instanceIndex = instance.index;
-            // Server metadata resource (one per server, not per instance)
-            if (instanceIndex === 0) {
+            const instanceStatus = mcpConnectionManager.getStatus(server.name, idx);
+            if (!instanceStatus?.connected) {
+                continue;
+            }
+            // Server metadata resource (one per server, using first connected instance's index)
+            // Only generate once when we hit the first connected instance
+            if (idx === connectedIndexes[0]) {
                 resources.push({
                     uri: `hub://servers/${server.name}`,
                     name: `Server: ${server.name}`,
                     description: getServerDescription(server.config, server.name),
                     mimeType: 'application/json',
                     serverName: server.name,
-                    serverIndex: instanceIndex
+                    serverIndex: idx
                 });
             }
             // Get MCP native resources and map to hub format
-            const instanceIdx = instanceIndex ?? 0;
-            const mcpResources = mcpConnectionManager.getResources(server.name, instanceIdx);
+            const mcpResources = mcpConnectionManager.getResources(server.name, idx);
             for (const res of mcpResources) {
                 // Format: Resource: {ServerName} - {Index}: {Native Name}
-                const displayName = `Resource：${server.name} - ${instanceIdx}：${res.name}`;
+                const displayName = `Resource：${server.name} - ${idx}：${res.name}`;
                 resources.push({
-                    uri: mapMcpUriToHub(server.name, instanceIdx, res.uri),
+                    uri: mapMcpUriToHub(server.name, idx, res.uri),
                     name: displayName,
                     description: res.description,
                     mimeType: res.mimeType

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

@@ -1,10 +1,10 @@
 import type { RequestOptions, ServerInstanceInfo, ValidServer } from './types.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 declare function getServerDescription(serverConfig: {
     template?: {

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

@@ -1 +1 @@
-{"version":3,"file":"server-selector.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/server-selector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,EACjE,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CAMjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,cAAc,EAC/B,UAAU,GAAE,OAAc,GACzB,kBAAkB,GAAG,SAAS,CA8ChC"}
+{"version":3,"file":"server-selector.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/server-selector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,EACjE,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CAMjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,cAAc,EAC/B,UAAU,GAAE,OAAc,GACzB,kBAAkB,GAAG,SAAS,CA8ChC"}