@aiwerk/mcp-bridge 2.8.5 → 2.8.7

package/dist/bin/mcp-bridge.js

@@ -195,12 +195,21 @@ All logs go to stderr. Stdout is reserved for the MCP protocol (stdio mode).
 }
 function cmdInit(logger) {
     initConfigDir(logger);
-    // Check if installed globally
-    const isGlobal = __dirname.includes("node_modules") && !__dirname.includes(homedir());
+    // Detect global install: check if we're in a global node_modules (not under a project)
+    // Global paths: ~/.nvm/.../lib/node_modules, /usr/lib/node_modules, etc.
+    // Local paths: ~/projects/.../node_modules, ~/node_modules/
+    const isGlobal = __dirname.includes("node_modules") && (__dirname.includes("/lib/node_modules/") || __dirname.includes("\\lib\\node_modules\\"));
+    const cmd = isGlobal ? "mcp-bridge" : `node ${join(__dirname, "..", "bin", "mcp-bridge.js")}`;
     process.stdout.write(`
 Next step: add mcp-bridge to your MCP client.
 
-Add this to your client's MCP server config:
+  Claude Code:    claude mcp add -s user mcp-bridge -- ${cmd} serve
+  Cursor:         Add to ~/.cursor/mcp.json
+  Claude Desktop: Add to claude_desktop_config.json
+  Windsurf:       Add to ~/.windsurf/mcp.json
+  OpenClaw:       openclaw plugins install @aiwerk/openclaw-mcp-bridge
+
+For Cursor/Claude Desktop/Windsurf, add this JSON block:
 
   {
     "mcp-bridge": {
@@ -208,9 +217,6 @@ Add this to your client's MCP server config:
       "args": ${isGlobal ? '["serve"]' : `["${join(__dirname, "..", "bin", "mcp-bridge.js")}", "serve"]`}
     }
   }
-
-Supported clients: Claude Code (~/.claude/settings.json),
-  Cursor (~/.cursor/mcp.json), Claude Desktop, Windsurf, OpenClaw, etc.
 ${!isGlobal ? "\nTip: Install globally for a cleaner setup:\n  npm install -g @aiwerk/mcp-bridge\n" : ""}
 After adding, restart your client. The bridge will appear as an 'mcp' tool
 with search, install, and catalog actions to discover and add MCP servers.

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

@@ -74,6 +74,32 @@ export type RouterDispatchResponse = {
         callCount: number;
         lastCall: string;
     }>;
+} | {
+    action: "search";
+    query: string;
+    results: Array<{
+        id: string;
+        name: string;
+        description: string;
+        category?: string;
+        auth?: string;
+    }>;
+} | {
+    action: "catalog";
+    recipes: Array<{
+        id: string;
+        name: string;
+        description: string;
+        category?: string;
+        auth?: string;
+    }>;
+} | {
+    action: "install";
+    server: string;
+    installed: boolean;
+    message: string;
+    missingEnvVars?: string[];
+    credentialsUrl?: string;
 } | {
     action: "intent";
     intent: string;
@@ -122,6 +148,7 @@ export declare class McpRouter {
     private readonly tokenManager;
     private readonly rateLimiter;
     private readonly requestIdState;
+    private readonly catalogClient;
     private intentRouter;
     private promotion;
     constructor(servers: Record<string, McpServerConfig>, clientConfig: McpClientConfig, logger: Logger, transportRefs?: Partial<RouterTransportRefs>);

package/dist/src/mcp-router.js

@@ -13,6 +13,8 @@ import { ToolResolver } from "./tool-resolution.js";
 import { OAuth2TokenManager } from "./oauth2-token-manager.js";
 import { FileTokenStore } from "./token-store.js";
 import { RateLimiter } from "./rate-limiter.js";
+import { CatalogClient } from "./catalog-client.js";
+import { recipeToServerConfig, collectRequiredEnvVars } from "./config.js";
 const DEFAULT_IDLE_TIMEOUT_MS = 10 * 60 * 1000;
 const DEFAULT_CONNECT_ERROR_COOLDOWN_MS = 10 * 1000;
 const DEFAULT_MAX_CONCURRENT = 5;
@@ -33,6 +35,7 @@ export class McpRouter {
     tokenManager;
     rateLimiter;
     requestIdState = { value: 0 };
+    catalogClient;
     intentRouter = null;
     promotion = null;
     constructor(servers, clientConfig, logger, transportRefs) {
@@ -58,6 +61,7 @@ export class McpRouter {
         this.toolResolver = new ToolResolver(Object.keys(servers));
         this.tokenManager = new OAuth2TokenManager(logger, new FileTokenStore());
         this.rateLimiter = new RateLimiter();
+        this.catalogClient = new CatalogClient({ logger });
         if (clientConfig.adaptivePromotion?.enabled) {
             this.promotion = new AdaptivePromotion(clientConfig.adaptivePromotion, logger);
         }
@@ -94,6 +98,100 @@ export class McpRouter {
                 }
                 return this.resolveIntent(intent);
             }
+            // Search catalog
+            if (normalizedAction === "search") {
+                const query = params?.query || server || tool;
+                if (!query) {
+                    return this.error("invalid_params", "query is required for action=search (pass as params.query or server field)");
+                }
+                if (!this.catalogClient) {
+                    return this.error("mcp_error", "Catalog client not available");
+                }
+                try {
+                    const results = await this.catalogClient.search(query);
+                    return {
+                        action: "search",
+                        query,
+                        results: results.map(r => ({
+                            id: r.name,
+                            name: r.name,
+                            description: r.description || "",
+                            category: r.category,
+                            auth: "none", // Search results don't include auth info
+                        }))
+                    };
+                }
+                catch (err) {
+                    return this.error("mcp_error", `Catalog search failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            // Browse catalog
+            if (normalizedAction === "catalog") {
+                if (!this.catalogClient) {
+                    return this.error("mcp_error", "Catalog client not available");
+                }
+                try {
+                    const recipeList = await this.catalogClient.list();
+                    return {
+                        action: "catalog",
+                        recipes: recipeList.results.map(r => ({
+                            id: r.name,
+                            name: r.name,
+                            description: r.description || "",
+                            category: r.category,
+                            auth: "none", // List results don't include auth info
+                        }))
+                    };
+                }
+                catch (err) {
+                    return this.error("mcp_error", `Catalog browse failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            // Install server from catalog (runtime only, not persisted to config file)
+            if (normalizedAction === "install") {
+                const serverName = server || params?.server;
+                if (!serverName) {
+                    return this.error("invalid_params", "server name is required for action=install");
+                }
+                if (this.servers[serverName]) {
+                    return { action: "install", server: serverName, installed: true, message: `Server "${serverName}" is already configured.` };
+                }
+                if (!this.catalogClient) {
+                    return this.error("mcp_error", "Catalog client not available");
+                }
+                try {
+                    const recipe = await this.catalogClient.resolve(serverName);
+                    const serverConfig = recipeToServerConfig(recipe);
+                    if (!serverConfig) {
+                        return this.error("mcp_error", `Unsupported recipe format for "${serverName}"`);
+                    }
+                    // Check env vars
+                    const requiredVars = collectRequiredEnvVars(recipe);
+                    const missing = requiredVars.filter(v => !process.env[v]);
+                    // Add to runtime config
+                    this.servers[serverName] = serverConfig;
+                    // Also update clientConfig.servers so generateDescription includes it
+                    this.clientConfig.servers[serverName] = serverConfig;
+                    if (missing.length > 0) {
+                        return {
+                            action: "install",
+                            server: serverName,
+                            installed: true,
+                            message: `Server "${serverName}" added (runtime). Missing env vars: ${missing.join(", ")}. Set them before calling.`,
+                            missingEnvVars: missing,
+                        };
+                    }
+                    return {
+                        action: "install",
+                        server: serverName,
+                        installed: true,
+                        message: `Server "${serverName}" installed and ready to use.`
+                    };
+                }
+                catch (err) {
+                    return this.error("mcp_error", `Install failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
             if (normalizedAction === "batch") {
                 const calls = params?.calls;
                 if (!Array.isArray(calls) || calls.length === 0) {
@@ -206,7 +304,7 @@ export class McpRouter {
                 }
             }
             if (normalizedAction !== "call") {
-                return this.error("invalid_params", `action must be one of: list, call, batch, refresh, schema, intent, status, promotions`);
+                return this.error("invalid_params", `action must be one of: list, call, batch, refresh, schema, intent, status, promotions, search, catalog, install`);
             }
             if (!tool) {
                 return this.error("invalid_params", "tool is required for action=call");

package/dist/src/standalone-server.js

@@ -221,7 +221,7 @@ export class StandaloneServer {
                                 type: "object",
                                 properties: {
                                     server: { type: "string", description: "Server name" },
-                                    action: { type: "string", description: "list | call | batch | refresh | status | intent | schema | promotions" },
+                                    action: { type: "string", description: "list | call | batch | refresh | status | intent | schema | promotions | search | catalog | install" },
                                     tool: { type: "string", description: "Tool name for action=call/schema" },
                                     params: { type: "object", description: "Tool arguments" },
                                     calls: {

package/package.json

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