@ejazullah/browser-mcp 0.0.60 → 0.0.62

package/lib/mcp/transport.js

@@ -29,7 +29,7 @@ export async function start(serverBackendFactory, options, authConfig) {
     if (options.port !== undefined) {
         const httpServer = await startHttpServer(options);
         const auth = new AuthManager(authConfig ?? defaultAuthConfig());
-        startHttpTransport(httpServer, serverBackendFactory, auth);
+        startHttpTransport(httpServer, serverBackendFactory, auth, !!options.heartbeat);
     }
     else {
         await startStdioTransport(serverBackendFactory);
@@ -157,7 +157,7 @@ function findSessionIdByCdpKey(sessionCdpKeys, sessions, cdpSessionKey) {
     }
     return undefined;
 }
-async function handleStreamable(serverBackendFactory, req, res, sessions, sessionCdpKeys) {
+async function handleStreamable(serverBackendFactory, req, res, sessions, sessionCdpKeys, runHeartbeat) {
     const cdpSessionKey = resolveClientCdpSessionKey(req);
     const sessionId = req.headers['mcp-session-id'];
     if (sessionId) {
@@ -168,6 +168,19 @@ async function handleStreamable(serverBackendFactory, req, res, sessions, sessio
                 res.end('Session not found');
                 return;
             }
+            if (cdpSessionKey) {
+                const matchedSessionId = findSessionIdByCdpKey(sessionCdpKeys, sessions, cdpSessionKey);
+                if (matchedSessionId) {
+                    const matchedTransport = sessions.get(matchedSessionId);
+                    testDebug(`stale mcp-session-id ${sessionId}, reusing cdp-matched session: ${matchedSessionId} (${cdpSessionKey})`);
+                    return await matchedTransport.handleRequest(req, res);
+                }
+            }
+            if (sessions.size === 1) {
+                const [singleSessionId, singleTransport] = sessions.entries().next().value;
+                testDebug(`stale mcp-session-id ${sessionId}, reusing single active session: ${singleSessionId}`);
+                return await singleTransport.handleRequest(req, res);
+            }
             delete req.headers['mcp-session-id'];
             testDebug(`stale http session id: ${sessionId}, creating a new session`);
         }
@@ -209,7 +222,7 @@ async function handleStreamable(serverBackendFactory, req, res, sessions, sessio
                 testDebug(`create http session: ${transport.sessionId}`);
                 if (cdpSessionKey)
                     sessionCdpKeys.set(sessionId, cdpSessionKey);
-                await mcpServer.connect(serverBackendFactory, transport, true);
+                await mcpServer.connect(serverBackendFactory, transport, runHeartbeat);
                 sessions.set(sessionId, transport);
             }
         });
@@ -226,7 +239,7 @@ async function handleStreamable(serverBackendFactory, req, res, sessions, sessio
     res.statusCode = 400;
     res.end('Invalid request');
 }
-function startHttpTransport(httpServer, serverBackendFactory, auth) {
+function startHttpTransport(httpServer, serverBackendFactory, auth, runHeartbeat) {
     const sseSessions = new Map();
     const streamableSessions = new Map();
     const streamableSessionCdpKeys = new Map();
@@ -254,7 +267,7 @@ function startHttpTransport(httpServer, serverBackendFactory, auth) {
             if (url.pathname.startsWith('/sse'))
                 await handleSSE(serverBackendFactory, req, res, url, sseSessions);
             else
-                await handleStreamable(serverBackendFactory, req, res, streamableSessions, streamableSessionCdpKeys);
+                await handleStreamable(serverBackendFactory, req, res, streamableSessions, streamableSessionCdpKeys, runHeartbeat);
         });
     });
     const url = httpAddressToString(httpServer.address());

package/lib/program.js

@@ -16,6 +16,7 @@
 import { program, Option } from 'commander';
 // @ts-ignore
 import { startTraceViewerServer } from 'playwright-core/lib/server';
