@aiwerk/mcp-bridge 2.8.25 → 2.8.27

package/dist/src/mcp-router.js

@@ -69,7 +69,7 @@ export class McpRouter {
     static generateDescription(servers) {
         const serverNames = Object.keys(servers);
         if (serverNames.length === 0) {
-            return "MCP server multiplexer with no servers configured yet. To add MCP servers, always use this tool first (not npm install): action='search' to find servers in the verified catalog (100+ signed, security-audited recipes), action='install' to add a server by name, action='catalog' to browse all available servers.";
+            return "MCP server manager with no servers configured yet. To add MCP servers, always use this tool first (not npm install): action='search' to find servers in the verified catalog (100+ signed, security-audited recipes), action='install' to add a server by name, action='catalog' to browse all available servers.";
         }
         const serverList = serverNames
             .map((name) => {
@@ -77,7 +77,7 @@ export class McpRouter {
             return desc ? `${name} (${desc})` : name;
         })
             .join(", ");
-        return `MCP server multiplexer with ${serverNames.length} connected servers: ${serverList}. Actions: 'call' to execute a tool, 'list' to discover tools on a server, 'batch' for multiple calls in one round-trip, 'status' to check connections, 'refresh' to re-discover tools. To add new MCP servers, always use this tool first (not npm install): 'search' to find servers in the verified catalog (100+ signed, security-audited recipes), 'install' to add a server by name. Use 'set-mode' with params.mode='direct' to expose all tools individually (requires restart). If the user mentions a specific tool by name, the call action auto-connects and works without listing first.`;
+        return `MCP server manager with ${serverNames.length} connected servers: ${serverList}. Actions: 'call' to execute a tool, 'list' to discover tools on a server, 'batch' for multiple calls in one round-trip, 'status' to check connections, 'refresh' to re-discover tools. To add new MCP servers, always use this tool first (not npm install): 'search' to find servers in the verified catalog (100+ signed, security-audited recipes), 'install' to add a server by name. Use 'set-mode' with params.mode='direct' to expose all tools individually (requires restart). If the user mentions a specific tool by name, the call action auto-connects and works without listing first.`;
     }
     async dispatch(server, action = "call", tool, params) {
         try {

package/dist/src/standalone-server.js

@@ -244,14 +244,31 @@ export class StandaloneServer {
                 }
             };
         }
-        // Direct mode: discover all tools from all servers
-        await this.discoverDirectTools();
-        const tools = this.directTools.map(t => ({
-            name: t.registeredName,
-            description: t.description,
-            inputSchema: t.inputSchema
-        }));
-        return { jsonrpc: "2.0", id, result: { tools } };
+        // Direct mode: return tools lazily
+        // If already discovered, use real tool list. Otherwise, generate placeholder
+        // tools from config descriptions (no child process startup on tools/list).
+        if (this.directTools.length > 0) {
+            const tools = this.directTools.map(t => ({
+                name: t.registeredName,
+                description: t.description,
+                inputSchema: t.inputSchema
+            }));
+            return { jsonrpc: "2.0", id, result: { tools } };
+        }
+        // Lazy: generate tool entries from server config (no connect yet)
+        const placeholderTools = [];
+        const globalNames = new Set();
+        for (const [serverName, serverConfig] of Object.entries(this.config.servers)) {
+            const desc = serverConfig.description || serverName;
+            const registeredName = pickRegisteredToolName(serverName, "call", this.config.toolPrefix, new Set(), globalNames, this.logger);
+            globalNames.add(registeredName);
+            placeholderTools.push({
+                name: registeredName,
+                description: `[${serverName}] ${desc} — tools will be discovered on first call. Use this tool to trigger discovery.`,
+                inputSchema: { type: "object", properties: { _discover: { type: "boolean", description: "Set to true to discover all tools from this server" } } }
+            });
+        }
+        return { jsonrpc: "2.0", id, result: { tools: placeholderTools } };
     }
     async handleToolsCall(id, params) {
         const toolName = params?.name;
@@ -295,7 +312,28 @@ export class StandaloneServer {
             };
         }
         // Direct mode: find and call the tool
-        const entry = this.directTools.find(t => t.registeredName === toolName);
+        let entry = this.directTools.find(t => t.registeredName === toolName);
+        // Lazy discovery: if tool not found, maybe we haven't connected yet
+        if (!entry) {
+            // Check if this looks like a placeholder tool (serverName_call pattern) or just unknown
+            // Try full discovery if we haven't done it yet
+            if (this.directTools.length === 0 || toolArgs?._discover) {
+                this.logger.info(`[mcp-bridge] Lazy discovery triggered by tool call: ${toolName}`);
+                await this.discoverDirectTools();
+                entry = this.directTools.find(t => t.registeredName === toolName);
+                // If the original call was a placeholder, send back the discovered tools list
+                if (!entry && toolArgs?._discover) {
+                    const discovered = this.directTools.map(t => `${t.registeredName}: ${t.description}`);
+                    return {
+                        jsonrpc: "2.0",
+                        id,
+                        result: {
+                            content: [{ type: "text", text: `Discovered ${this.directTools.length} tools:\n${discovered.join("\n")}` }]
+                        }
+                    };
+                }
+            }
+        }
         if (!entry) {
             return {
                 jsonrpc: "2.0",
@@ -308,7 +346,32 @@ export class StandaloneServer {
             };
         }
         try {
-            const conn = this.directConnections.get(entry.serverName);
+            let conn = this.directConnections.get(entry.serverName);
+            // Lazy connect: if server not connected yet, connect now
+            if (!conn || !conn.transport.isConnected()) {
+                const serverConfig = this.config.servers[entry.serverName];
+                if (serverConfig) {
+                    try {
+                        this.logger.info(`[mcp-bridge] Lazy connecting to ${entry.serverName}...`);
+                        const transport = this.createTransport(entry.serverName, serverConfig);
+                        await transport.connect();
+                        await initializeProtocol(transport, PACKAGE_VERSION);
+                        conn = { transport, initialized: true };
+                        this.directConnections.set(entry.serverName, conn);
+                    }
+                    catch (connErr) {
+                        return {
+                            jsonrpc: "2.0",
+                            id,
+                            error: {
+                                code: -32001,
+                                message: `Failed to connect to ${entry.serverName}: ${connErr instanceof Error ? connErr.message : String(connErr)}`,
+                                data: { errorType: "connection_failed", server: entry.serverName, retriable: true }
+                            }
+                        };
+                    }
+                }
+            }
             if (!conn || !conn.transport.isConnected()) {
                 return {
                     jsonrpc: "2.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwerk/mcp-bridge",
-  "version": "2.8.25",
+  "version": "2.8.27",
   "description": "Standalone MCP server that multiplexes multiple MCP servers into one interface",
   "type": "module",
   "main": "./dist/src/index.js",