@loop_ouroboros/mcp-hub-lite 1.0.1 → 1.1.0

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

@@ -1,4 +1,4 @@
-import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, FIND_SERVERS_TOOL, LIST_ALL_TOOLS_IN_SERVER_TOOL, FIND_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, FIND_TOOLS_TOOL } from '../../models/system-tools.constants.js';
+import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, LIST_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, UPDATE_SERVER_DESCRIPTION_TOOL } from '../../models/system-tools.constants.js';
 /**
  * Retrieves the complete list of system tools provided by this service.
  *
@@ -8,12 +8,9 @@ import { SYSTEM_TOOL_NAMES, LIST_SERVERS_TOOL, FIND_SERVERS_TOOL, LIST_ALL_TOOLS
  *
  * The method implements all standard system tools:
  * - list-servers: List all connected servers
- * - find-servers: Find servers matching a pattern
- * - list-all-tools-in-server: List tools from a specific server
- * - find-tools-in-server: Find tools in a specific server
+ * - list-tools-in-server: List tools from a specific server
  * - get-tool: Get complete tool schema
  * - call-tool: Call a specific tool from a specific server
- * - find-tools: Find tools across all servers
  *
  * @returns {Array<{ name: string; description: string; inputSchema: JsonSchema; annotations?: ToolAnnotations }>}
  * Array of system tool configurations
@@ -46,33 +43,7 @@ export function getSystemTools() {
                     }
                 });
                 break;
-            case FIND_SERVERS_TOOL:
-                systemTools.push({
-                    name: toolName,
-                    description: 'Find servers matching a pattern',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            pattern: { type: 'string', description: 'Regex pattern to search for' },
-                            searchIn: {
-                                type: 'string',
-                                enum: ['name', 'description', 'both'],
-                                default: 'both'
-                            },
-                            caseSensitive: { type: 'boolean', default: false }
-                        },
-                        required: ['pattern']
-                    },
-                    annotations: {
-                        title: 'Find Servers',
-                        readOnlyHint: true,
-                        destructiveHint: false,
-                        idempotentHint: true,
-                        openWorldHint: false
-                    }
-                });
-                break;
-            case LIST_ALL_TOOLS_IN_SERVER_TOOL:
+            case LIST_TOOLS_IN_SERVER_TOOL:
                 systemTools.push({
                     name: toolName,
                     description: 'List all tools from a specific server',
@@ -99,40 +70,6 @@ export function getSystemTools() {
                     }
                 });
                 break;
-            case FIND_TOOLS_IN_SERVER_TOOL:
-                systemTools.push({
-                    name: toolName,
-                    description: 'Find tools matching a pattern in a specific server',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            serverName: { type: 'string', description: 'Name of the MCP server' },
-                            pattern: { type: 'string', description: 'Regex pattern to search for' },
-                            searchIn: {
-                                type: 'string',
-                                enum: ['name', 'description', 'both'],
-                                default: 'both'
-                            },
-                            caseSensitive: { type: 'boolean', default: false },
-                            requestOptions: {
-                                type: 'object',
-                                properties: {
-                                    sessionId: { type: 'string', description: 'Session ID for instance selection' },
-                                    tags: { type: 'object', description: 'Tags for instance selection' }
-                                }
-                            }
-                        },
-                        required: ['serverName', 'pattern']
-                    },
-                    annotations: {
-                        title: 'Find Tools in Server',
-                        readOnlyHint: true,
-                        destructiveHint: false,
-                        idempotentHint: true,
-                        openWorldHint: false
-                    }
-                });
-                break;
             case GET_TOOL_TOOL:
                 systemTools.push({
                     name: toolName,
@@ -164,11 +101,16 @@ export function getSystemTools() {
             case CALL_TOOL_TOOL:
                 systemTools.push({
                     name: toolName,
-                    description: 'Call a specific tool from a specific server',
+                    description: 'Call a specific tool from an external MCP server. ' +
+                        'System tools (list_servers, list_tools_in_server, get_tool, update_server_description) ' +
+                        'must be called directly via tools/call, not through this tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            serverName: { type: 'string', description: 'Name of the MCP server' },
+                            serverName: {
+                                type: 'string',
+                                description: 'Name of the MCP server (must be an external server, not mcp-hub-lite)'
+                            },
                             toolName: { type: 'string', description: 'Name of the tool to call' },
                             toolArgs: { type: 'object', description: 'Arguments to pass to the tool' },
                             requestOptions: {
@@ -190,26 +132,21 @@ export function getSystemTools() {
                     }
                 });
                 break;
-            case FIND_TOOLS_TOOL:
+            case UPDATE_SERVER_DESCRIPTION_TOOL:
                 systemTools.push({
                     name: toolName,
-                    description: 'Find tools matching a pattern across all connected servers',
+                    description: 'Update the description of a specific MCP server',
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            pattern: { type: 'string', description: 'Regex pattern to search for' },
-                            searchIn: {
-                                type: 'string',
-                                enum: ['name', 'description', 'both'],
-                                default: 'both'
-                            },
-                            caseSensitive: { type: 'boolean', default: false }
+                            serverName: { type: 'string', description: 'Name of the MCP server to update' },
+                            description: { type: 'string', description: 'New description text for the server' }
                         },
-                        required: ['pattern']
+                        required: ['serverName', 'description']
                     },
                     annotations: {
-                        title: 'Find Tools',
-                        readOnlyHint: true,
+                        title: 'Update Server Description',
+                        readOnlyHint: false,
                         destructiveHint: false,
                         idempotentHint: true,
                         openWorldHint: false

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

@@ -1,4 +1,4 @@
-import type { Tool } from '../../../shared/models/tool.model.js';
+import type { ToolSummary } from '../../../shared/models/tool.model.js';
 import type { RequestOptions } from './types.js';
 /**
  * Search options for server searches.
@@ -42,7 +42,7 @@ export declare function findServers(pattern: string, searchIn?: 'name' | 'descri
  * @param {'name' | 'description' | 'both'} [searchIn='both'] - Where to perform the search
  * @param {boolean} [caseSensitive=false] - Whether the search should be case-sensitive
  * @param {RequestOptions} [requestOptions] - Optional request options for instance selection
- * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and matching tools
+ * @returns {Promise<{ serverName: string; tools: ToolSummary[] }>} Object containing server name and matching tools
  * @throws {Error} If the specified server is not found or not connected
  *
  * @example
@@ -53,7 +53,7 @@ export declare function findServers(pattern: string, searchIn?: 'name' | 'descri
  */
 export declare function findToolsInServer(serverName: string, pattern: string, searchIn?: 'name' | 'description' | 'both', caseSensitive?: boolean, requestOptions?: RequestOptions): Promise<{
     serverName: string;
-    tools: Tool[];
+    tools: ToolSummary[];
 }>;
 /**
  * Finds tools matching a pattern across all connected MCP servers.
@@ -66,8 +66,8 @@ export declare function findToolsInServer(serverName: string, pattern: string, s
  * @param {string} pattern - Regex pattern to search for in tool names and descriptions
  * @param {'name' | 'description' | 'both'} [searchIn='both'] - Where to perform the search
  * @param {boolean} [caseSensitive=false] - Whether the search should be case-sensitive
- * @param {() => Promise<Record<string, { tools: Tool[] }>>} listAllToolsFn - Function to list all tools
- * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to matching tools
+ * @param {() => Promise<Record<string, { tools: ToolSummary[] }>>} listAllToolsFn - Function to list all tools
+ * @returns {Promise<Record<string, { tools: ToolSummary[] }>>} Object mapping server names to matching tools
  *
  * @example
  * ```typescript
@@ -78,8 +78,8 @@ export declare function findToolsInServer(serverName: string, pattern: string, s
  * ```
  */
 export declare function findTools(pattern: string, searchIn: "name" | "description" | "both" | undefined, caseSensitive: boolean | undefined, listAllToolsFn: () => Promise<Record<string, {
-    tools: Tool[];
+    tools: ToolSummary[];
 }>>): Promise<Record<string, {
-    tools: Tool[];
+    tools: ToolSummary[];
 }>>;
 //# sourceMappingURL=tool-search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/tool-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,GAAG,aAAa,GAAG,MAAe,EAClD,aAAa,GAAE,OAAe,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,GAAG,aAAa,GAAG,MAAe,EAClD,aAAa,GAAE,OAAe,EAC9B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf,CAAC,CAqBD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,YAAS,EAClD,aAAa,EAAE,OAAO,YAAQ,EAC9B,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAAC,GAC/D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAAC,CAsB5C"}
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/tool-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,GAAG,aAAa,GAAG,MAAe,EAClD,aAAa,GAAE,OAAe,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,GAAG,aAAa,GAAG,MAAe,EAClD,aAAa,GAAE,OAAe,EAC9B,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC,CA4BD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,YAAS,EAClD,aAAa,EAAE,OAAO,YAAQ,EAC9B,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAAC,GACtE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAAC,CAsBnD"}

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