+import debug from 'debug';
 import * as mcpTransport from './mcp/transport.js';
 import { commaSeparatedList, resolveCLIConfig, semicolonSeparatedList } from './config.js';
 import { buildAuthConfig } from './auth.js';
@@ -25,6 +26,28 @@ import { BrowserServerBackend } from './browserServerBackend.js';
 import { Context } from './context.js';
 import { contextFactory } from './browserContextFactory.js';
 import { runLoopTools } from './loopTools/main.js';
+const mcpDebugNamespace = 'pw:mcp:*';
+function setMcpDebugLogging(enabled) {
+    if (enabled === undefined)
+        return;
+    const current = process.env.DEBUG ?? '';
+    const namespaces = current.split(',').map(token => token.trim()).filter(Boolean);
+    if (enabled) {
+        if (!namespaces.includes(mcpDebugNamespace)) {
+            namespaces.push(mcpDebugNamespace);
+            process.env.DEBUG = namespaces.join(',');
+            debug.enable(process.env.DEBUG);
+        }
+        // eslint-disable-next-line no-console
+        console.error(`[mcp] verbose logs enabled (${mcpDebugNamespace})`);
+        return;
+    }
+    const filtered = namespaces.filter(ns => ns !== mcpDebugNamespace && !ns.startsWith('pw:mcp:'));
+    process.env.DEBUG = filtered.join(',');
+    debug.enable(process.env.DEBUG);
+    // eslint-disable-next-line no-console
+    console.error('[mcp] verbose logs disabled');
+}
 program
     .version('Version ' + packageJSON.version)
     .name(packageJSON.name)
@@ -53,6 +76,10 @@ program
     .option('--user-agent <ua string>', 'specify user agent string')
     .option('--user-data-dir <path>', 'path to the user data directory. If not specified, a temporary directory will be created.')
     .option('--viewport-size <size>', 'specify browser viewport size in pixels, for example "1280, 720"')
+    .option('--mcp-logs', 'Enable verbose MCP/session transport logs in CLI output')
+    .option('--no-mcp-logs', 'Disable verbose MCP/session transport logs in CLI output')
+    .option('--mcp-heartbeat', 'Enable MCP streamable transport heartbeat (may close sessions on slow/long operations)')
+    .option('--no-mcp-heartbeat', 'Disable MCP streamable transport heartbeat (recommended for n8n item-by-item runs)')
     .option('--mongodb-url <url>', 'MongoDB connection URL. Example: mongodb://localhost:27017')
     .option('--mongodb-db <name>', 'MongoDB database name. Default: playwright_mcp')
     .option('--mongodb-collection <name>', 'MongoDB collection name. Default: element_interactions')
@@ -67,6 +94,7 @@ program
     .addOption(new Option('--vision', 'Legacy option, use --caps=vision instead').hideHelp())
     .action(async (options) => {
     setupExitWatchdog();
+    setMcpDebugLogging(options.mcpLogs);
     if (options.vision) {
         // eslint-disable-next-line no-console
         console.error('The --vision option is deprecated, use --caps=vision instead');
@@ -87,7 +115,7 @@ program
         factories.push(createExtensionContextFactory(config));
     const serverBackendFactory = () => new BrowserServerBackend(config, factories);
     const authConfig = buildAuthConfig(options);
-    await mcpTransport.start(serverBackendFactory, config.server, authConfig);
+    await mcpTransport.start(serverBackendFactory, { ...config.server, heartbeat: options.mcpHeartbeat }, authConfig);
     if (config.saveTrace) {
         const server = await startTraceViewerServer();
         const urlPrefix = server.urlPrefix('human-readable');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ejazullah/browser-mcp",
-  "version": "0.0.60",
+  "version": "0.0.62",
   "description": "@ejazullah/browser-mcp - Enhanced Playwright Tools for MCP with CDP Support",
   "type": "module",
   "repository": {