@loop_ouroboros/mcp-hub-lite 1.2.4 → 1.2.5

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## [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/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.js

@@ -43,7 +43,7 @@ export class InstanceSelector {
     static selectInstance(serverName, serverConfig, requestOptions) {
         const { instances } = serverConfig;
         const instanceSelectionStrategy = serverConfig.template.instanceSelectionStrategy || InstanceSelectionStrategy.RANDOM;
-        // Filter enabled instances
+        // Filter instances - only use enabled instances
         const enabledInstances = instances.filter((instance) => instance.enabled !== false);
         if (enabledInstances.length === 0) {
             return undefined;

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,CAuFrD;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,55 @@ 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) {
+        let hasAnyConnectedInstance = false;
+        let firstConnectedInstanceIndex;
+        // First pass: check which instances are connected (consistent with /web/mcp/status API)
+        for (const instance of server.config.instances) {
+            const idx = instance.index;
+            if (idx === undefined) {
+                continue;
+            }
+            const instanceStatus = mcpConnectionManager.getStatus(server.name, idx);
+            if (instanceStatus?.connected) {
+                hasAnyConnectedInstance = true;
+                if (firstConnectedInstanceIndex === undefined) {
+                    firstConnectedInstanceIndex = idx;
+                }
+            }
+        }
+        // Skip server if no instances are connected
+        if (!hasAnyConnectedInstance) {
             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 instanceStatus = mcpConnectionManager.getStatus(server.name, idx);
+            if (!instanceStatus?.connected) {
                 continue;
             }
-            const instanceIndex = instance.index;
-            // Server metadata resource (one per server, not per instance)
-            if (instanceIndex === 0) {
+            // Server metadata resource (one per server, using first connected instance's index)
+            // Only generate once when we hit the first connected instance
+            if (idx === firstConnectedInstanceIndex) {
                 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"}

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.
@@ -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
@@ -237,6 +224,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 +295,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 +335,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 +398,33 @@ 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) {
+                    const enabledInstances = serverConfig.instances.filter((instance) => instance.enabled !== false);
+                    if (enabledInstances.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 +572,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.service.test.js

@@ -95,7 +95,7 @@ describe('HubToolsService', () => {
             // Assert
             expect(servers).toEqual({
                 'Test Server 1': 'File system operations',
-                'Test Server 2': 'Connected MCP server: Test Server 2'
+                'Test Server 2': 'Test Server 2 (You can check the tool list to understand its capabilities and update the description.)'
             });
             expect(hubManager.getAllServers).toHaveBeenCalledTimes(1);
         });
@@ -150,7 +150,7 @@ describe('HubToolsService', () => {
             const servers = await hubToolsService.listServers();
             // Assert
             expect(servers).toEqual({
-                server1: 'Connected MCP server: server1'
+                server1: 'server1 (You can check the tool list to understand its capabilities and update the description.)'
             });
         });
         it('should use provided description when available', async () => {
@@ -610,14 +610,15 @@ describe('HubToolsService', () => {
             // Assert - System tools under mcp-hub-lite
             expect(allTools).toHaveProperty('mcp-hub-lite');
             expect(Array.isArray(allTools['mcp-hub-lite'].tools)).toBe(true);
-            // Assert system tools - should have 5 tools now
+            // Assert system tools - should have 6 tools now
             const systemToolNames = allTools['mcp-hub-lite'].tools.map((t) => t.name);
             expect(systemToolNames).toContain('list_servers');
             expect(systemToolNames).toContain('list_tools');
             expect(systemToolNames).toContain('get_tool');
             expect(systemToolNames).toContain('call_tool');
             expect(systemToolNames).toContain('update_server_description');
-            expect(systemToolNames).toHaveLength(5);
+            expect(systemToolNames).toContain('list_tags');
+            expect(systemToolNames).toHaveLength(6);
             // Assert server tools - should have only name and description
             expect(allTools['Server 1'].tools).toEqual(expectedToolSummariesServer1);
             expect(allTools['Server 2'].tools).toEqual(expectedToolSummariesServer2);
@@ -783,7 +784,7 @@ describe('HubToolsService', () => {
                 lastHeartbeat: mockInstance.lastHeartbeat,
                 // @ts-expect-error - Accessing extra fields on mock
                 uptime: mockInstance.uptime,
-                description: `Connected MCP server: ${serverName}`
+                description: `${serverName} (You can check the tool list to understand its capabilities and update the description.)`
             });
         });
         it('should return tools list for tools URI', async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loop_ouroboros/mcp-hub-lite",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "A lightweight MCP management platform designed for independent developers",
   "license": "MIT",
   "author": "loop_ouroboros",