Skip to content

Commit 4f2147e

Browse files
claudeaceaeclaude
andcommitted
docs: improve clarity of setup instructions
- Update Chrome version requirement from 144 to 145 (now stable) - Add clearer distinction between automatic vs manual connection methods - Improve grammar consistency ("want" instead of "would like") - Add note about Chrome 145 being in stable channel (December 2024) - Add nvm usage example in contributing guide - Fix HTML escape sequence in Chrome version number These changes help users understand which setup method to choose and provide more accurate version requirements. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 28b8ff8 commit 4f2147e

File tree

2 files changed

+13
-8
lines changed

2 files changed

+13
-8
lines changed

CONTRIBUTING.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ for PR and commit titles.
3939

4040
## Installation
4141

42-
Check that you are using node version specified in .nvmrc, then run following commands:
42+
Check that you are using the Node.js version specified in `.nvmrc`, then run the following commands:
4343

4444
```sh
4545
git clone https://github.com/ChromeDevTools/chrome-devtools-mcp.git
@@ -48,6 +48,12 @@ npm ci
4848
npm run build
4949
```
5050

51+
If you're using [nvm](https://github.com/nvm-sh/nvm) (Node Version Manager), you can automatically use the correct version:
52+
53+
```sh
54+
nvm use
55+
```
56+
5157
### Testing with @modelcontextprotocol/inspector
5258

5359
```sh

README.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -486,20 +486,20 @@ the browser is closed.
486486

487487
By default, the Chrome DevTools MCP server will start a new Chrome instance with a dedicated profile. This might not be ideal in all situations:
488488

489-
- If you would like to maintain the same application state when alternating between manual site testing and agent-driven testing.
489+
- If you want to maintain the same application state when alternating between manual site testing and agent-driven testing.
490490
- When the MCP needs to sign into a website. Some accounts may prevent sign-in when the browser is controlled via WebDriver (the default launch mechanism for the Chrome DevTools MCP server).
491-
- If you're running your LLM inside a sandboxed environment, but you would like to connect to a Chrome instance that runs outside the sandbox.
491+
- If you're running your LLM inside a sandboxed environment, but you want to connect to a Chrome instance that runs outside the sandbox.
492492

493493
In these cases, start Chrome first and let the Chrome DevTools MCP server connect to it. There are two ways to do so:
494494

495-
- **Automatic connection (available in Chrome 144)**: best for sharing state between manual and agent-driven testing.
496-
- **Manual connection via remote debugging port**: best when running inside a sandboxed environment.
495+
- **Automatic connection (requires Chrome 145+)**: Best for sharing state between manual and agent-driven testing. Requires minimal setup.
496+
- **Manual connection via remote debugging port**: Best when running inside a sandboxed environment or when you need full control over the Chrome instance.
497497

498498
#### Automatically connecting to a running Chrome instance
499499

500500
**Step 1:** Set up remote debugging in Chrome
501501

502-
In Chrome (\>= M144), do the following to set up remote debugging:
502+
In Chrome (>= 145), do the following to set up remote debugging:
503503

504504
1. Navigate to `chrome://inspect/#remote-debugging` to enable remote debugging.
505505
2. Follow the dialog UI to allow or disallow incoming debugging connections.
@@ -522,8 +522,7 @@ The following code snippet is an example configuration for gemini-cli:
522522
}
523523
```
524524

525-
Note: you have to specify `--channel=beta` until Chrome M144 has reached the
526-
stable channel.
525+
Note: As of December 2024, Chrome 145 is in the stable channel. If you're using an older Chrome version, you may need to specify `--channel=beta` or `--channel=canary` to use a development version that supports this feature.
527526

528527
**Step 3:** Test your setup
529528

0 commit comments

Comments
 (0)