Skip to content

Commit e7c5aac

Browse files
authored
docs: Update README with WSL configuration details
Added workarounds for using chrome-devtools-mcp in WSL.
1 parent 4782e48 commit e7c5aac

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -677,3 +677,15 @@ Chrome that requires permissions to create its own sandboxes. As a workaround,
677677
either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use
678678
`--browser-url` to connect to a Chrome instance that you start manually outside
679679
of the MCP client sandbox.
680+
681+
### WSL
682+
683+
In Windows WSL, the default configuration of `chrome-devtools-mcp` does not work
684+
if there is no Chrome installed inside the Linux machine. By defautl, `chrome-devtools-mcp`
685+
will try to start the Chrome instances on the Windows side but it fails due to https://github.com/microsoft/WSL/issues/14201.
686+
687+
Possible workarounds are:
688+
689+
- Install Google Chrome in WSL.
690+
- Configure Mirrored networking for WSL. Start Chrome on the Windows side we with `--remote-debugging-port=9222` and start `chrome-devtools-mcp` with `--browserUrl=http://127.0.0.1:9222`.
691+
- Use Powershell or Git bash instead of WSL.

0 commit comments

Comments
 (0)