@ejazullah/browser-mcp 0.0.61 → 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) {
@@ -222,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);
             }
         });
@@ -239,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();
@@ -267,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

@@ -78,6 +78,8 @@ program
     .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')
@@ -113,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.61",
+  "version": "0.0.62",
   "description": "@ejazullah/browser-mcp - Enhanced Playwright Tools for MCP with CDP Support",
   "type": "module",
   "repository": {