chrometools-mcp 3.5.2 → 3.5.3

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.5.3] - 2026-02-16
+
+### Fixed
+- **Bridge connection errors flooding stderr** — Bridge client no longer prints `console.error` on connection failures (ECONNREFUSED). All bridge connection errors are now debug-level only (visible with `DEBUG=1`). Fixes MCP clients showing scary error messages for users without Chrome Extension
+- **Unwanted auto-reconnect on startup** — `scheduleReconnect` now only triggers when a previously established connection is lost, not on initial connection failure. Eliminates 5 retry attempts when bridge service is simply not running
+- **Removed auto-install bridge from startup** — Bridge auto-installation via `reg add` (Windows registry) was running on every server start, which is intrusive and unnecessary for users without Chrome Extension. Bridge installation remains available via `npx chrometools-mcp --install-bridge`
+
 ## [3.5.2] - 2026-02-16
 
 ### Added

package/bridge/bridge-client.js

@@ -89,7 +89,7 @@ export async function connectToBridge() {
       ws = new WebSocket(`ws://127.0.0.1:${BRIDGE_PORT}`);
 
       const connectTimeout = setTimeout(() => {
-        console.error('[chrometools-mcp] Bridge connection timeout (5s)');
+        debugLog('Bridge connection timeout (5s)');
         logToFile('TIMEOUT: Connection timeout after 5s');
         ws?.close();
         resolve(false);
@@ -115,22 +115,27 @@ export async function connectToBridge() {
       });
 
       ws.on('close', (code, reason) => {
-        console.error(`[chrometools-mcp] Bridge disconnected (code=${code}, reason=${reason || 'none'})`);
+        debugLog(`Bridge disconnected (code=${code}, reason=${reason || 'none'})`);
         logToFile(`CLOSE: WebSocket closed, code=${code}, reason=${reason || 'none'}`);
+        const wasConnected = isConnected;
         isConnected = false;
         ws = null;
-        scheduleReconnect();
+        // Only reconnect if we were previously connected (lost connection)
+        // Don't reconnect if initial connection failed (bridge not running)
+        if (wasConnected) {
+          scheduleReconnect();
+        }
       });
 
       ws.on('error', (error) => {
         clearTimeout(connectTimeout);
-        console.error(`[chrometools-mcp] Bridge connection error: ${error.message}`);
+        debugLog(`Bridge connection error: ${error.message}`);
         logToFile(`ERROR: WebSocket error: ${error.message}`);
         resolve(false);
       });
 
     } catch (error) {
-      console.error(`[chrometools-mcp] Failed to create WebSocket: ${error.message}`);
+      debugLog(`Failed to create WebSocket: ${error.message}`);
       logToFile(`EXCEPTION: Failed to create WebSocket: ${error.message}`);
       resolve(false);
     }
@@ -143,12 +148,12 @@ export async function connectToBridge() {
 function scheduleReconnect() {
   if (reconnectTimer) return;
   if (reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
-    console.error(`[chrometools-mcp] Bridge: max reconnect attempts (${MAX_RECONNECT_ATTEMPTS}) reached, giving up`);
+    debugLog(`Bridge: max reconnect attempts (${MAX_RECONNECT_ATTEMPTS}) reached, giving up`);
     return;
   }
 
   reconnectAttempts++;
-  debugLog(`Scheduling reconnect attempt ${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS}`);
+  debugLog(`Scheduling Bridge reconnect attempt ${reconnectAttempts}/${MAX_RECONNECT_ATTEMPTS}`);
 
   reconnectTimer = setTimeout(async () => {
     reconnectTimer = null;

package/browser/browser-manager.js

@@ -264,7 +264,7 @@ function scheduleBridgeReconnect() {
     if (attempt < delays.length) {
       setTimeout(tryConnect, delays[attempt]);
     } else {
-      console.error('[chrometools-mcp] Bridge not available after Chrome launch. Run: npx chrometools-mcp --install-bridge');
+      debugLog('Bridge not available after Chrome launch (extension may not be installed)');
     }
   }
 

package/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import {Server} from "@modelcontextprotocol/sdk/server/index.js";
 import {StdioServerTransport} from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -3916,18 +3916,7 @@ async function main() {
     console.error("[chrometools-mcp] GUI mode requires X server (DISPLAY=" + (process.env.DISPLAY || "not set") + ")");
   }
 
-  // Auto-install bridge if not yet registered (required for extension <-> MCP communication)
-  try {
-    const { isBridgeInstalled, installBridge } = await import('./bridge/install.js');
-    if (!isBridgeInstalled()) {
-      console.error('[chrometools-mcp] Bridge not installed. Auto-installing...');
-      await installBridge({ silent: true });
-    }
-  } catch (e) {
-    console.error('[chrometools-mcp] Bridge auto-install failed:', e.message);
-  }
-
-  // Connect to Bridge Service (if running)
+  // Connect to Bridge Service (if running — optional, for Chrome Extension integration)
   await startWebSocketServer();
 
   // Register handler for syncing active tab when user switches tabs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrometools-mcp",
-  "version": "3.5.2",
+  "version": "3.5.3",
   "description": "MCP (Model Context Protocol) server for Chrome automation using Puppeteer. Persistent browser sessions, UI framework detection (MUI, Ant Design, etc.), Page Object support, visual testing, Figma comparison. Works seamlessly in WSL, Linux, macOS, and Windows.",
   "type": "module",
   "main": "index.js",