You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+29Lines changed: 29 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -553,14 +553,17 @@ The Chrome DevTools MCP server supports the following configuration option:
553
553
-**`--browserUrl`/ `--browser-url`, `-u`**
554
554
Connect to a running, debuggable Chrome instance (e.g. `http://127.0.0.1:9222`). For more details see: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.
555
555
-**Type:** string
556
+
-**Default:**`false`
556
557
557
558
-**`--wsEndpoint`/ `--ws-endpoint`, `-w`**
558
559
WebSocket endpoint to connect to a running Chrome instance (e.g., ws://127.0.0.1:9222/devtools/browser/<id>). Alternative to --browserUrl.
559
560
-**Type:** string
561
+
-**Default:**`false`
560
562
561
563
-**`--wsHeaders`/ `--ws-headers`**
562
564
Custom headers for WebSocket connection in JSON format (e.g., '{"Authorization":"Bearer token"}'). Only works with --wsEndpoint.
563
565
-**Type:** string
566
+
-**Default:**`false`
564
567
565
568
-**`--headless`**
566
569
Whether to run in headless (no UI) mode.
@@ -570,87 +573,108 @@ The Chrome DevTools MCP server supports the following configuration option:
If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to false.
576
580
-**Type:** boolean
581
+
-**Default:**`false`
577
582
578
583
-**`--userDataDir`/ `--user-data-dir`**
579
584
Path to the user data directory for Chrome. Default is $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE
580
585
-**Type:** string
586
+
-**Default:**`false`
581
587
582
588
-**`--channel`**
583
589
Specify a different Chrome channel that should be used. The default is the stable channel version.
584
590
-**Type:** string
585
591
-**Choices:**`canary`, `dev`, `beta`, `stable`
592
+
-**Default:**`false`
586
593
587
594
-**`--logFile`/ `--log-file`**
588
595
Path to a file to write debug logs to. Set the env variable `DEBUG` to `*` to enable verbose logs. Useful for submitting bug reports.
589
596
-**Type:** string
597
+
-**Default:**`false`
590
598
591
599
-**`--viewport`**
592
600
Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.
593
601
-**Type:** string
602
+
-**Default:**`false`
594
603
595
604
-**`--proxyServer`/ `--proxy-server`**
596
605
Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.
Whether to enable coordinate-based tools such as click_at(x,y). Usually requires a computer-use model able to produce accurate coordinates by looking at screenshots.
Exposes experimental screencast tools (requires ffmpeg). Install ffmpeg https://www.ffmpeg.org/download.html and ensure it is available in the MCP server PATH.
Restricts network access by blocking specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Silently detaches from targets with blocked URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
Restricts network access by allowing only specified URL patterns (uses https://urlpattern.spec.whatwg.org/). Requires Chrome 149+. Silently detaches from targets with unallowed URLs upon connection, and blocks runtime requests (including navigations and subresources). Accepts an array of patterns.
Set to false to exclude tools related to emulation.
@@ -691,22 +715,27 @@ The Chrome DevTools MCP server supports the following configuration option:
691
715
Override the default output format used by take_screenshot when the caller does not specify one. JPEG and WebP are ~3-5x smaller than PNG, which helps reduce context size in AI conversations. Unset preserves the existing default ("png").
Override the default compression quality (0-100) used by take_screenshot for JPEG and WebP when the caller does not specify one. Lower values mean smaller files. Ignored for PNG. Unset preserves the Puppeteer default.
Maximum width in pixels for screenshots. If the captured image is wider, it is downscaled (preserving aspect ratio) before being returned. Reduces context size in AI conversations. Unset means no resize.
Maximum height in pixels for screenshots. If the captured image is taller, it is downscaled (preserving aspect ratio) before being returned. Can be combined with --screenshot-max-width; the smaller scale factor wins. Unset means no resize.
705
732
-**Type:** number
733
+
-**Default:**`false`
706
734
707
735
-**`--slim`**
708
736
Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.
0 commit comments