feat: add protocolTimeout option

Author: Clawdbot

README.md

@@ -501,6 +501,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   Custom headers for WebSocket connection in JSON format (e.g., '{"Authorization":"Bearer token"}'). Only works with --wsEndpoint.
   - **Type:** string
 
+- **`--protocolTimeout`/ `--protocol-timeout`**
+  Timeout in milliseconds for Chrome DevTools Protocol commands. Passed to Puppeteer as protocolTimeout.
+  - **Type:** number
+
 - **`--headless`**
   Whether to run in headless (no UI) mode.
   - **Type:** boolean

src/bin/chrome-devtools-mcp-cli-options.ts

@@ -87,6 +87,20 @@ export const cliOptions = {
       }
     },
   },
+  protocolTimeout: {
+    type: 'number',
+    description:
+      'Timeout in milliseconds for Chrome DevTools Protocol commands. Passed to Puppeteer as protocolTimeout.',
+    coerce: (value: number | undefined) => {
+      if (value === undefined) {
+        return;
+      }
+      if (!Number.isFinite(value) || value <= 0) {
+        throw new Error('protocolTimeout must be a positive number of ms.');
+      }
+      return value;
+    },
+  },
   headless: {
     type: 'boolean',
     description: 'Whether to run in headless (no UI) mode.',

src/browser.ts

@@ -47,6 +47,7 @@ export async function ensureBrowserConnected(options: {
   browserURL?: string;
   wsEndpoint?: string;
   wsHeaders?: Record<string, string>;
+  protocolTimeout?: number;
   devtools: boolean;
   channel?: Channel;
   userDataDir?: string;
@@ -61,6 +62,7 @@ export async function ensureBrowserConnected(options: {
     targetFilter: makeTargetFilter(enableExtensions),
     defaultViewport: null,
     handleDevToolsAsPage: true,
+    protocolTimeout: options.protocolTimeout,
   };
 
   let autoConnect = false;
@@ -138,6 +140,7 @@ interface McpLaunchOptions {
   executablePath?: string;
   channel?: Channel;
   userDataDir?: string;
+  protocolTimeout?: number;
   headless: boolean;
   isolated: boolean;
   logFile?: fs.WriteStream;
@@ -229,6 +232,7 @@ export async function launch(options: McpLaunchOptions): Promise<Browser> {
       acceptInsecureCerts: options.acceptInsecureCerts,
       handleDevToolsAsPage: true,
       enableExtensions: options.enableExtensions,
+      protocolTimeout: options.protocolTimeout,
     });
     if (options.logFile) {
       // FIXME: we are probably subscribing too late to catch startup logs. We

src/index.ts

@@ -80,6 +80,7 @@ export async function createMcpServer(
             browserURL: serverArgs.browserUrl,
             wsEndpoint: serverArgs.wsEndpoint,
             wsHeaders: serverArgs.wsHeaders,
+            protocolTimeout: serverArgs.protocolTimeout,
             // Important: only pass channel, if autoConnect is true.
             channel: serverArgs.autoConnect
               ? (serverArgs.channel as Channel)
@@ -93,6 +94,7 @@ export async function createMcpServer(
             channel: serverArgs.channel as Channel,
             isolated: serverArgs.isolated ?? false,
             userDataDir: serverArgs.userDataDir,
+            protocolTimeout: serverArgs.protocolTimeout,
             logFile: options.logFile,
             viewport: serverArgs.viewport,
             chromeArgs,