@aiwerk/mcp-bridge 2.8.24 → 2.8.25

package/README.md

@@ -417,9 +417,24 @@ Returns promoted tools (sorted by frequency) and full usage stats. All tracking
 | Mode | Tools exposed | Best for |
 |------|--------------|----------|
 | `router` (default) | Single `mcp` meta-tool | 3+ servers, token-conscious agents |
-| `direct` | All tools individually | Few servers, simple agents |
+| `direct` | All tools individually | Clients with deferred/lazy tool loading (Claude Code), few servers |
 
-**Router mode** — the agent calls `mcp(server="todoist", action="list")` to discover, then `mcp(server="todoist", tool="find-tasks", params={...})` to execute.
+Switch modes via CLI or config:
+
+```bash
+mcp-bridge init --mode direct    # all tools exposed individually
+mcp-bridge init --mode router    # single mcp meta-tool (default)
+```
+
+Or set in `~/.mcp-bridge/config.json`:
+
+```json
+{ "mode": "direct" }
+```
+
+**Router mode** — the agent calls `mcp(server="todoist", action="list")` to discover, then `mcp(server="todoist", tool="find-tasks", params={...})` to execute. Best when you have many servers and want minimal token usage.
+
+**Direct mode** — all tools from all servers are registered individually as `todoist_find_tasks`, `github_list_repos`, etc. The bridge still provides unified config, catalog install, OAuth2, security, retries, and reconnection. Ideal for clients that support deferred/lazy tool loading, where tools are registered but not loaded into context until needed.
 
 ### Multi-Server Tool Resolution
 

package/dist/bin/mcp-bridge.js

@@ -221,7 +221,7 @@ function whichCmd(name) {
 }
 function cmdInit(logger, register, mode) {
     initConfigDir(logger);
-    // Apply --mode if config exists and mode was specified
+    // Apply --mode to config
     if (mode) {
         const configPath = join(homedir(), ".mcp-bridge", "config.json");
         if (existsSync(configPath)) {
@@ -236,6 +236,7 @@ function cmdInit(logger, register, mode) {
             catch { /* ignore parse errors */ }
         }
     }
+    // If --register is specified, do both mode + register
     const isGlobal = __dirname.includes("node_modules") && (__dirname.includes("/lib/node_modules/") || __dirname.includes("\\lib\\node_modules\\"));
     const bridgeCmd = isGlobal ? "mcp-bridge" : "node";
     const bridgeArgs = isGlobal ? ["serve"] : [join(__dirname, "..", "bin", "mcp-bridge.js"), "serve"];

package/dist/src/mcp-router.d.ts

@@ -110,6 +110,11 @@ export type RouterDispatchResponse = {
     message: string;
     missingEnvVars?: string[];
     credentialsUrl?: string;
+} | {
+    action: "set-mode";
+    mode: string;
+    message: string;
+    requiresRestart?: boolean;
 } | {
     action: "intent";
     intent: string;

package/dist/src/mcp-router.js

@@ -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. If the user mentions a specific tool by name, the call action auto-connects and works without listing first.`;
+        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.`;
     }
     async dispatch(server, action = "call", tool, params) {
         try {
@@ -340,8 +340,41 @@ export class McpRouter {
                     return this.error("connection_failed", `Failed to connect to ${server}: ${error instanceof Error ? error.message : String(error)}`);
                 }
             }
+            // Set mode (persists to config, requires bridge restart to take effect)
+            if (normalizedAction === "set-mode") {
+                const newMode = params?.mode;
+                if (newMode !== "router" && newMode !== "direct") {
+                    return this.error("invalid_params", "mode must be 'router' or 'direct'");
+                }
+                try {
+                    const os = await import("os");
+                    const fs = await import("fs");
+                    const path = await import("path");
+                    const configPath = path.join(os.homedir(), ".mcp-bridge", "config.json");
+                    if (fs.existsSync(configPath)) {
+                        const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+                        const oldMode = raw.mode || "router";
+                        if (oldMode === newMode) {
+                            return { action: "set-mode", mode: newMode, message: `Already in "${newMode}" mode.` };
+                        }
+                        raw.mode = newMode;
+                        fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n", "utf-8");
+                        this.logger.info(`Mode changed from "${oldMode}" to "${newMode}" in ${configPath}`);
+                        return {
+                            action: "set-mode",
+                            mode: newMode,
+                            message: `Mode changed to "${newMode}". Restart the bridge for changes to take effect.`,
+                            requiresRestart: true,
+                        };
+                    }
+                    return this.error("mcp_error", "Config file not found");
+                }
+                catch (err) {
+                    return this.error("mcp_error", `Failed to set mode: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
             if (normalizedAction !== "call") {
-                return this.error("invalid_params", `action must be one of: list, call, batch, refresh, schema, intent, status, promotions, search, catalog, install`);
+                return this.error("invalid_params", `action must be one of: list, call, batch, refresh, schema, intent, status, promotions, search, catalog, install, set-mode`);
             }
             if (!tool) {
                 return this.error("invalid_params", "tool is required for action=call");

package/package.json

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