@@ -47,7 +47,7 @@ export async function findServers(pattern, searchIn = 'both', caseSensitive = fa
  * @param {'name' | 'description' | 'both'} [searchIn='both'] - Where to perform the search
  * @param {boolean} [caseSensitive=false] - Whether the search should be case-sensitive
  * @param {RequestOptions} [requestOptions] - Optional request options for instance selection
- * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and matching tools
+ * @returns {Promise<{ serverName: string; tools: ToolSummary[] }>} Object containing server name and matching tools
  * @throws {Error} If the specified server is not found or not connected
  *
  * @example
@@ -68,9 +68,15 @@ export async function findToolsInServer(serverName, pattern, searchIn = 'both',
         const matchDescription = searchIn !== 'name' && tool.description && regex.test(tool.description);
         return matchName || matchDescription;
     });
+    // Convert to ToolSummary format
+    const toolSummaries = matchingTools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        serverName: serverName
+    }));
     return {
         serverName: serverName,
-        tools: matchingTools
+        tools: toolSummaries
     };
 }
 /**
@@ -84,8 +90,8 @@ export async function findToolsInServer(serverName, pattern, searchIn = 'both',
  * @param {string} pattern - Regex pattern to search for in tool names and descriptions
  * @param {'name' | 'description' | 'both'} [searchIn='both'] - Where to perform the search
  * @param {boolean} [caseSensitive=false] - Whether the search should be case-sensitive
- * @param {() => Promise<Record<string, { tools: Tool[] }>>} listAllToolsFn - Function to list all tools
- * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to matching tools
+ * @param {() => Promise<Record<string, { tools: ToolSummary[] }>>} listAllToolsFn - Function to list all tools
+ * @returns {Promise<Record<string, { tools: ToolSummary[] }>>} Object mapping server names to matching tools
  *
  * @example
  * ```typescript

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

@@ -1,4 +1,4 @@
-import type { ServerConfig, ServerInstanceConfig } from '../../config/config.schema.js';
+import type { ServerConfig } from '../../config/config.schema.js';
 /**
  * Configuration options for server instance selection in multi-instance scenarios.
  *
@@ -30,7 +30,7 @@ export interface RequestOptions {
 export type ServerInstanceInfo = {
     name: string;
     config: ServerConfig;
-    instance: ServerInstanceConfig & Record<string, unknown>;
+    instance: Record<string, unknown>;
 };
 /**
  * Type guard return type.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAG/B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/services/hub-tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAG/B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC"}

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

@@ -1,7 +1,7 @@
-import type { Tool } from '../../shared/models/tool.model.js';
+import type { Tool, ToolSummary } from '../../shared/models/tool.model.js';
 import type { Resource } from '../../shared/models/resource.model.js';
-import { LIST_SERVERS_TOOL, FIND_SERVERS_TOOL, LIST_ALL_TOOLS_IN_SERVER_TOOL, FIND_TOOLS_IN_SERVER_TOOL, GET_TOOL_TOOL, CALL_TOOL_TOOL, FIND_TOOLS_TOOL } from '../models/system-tools.constants.js';
-import type { SystemToolName, ListServersParams, FindServersParams, ListAllToolsInServerParams, FindToolsInServerParams, GetToolParams, CallToolParams, FindToolsParams } from '../models/system-tools.constants.js';
+import { LIST_SERVERS_TOOL, LIST_TOOLS_IN_SERVER_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';
 /**
  * Central service for managing system tools and MCP server interactions in the MCP Hub Lite gateway.
  *
@@ -13,7 +13,7 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  * ## Core Responsibilities
  *
  * - **System Tool Management**: Exposes a standardized set of system tools for server discovery and management
- * - **Tool Discovery**: Enables searching and listing tools across all connected MCP servers
+ * - **Tool Discovery**: Enables listing tools across all connected MCP servers
  * - **Tool Execution**: Provides safe, monitored execution of tools with comprehensive event tracking
  * - **Resource Management**: Dynamically generates and serves virtual resources representing server state
  * - **Instance Selection**: Handles intelligent server instance selection for multi-instance scenarios
@@ -23,12 +23,9 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  *
  * The service exposes the following system tools through the `getSystemTools()` method:
  * - `list-servers`: Retrieve all connected server names
- * - `find-servers`: Search servers by pattern matching
- * - `list-all-tools-in-server`: List all tools from a specific server
- * - `find-tools-in-server`: Search tools within a specific server
+ * - `list-tools-in-server`: List all tools from a specific server
  * - `get-tool`: Retrieve complete schema for a specific tool
  * - `call-tool`: Execute a tool on a specific server
- * - `find-tools`: Search tools across all connected servers
  *
  * ## Architecture Integration
  *
@@ -50,9 +47,6 @@ import type { SystemToolName, ListServersParams, FindServersParams, ListAllTools
  *
  * // Call a tool on a specific server
  * const result = await hubTools.callTool('file-system-server', 'list-files', { directory: '/home' });
- *
- * // Search for tools across all servers
- * const matchingTools = await hubTools.findTools('search');
  * ```
  */
 export declare class HubToolsService {
@@ -73,26 +67,16 @@ export declare class HubToolsService {
      */
     getSystemTools(): import("./hub-tools/system-tool-definitions.js").SystemToolDefinition[];
     /**
-     * Lists all connected MCP servers by name.
+     * Lists all connected MCP servers with their descriptions.
      *
      * This method retrieves all configured servers from the hub manager, filters out
-     * invalid entries using the hasValidId type guard, and returns an array of server names.
-     * It provides a simple way to discover available servers in the system.
-     *
-     * @returns {Promise<string[]>} Array of connected server names
-     */
-    listServers(): Promise<string[]>;
-    /**
-     * Finds servers matching a specified regex pattern.
-     *
-     * This method searches through all configured servers using the provided regex pattern,
-     * supporting flexible search options including case sensitivity and search scope
-     * (name, description, or both). It returns an array of matching server names.
+     * invalid entries using the hasValidId type guard, and returns a Record mapping
+     * server names to their descriptions. If a server doesn't have a description,
+     * a default description is provided.
      *
-     * @param {FindServersParams} args - Search parameters
-     * @returns {Promise<string[]>} Array of matching server names
+     * @returns {Promise<Record<string, string>>} Record mapping server names to descriptions
      */
-    findServers(args: FindServersParams): Promise<string[]>;
+    listServers(): Promise<Record<string, string>>;
     /**
      * Lists all tools available from a specific MCP server.
      *
@@ -101,29 +85,13 @@ export declare class HubToolsService {
      * It uses the selectBestInstance function to resolve server names to instances
      * and leverages the MCP connection manager for tool retrieval.
      *
-     * @param {ListAllToolsInServerParams} args - Server name and request options
-     * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and tools array
-     * @throws {Error} If the specified server is not found or not connected
-     */
-    listAllToolsInServer(args: ListAllToolsInServerParams): Promise<{
-        serverName: string;
-        tools: Tool[];
-    }>;
-    /**
-     * Finds tools matching a pattern within a specific MCP server.
-     *
-     * This method searches through all tools available from the specified server using
-     * the provided regex pattern, supporting flexible search options including case
-     * sensitivity and search scope (name, description, or both). It returns matching
-     * tools grouped by server name.
-     *
-     * @param {FindToolsInServerParams} args - Search parameters
-     * @returns {Promise<{ serverName: string; tools: Tool[] }>} Object containing server name and matching tools
+     * @param {ListToolsInServerParams} args - Server name and request options
+     * @returns {Promise<{ serverName: string; tools: ToolSummary[] }>} Object containing server name and tools array
      * @throws {Error} If the specified server is not found or not connected
      */
-    findToolsInServer(args: FindToolsInServerParams): Promise<{
+    listToolsInServer(args: ListToolsInServerParams): Promise<{
         serverName: string;
-        tools: Tool[];
+        tools: ToolSummary[];
     }>;
     /**
      * Retrieves the complete schema for a specific tool from a specific server.
@@ -137,6 +105,22 @@ export declare class HubToolsService {
      * @throws {Error} If the specified server is not found or not connected
      */
     getTool(args: GetToolParams): Promise<Tool | undefined>;
+    /**
+     * Updates the description of a specific MCP server.
+     *
+     * This method validates the server exists, updates its description in the configuration,
+     * and persists the change to disk. It leverages the existing hubManager.updateServer()
+     * method which handles configuration persistence and event publishing.
+     *
+     * @param {UpdateServerDescriptionParams} args - Server name and new description
+     * @returns {Promise<{ success: boolean; serverName: string; description: string }>} Confirmation of successful update
+     * @throws {Error} If the server is not found or update fails
+     */
+    updateServerDescription(args: UpdateServerDescriptionParams): Promise<{
+        success: boolean;
+        serverName: string;
+        description: string;
+    }>;
     /**
      * Calls a specific system tool directly with type-safe conditional return types.
      *
@@ -149,15 +133,14 @@ 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 FIND_SERVERS_TOOL ? FindServersParams : T extends typeof LIST_ALL_TOOLS_IN_SERVER_TOOL ? ListAllToolsInServerParams : T extends typeof FIND_TOOLS_IN_SERVER_TOOL ? FindToolsInServerParams : T extends typeof GET_TOOL_TOOL ? GetToolParams : T extends typeof CALL_TOOL_TOOL ? CallToolParams : T extends typeof FIND_TOOLS_TOOL ? FindToolsParams : never): Promise<T extends typeof LIST_SERVERS_TOOL ? string[] : T extends typeof FIND_SERVERS_TOOL ? string[] : T extends typeof LIST_ALL_TOOLS_IN_SERVER_TOOL ? {
+    callSystemTool<T extends SystemToolName>(toolName: T, toolArgs: T extends typeof LIST_SERVERS_TOOL ? ListServersParams : T extends typeof LIST_TOOLS_IN_SERVER_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_IN_SERVER_TOOL ? {
         serverName: string;
-        tools: Tool[];
-    } : T extends typeof FIND_TOOLS_IN_SERVER_TOOL ? {
+        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;
-        tools: Tool[];
-    } : T extends typeof GET_TOOL_TOOL ? Tool | undefined : T extends typeof CALL_TOOL_TOOL ? unknown : T extends typeof FIND_TOOLS_TOOL ? Record<string, {
-        tools: Tool[];
-    }> : never>;
+        description: string;
+    } : never>;
     /**
      * Calls a specific tool from a specific MCP server with comprehensive event tracking.
      *
@@ -178,24 +161,10 @@ export declare class HubToolsService {
      * the system tools provided by the MCP Hub Lite server itself. It returns a structured
      * object mapping server names to their respective tool arrays.
      *
-     * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to tool arrays
+     * @returns {Promise<Record<string, { tools: ToolSummary[] }>>} Object mapping server names to tool arrays
      */
     listAllTools(): Promise<Record<string, {
-        tools: Tool[];
-    }>>;
-    /**
-     * Finds tools matching a pattern across all connected MCP servers.
-     *
-     * This method searches through all available tools from all connected servers using the
-     * provided regex pattern, supporting flexible search options including case sensitivity
-     * and search scope (name, description, or both). It returns matching tools grouped by
-     * their originating server names.
-     *
-     * @param {FindToolsParams} args - Search parameters
-     * @returns {Promise<Record<string, { tools: Tool[] }>>} Object mapping server names to matching tools
-     */
-    findTools(args: FindToolsParams): Promise<Record<string, {
-        tools: Tool[];
+        tools: ToolSummary[];
     }>>;
     /**
      * Lists all dynamically generated Hub resources based on connected MCP servers.
@@ -218,18 +187,20 @@ export declare class HubToolsService {
      * - Resources list: hub://servers/{serverName}/resources
      *
      * @param {string} uri - Resource URI to read (e.g., hub://servers/server-name)
-     * @returns {Promise<ServerMetadata | Tool[] | Resource[]>} Resource content based on URI type
+     * @returns {Promise<ServerMetadata | Tool[] | Resource[] | string>} Resource content based on URI type
      * @throws {Error} If URI format is invalid, server not found, or resource type unknown
      */
     readResource(uri: string): Promise<{
         name: string;
         status: unknown;
         toolsCount: number;
+        tools: Record<string, string>;
         resourcesCount: number;
         tags: Record<string, string>;
         lastHeartbeat: number;
         uptime: number;
-    } | Tool[] | Resource[]>;
+        description: string;
+    } | Tool[] | Resource[] | string>;
 }
 export declare const hubToolsService: HubToolsService;
 //# sourceMappingURL=hub-tools.service.d.ts.map

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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"}