@loop_ouroboros/mcp-hub-lite 1.1.1 → 1.2.1

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

@@ -1,6 +1,6 @@
 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_IN_SERVER_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 } 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.
@@ -26,6 +26,7 @@ import type { SystemToolName, ListServersParams, ListToolsInServerParams, GetToo
  * - `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
+ * - `update-server-description`: Update the description of a specific MCP server
  *
  * ## Architecture Integration
  *
@@ -133,7 +134,7 @@ 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_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 ? {
+    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 ? {
         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 ? {

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

@@ -4,8 +4,9 @@ import { eventBus, EventTypes } from './event-bus.service.js';
 import { gateway } from './gateway.service.js';
 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_IN_SERVER_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, 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';
 /**
@@ -32,6 +33,7 @@ import { hasValidId, selectBestInstance, getServerDescription, getSystemTools, g
  * - `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
+ * - `update-server-description`: Update the description of a specific MCP server
  *
  * ## Architecture Integration
  *
@@ -182,7 +184,7 @@ export class HubToolsService {
         // Handle MCP Hub Lite server (return system tool)
         if (typeof args.serverName === 'string' && args.serverName === MCP_HUB_LITE_SERVER) {
             const systemTools = getSystemTools();
-            const found = systemTools.find((tool) => tool.name === args.toolName);
+            const found = systemTools.find((tool) => normalizeToolName(tool.name) === normalizeToolName(args.toolName));
             if (found) {
                 return {
                     ...found,
@@ -197,7 +199,7 @@ export class HubToolsService {
         if (tools.length === 0) {
             throw new Error(`Server not found: ${args.serverName}`);
         }
-        return tools.find((t) => t.name === args.toolName);
+        return tools.find((t) => normalizeToolName(t.name) === normalizeToolName(args.toolName));
     }
     /**
      * Updates the description of a specific MCP server.
@@ -251,7 +253,7 @@ export class HubToolsService {
                 case LIST_SERVERS_TOOL:
                     result = await this.listServers();
                     break;
-                case LIST_TOOLS_IN_SERVER_TOOL: {
+                case LIST_TOOLS_TOOL: {
                     result = await this.listToolsInServer(toolArgs);
                     break;
                 }
@@ -335,7 +337,7 @@ export class HubToolsService {
                 if (serverInfo && serverInfo.instance.id) {
                     const instanceIndex = serverInfo.instance.index;
                     const tools = mcpConnectionManager.getTools(server.name, instanceIndex);
-                    if (tools.some((tool) => tool.name === toolName)) {
+                    if (tools.some((tool) => normalizeToolName(tool.name) === normalizeToolName(toolName))) {
                         matchingServers.push(server.name);
                     }
                 }
@@ -354,13 +356,16 @@ export class HubToolsService {
         // Validate tool exists before doing strict instance selection
         // Use strictMode=false to get serverInfo without triggering tag-match-unique errors
         const validationServerInfo = selectBestInstance(serverName, requestOptions, false);
+        let actualToolName;
         if (validationServerInfo && validationServerInfo.instance.id) {
             const instanceIndex = validationServerInfo.instance.index;
             const tools = mcpConnectionManager.getTools(serverName, instanceIndex);
-            if (!tools.some((tool) => tool.name === toolName)) {
+            const matchedTool = tools.find((tool) => normalizeToolName(tool.name) === normalizeToolName(toolName));
+            if (!matchedTool) {
                 throw new Error(`Tool '${toolName}' not found in server '${serverName}'. ` +
-                    `Use list_tools_in_server(serverName: "${serverName}") to see available tools.`);
+                    `Use list_tools(serverName: "${serverName}") to see available tools.`);
             }
+            actualToolName = matchedTool.name;
         }
         const serverInfo = selectBestInstance(serverName, requestOptions, true);
         const requestId = `tool-call-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
@@ -374,27 +379,38 @@ export class HubToolsService {
                 throw new Error(`Server not found: ${serverName}`);
             }
             const instanceIndex = fallbackServerInfo.instance.index;
+            // If actualToolName not set yet, find it now
+            if (!actualToolName) {
+                const fallbackTools = mcpConnectionManager.getTools(serverName, instanceIndex);
+                const matchedTool = fallbackTools.find((tool) => normalizeToolName(tool.name) === normalizeToolName(toolName));
+                if (!matchedTool) {
+                    throw new Error(`Tool '${toolName}' not found in server '${serverName}'. ` +
+                        `Use list_tools(serverName: "${serverName}") to see available tools.`);
+                }
+                actualToolName = matchedTool.name;
+            }
+            const toolNameToUse = actualToolName || toolName;
             // Publish tool call started event with the resolved serverIndex
             eventBus.publish(EventTypes.TOOL_CALL_STARTED, {
                 requestId,
                 serverName,
                 serverIndex: instanceIndex,
-                toolName,
+                toolName: toolNameToUse,
                 timestamp: Date.now(),
                 args: toolArgs
             });
             try {
-                const result = await mcpConnectionManager.callTool(serverName, instanceIndex, toolName, toolArgs);
+                const result = await mcpConnectionManager.callTool(serverName, instanceIndex, toolNameToUse, toolArgs);
                 // Publish tool call completed event
                 eventBus.publish(EventTypes.TOOL_CALL_COMPLETED, {
                     requestId,
                     serverName,
                     serverIndex: instanceIndex,
-                    toolName,
+                    toolName: toolNameToUse,
                     timestamp: Date.now(),
                     result
                 });
-                logger.debug(`Tool call SUCCESS: serverName=${serverName}, toolName=${toolName}`, LOG_MODULES.HUB_TOOLS);
+                logger.debug(`Tool call SUCCESS: serverName=${serverName}, toolName=${toolNameToUse}`, LOG_MODULES.HUB_TOOLS);
                 return result;
             }
             catch (error) {
@@ -403,37 +419,38 @@ export class HubToolsService {
                     requestId,
                     serverName,
                     serverIndex: instanceIndex,
-                    toolName,
+                    toolName: toolNameToUse,
                     timestamp: Date.now(),
                     error: error instanceof Error ? error.message : String(error),
                     stack: error instanceof Error ? error.stack : undefined
                 });
-                logger.error(`Tool call FAILED: serverName=${serverName}, toolName=${toolName}, error=${error instanceof Error ? error.message : String(error)}`, error, LOG_MODULES.HUB_TOOLS);
+                logger.error(`Tool call FAILED: serverName=${serverName}, toolName=${toolNameToUse}, error=${error instanceof Error ? error.message : String(error)}`, error, LOG_MODULES.HUB_TOOLS);
                 throw error;
             }
         }
         const instanceIndex = serverInfo.instance.index;
+        const toolNameToUse = actualToolName || toolName;
         // Publish tool call started event
         eventBus.publish(EventTypes.TOOL_CALL_STARTED, {
             requestId,
             serverName,
             serverIndex: instanceIndex,
-            toolName,
+            toolName: toolNameToUse,
             timestamp: Date.now(),
             args: toolArgs
         });
         try {
-            const result = await mcpConnectionManager.callTool(serverName, instanceIndex, toolName, toolArgs);
+            const result = await mcpConnectionManager.callTool(serverName, instanceIndex, toolNameToUse, toolArgs);
             // Publish tool call completed event
             eventBus.publish(EventTypes.TOOL_CALL_COMPLETED, {
                 requestId,
                 serverName,
                 serverIndex: instanceIndex,
-                toolName,
+                toolName: toolNameToUse,
                 timestamp: Date.now(),
                 result
             });
-            logger.debug(`Tool call SUCCESS: serverName=${serverName}, toolName=${toolName}`, LOG_MODULES.HUB_TOOLS);
+            logger.debug(`Tool call SUCCESS: serverName=${serverName}, toolName=${toolNameToUse}`, LOG_MODULES.HUB_TOOLS);
             return result;
         }
         catch (error) {
@@ -442,12 +459,12 @@ export class HubToolsService {
                 requestId,
                 serverName,
                 serverIndex: instanceIndex,
-                toolName,
+                toolName: toolNameToUse,
                 timestamp: Date.now(),
                 error: error instanceof Error ? error.message : String(error),
                 stack: error instanceof Error ? error.stack : undefined
             });
-            logger.error(`Tool call FAILED: serverName=${serverName}, toolName=${toolName}, error=${error instanceof Error ? error.message : String(error)}`, error, LOG_MODULES.HUB_TOOLS);
+            logger.error(`Tool call FAILED: serverName=${serverName}, toolName=${toolNameToUse}, error=${error instanceof Error ? error.message : String(error)}`, error, LOG_MODULES.HUB_TOOLS);
             throw error;
         }
     }

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_IN_SERVER_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, MCP_HUB_LITE_SERVER } from '../models/system-tools.constants.js';
 import { stringifyForLogging } from '../utils/json-utils.js';
 /**
  * Unified system tool call handler
@@ -18,7 +18,7 @@ export class SystemToolHandler {
                 case LIST_SERVERS_TOOL:
                     result = await hubToolsService.listServers();
                     break;
-                case LIST_TOOLS_IN_SERVER_TOOL: {
+                case LIST_TOOLS_TOOL: {
                     const listToolsArgs = toolArgs;
                     result = await hubToolsService.listToolsInServer(listToolsArgs);
                     break;

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

@@ -1,4 +1,5 @@
 export { logger, LOG_MODULES } from './logger.js';
 export * from './sort-utils.js';
 export * from './version.js';
+export { normalizeToolName } from './name-converter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server/src/utils/index.js

@@ -1,3 +1,4 @@
 export { logger, LOG_MODULES } from './logger.js';
 export * from './sort-utils.js';
 export * from './version.js';
+export { normalizeToolName } from './name-converter.js';

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

@@ -0,0 +1,17 @@
+/**
+ * Normalizes a tool name to a standard format for comparison.
+ *
+ * This function converts various naming conventions (snake_case, kebab-case,
+ * camelCase, space-separated, or uppercase) into a normalized lowercase
+ * underscore format for consistent matching.
+ *
+ * @param toolName - The tool name to normalize
+ * @returns Normalized tool name in lowercase underscore format
+ * @example
+ * normalizeToolName('list-servers') // returns 'list_servers'
+ * normalizeToolName('LIST_SERVERS') // returns 'list_servers'
+ * normalizeToolName('chatCompletions') // returns 'chat_completions'
+ * normalizeToolName('chat_completions') // returns 'chat_completions'
+ */
+export declare function normalizeToolName(toolName: string): string;
+//# sourceMappingURL=name-converter.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,27 @@
+/**
+ * Normalizes a tool name to a standard format for comparison.
+ *
+ * This function converts various naming conventions (snake_case, kebab-case,
+ * camelCase, space-separated, or uppercase) into a normalized lowercase
+ * underscore format for consistent matching.
+ *
+ * @param toolName - The tool name to normalize
+ * @returns Normalized tool name in lowercase underscore format
+ * @example
+ * normalizeToolName('list-servers') // returns 'list_servers'
+ * normalizeToolName('LIST_SERVERS') // returns 'list_servers'
+ * normalizeToolName('chatCompletions') // returns 'chat_completions'
+ * normalizeToolName('chat_completions') // returns 'chat_completions'
+ */
+export function normalizeToolName(toolName) {
+    return (toolName
+        // Insert underscore before uppercase letters (for camelCase handling)
+        // e.g., 'chatCompletions' -> 'chat_Completions'
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        // Convert to lowercase
+        .toLowerCase()
+        // Replace hyphens, underscores, and spaces with single underscore
+        .replace(/[-_\s]+/g, '_')
+        // Remove leading and trailing underscores
+        .replace(/^_+|_+$/g, ''));
+}

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

@@ -613,7 +613,7 @@ describe('HubToolsService', () => {
             // Assert system tools - should have 5 tools now
             const systemToolNames = allTools['mcp-hub-lite'].tools.map((t) => t.name);
             expect(systemToolNames).toContain('list_servers');
-            expect(systemToolNames).toContain('list_tools_in_server');
+            expect(systemToolNames).toContain('list_tools');
             expect(systemToolNames).toContain('get_tool');
             expect(systemToolNames).toContain('call_tool');
             expect(systemToolNames).toContain('update_server_description');

package/dist/server/tests/unit/utils/name-converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=name-converter.test.d.ts.map

package/dist/server/tests/unit/utils/name-converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-converter.test.d.ts","sourceRoot":"","sources":["../../../../../tests/unit/utils/name-converter.test.ts"],"names":[],"mappings":""}

package/dist/server/tests/unit/utils/name-converter.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect } from 'vitest';
+import { normalizeToolName } from '../../../src/utils/name-converter.js';
+describe('name-converter', () => {
+    describe('normalizeToolName', () => {
+        it('should convert kebab-case to snake_case', () => {
+            expect(normalizeToolName('list-servers')).toBe('list_servers');
+            expect(normalizeToolName('get-tool')).toBe('get_tool');
+            expect(normalizeToolName('call-tool')).toBe('call_tool');
+        });
+        it('should convert uppercase to lowercase', () => {
+            expect(normalizeToolName('LIST_SERVERS')).toBe('list_servers');
+            expect(normalizeToolName('GET_TOOL')).toBe('get_tool');
+            expect(normalizeToolName('LIST_SERVERS_TOOL')).toBe('list_servers_tool');
+        });
+        it('should convert mixed case to lowercase with underscores', () => {
+            expect(normalizeToolName('ListServers')).toBe('list_servers');
+            expect(normalizeToolName('GetTool')).toBe('get_tool');
+            expect(normalizeToolName('chatCompletions')).toBe('chat_completions');
+        });
+        it('should convert space-separated to underscores', () => {
+            expect(normalizeToolName('list servers')).toBe('list_servers');
+            expect(normalizeToolName('get tool info')).toBe('get_tool_info');
+        });
+        it('should handle already normalized names', () => {
+            expect(normalizeToolName('list_servers')).toBe('list_servers');
+            expect(normalizeToolName('get_tool')).toBe('get_tool');
+            expect(normalizeToolName('chat_completions')).toBe('chat_completions');
+        });
+        it('should remove leading and trailing underscores', () => {
+            expect(normalizeToolName('_list_servers_')).toBe('list_servers');
+            expect(normalizeToolName('__get_tool__')).toBe('get_tool');
+        });
+        it('should handle multiple consecutive separators', () => {
+            expect(normalizeToolName('list--servers')).toBe('list_servers');
+            expect(normalizeToolName('list__servers')).toBe('list_servers');
+            expect(normalizeToolName('list   servers')).toBe('list_servers');
+            expect(normalizeToolName('list-_-servers')).toBe('list_servers');
+        });
+        it('should handle empty string', () => {
+            expect(normalizeToolName('')).toBe('');
+        });
+        it('should handle single character', () => {
+            expect(normalizeToolName('a')).toBe('a');
+            expect(normalizeToolName('A')).toBe('a');
+        });
+        it('should handle names with numbers', () => {
+            expect(normalizeToolName('tool123')).toBe('tool123');
+            expect(normalizeToolName('tool_123')).toBe('tool_123');
+            expect(normalizeToolName('tool-123')).toBe('tool_123');
+        });
+    });
+    describe('normalization consistency', () => {
+        it('should normalize different formats to the same value for same base name', () => {
+            // All these should normalize to the same value
+            const normalized = normalizeToolName('list_servers');
+            expect(normalizeToolName('list-servers')).toBe(normalized);
+            expect(normalizeToolName('LIST_SERVERS')).toBe(normalized);
+            expect(normalizeToolName('list_servers')).toBe(normalized);
+            expect(normalizeToolName('List_Servers')).toBe(normalized);
+        });
+        it('should convert camelCase to snake_case', () => {
+            // Note: camelCase normalization properly handles uppercase boundaries
+            // e.g., 'chatCompletions' -> 'chat_Completions' -> 'chat_completions'
+            expect(normalizeToolName('chatCompletions')).toBe('chat_completions');
+            expect(normalizeToolName('getTool')).toBe('get_tool');
+            expect(normalizeToolName('listServers')).toBe('list_servers');
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loop_ouroboros/mcp-hub-lite",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "A lightweight MCP management platform designed for independent developers",
   "license": "MIT",
   "author": "loop_ouroboros",
@@ -41,7 +41,7 @@
     "status": "node dist/server/src/cli/index.js status",
     "list": "node dist/server/src/cli/index.js list",
     "ui": "node dist/server/src/cli/index.js ui",
-    "server": "node dist/server/src/cli/index.js server",
+    "tool-use": "node dist/server/src/cli/index.js tool-use",
     "dev": "run-p dev:client dev:server",
     "dev:client": "vite",
     "dev:server": "tsx src/server/dev-server.ts",