Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
fed35b9
in-page tool output: handle DOM elements and limit depth
wolfib Apr 9, 2026
864287e
circle detection, replace instances with string representation
wolfib Apr 16, 2026
93769cb
update tests
wolfib Apr 16, 2026
5466128
docs: Include Mistral Vibe setup in README (#1801)
natorion Apr 10, 2026
f09de54
chore(deps-dev): bump chrome-devtools-frontend from 1.0.1611390 to 1.…
dependabot[bot] Apr 10, 2026
0a38f08
test: speed up .only (#1846)
OrKoN Apr 10, 2026
301d045
chore(deps): bump basic-ftp from 5.2.1 to 5.2.2 (#1849)
dependabot[bot] Apr 13, 2026
8a7b85a
chore(deps-dev): bump the dev-dependencies group across 1 directory w…
dependabot[bot] Apr 13, 2026
e959987
chore(deps-dev): bump globals from 17.4.0 to 17.5.0 in the dev-depend…
dependabot[bot] Apr 13, 2026
74fd545
feat: support DevTools header redactions as an option (#1848)
OrKoN Apr 14, 2026
e6ca072
chore: some build and test fixes (#1861)
Lightning00Blade Apr 14, 2026
90faa84
docs: Rename project and enhance README content (#1856)
natorion Apr 15, 2026
2ba1209
fix: remove double space in navigate error message (#1847)
kuishou68 Apr 15, 2026
576ba59
chore: add guidelines w.r.t. valid security issues (#1829)
mathiasbynens Apr 15, 2026
7d655df
chore(deps-dev): bump the dev-dependencies group with 5 updates (#1865)
dependabot[bot] Apr 15, 2026
49ca1a2
chore(deps-dev): bump chrome-devtools-frontend from 1.0.1611825 to 1.…
dependabot[bot] Apr 15, 2026
5305ecf
chore: turn arg name into snake case in sanitization (#1862)
yulunz Apr 15, 2026
4bb511e
feat: add tool call params logging (#1863)
yulunz Apr 15, 2026
345deac
chore(deps-dev): bump puppeteer from 24.40.0 to 24.41.0 in the bundle…
dependabot[bot] Apr 16, 2026
60303e1
feat: ensure extensions for file outputs (#1867)
OrKoN Apr 16, 2026
11057df
chore: better log watchdog entry (#1871)
yulunz Apr 16, 2026
83f911f
build: update to node24 for development (#1868)
OrKoN Apr 16, 2026
b01e13c
chore(deps): bump hono from 4.12.12 to 4.12.14 (#1872)
dependabot[bot] Apr 16, 2026
4d484ce
feat(webmcp): Add experimental tool to list WebMCP tools page exposes…
beaufortfrancois Apr 16, 2026
7a48781
feat(webmcp): Add experimental tool to execute WebMCP tool (#1873)
beaufortfrancois Apr 16, 2026
b174738
in-page tool output: handle DOM elements and limit depth
wolfib Apr 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 0 additions & 4 deletions .github/workflows/publish-to-npm-on-tag.yml
Original file line number Diff line number Diff line change
Expand Up @@ -36,10 +36,6 @@ jobs:
node-version-file: '.nvmrc'
registry-url: 'https://registry.npmjs.org'

# Ensure npm 11.5.1 or later is installed
- name: Update npm
run: npm install -g npm@latest

- name: Install dependencies
run: npm ci

Expand Down
2 changes: 1 addition & 1 deletion .nvmrc
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v22
v24
29 changes: 27 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# Chrome DevTools MCP
# Chrome DevTools for Agents

[![npm chrome-devtools-mcp package](https://img.shields.io/npm/v/chrome-devtools-mcp.svg)](https://npmjs.org/package/chrome-devtools-mcp)

`chrome-devtools-mcp` lets your coding agent (such as Gemini, Claude, Cursor or Copilot)
Chrome DevTools for Agents (`chrome-devtools-mcp`) lets your coding agent (such as Gemini, Claude, Cursor or Copilot)
control and inspect a live Chrome browser. It acts as a Model-Context-Protocol
(MCP) server, giving your AI coding assistant access to the full power of
Chrome DevTools for reliable automation, in-depth debugging, and performance analysis.
A [CLI](docs/cli.md) is also provided for use without MCP.

## [Tool reference](./docs/tool-reference.md) | [Changelog](./CHANGELOG.md) | [Contributing](./CONTRIBUTING.md) | [Troubleshooting](./docs/troubleshooting.md) | [Design Principles](./docs/design-principles.md)

Expand Down Expand Up @@ -373,6 +374,21 @@ Once connected, the Chrome DevTools MCP tools will be available in StudioAssist.

</details>

<details>
<summary>Mistral Vibe</summary>

Add in ~/.vibe/config.toml:

```toml
[[mcp_servers]]
name = "chrome-devtools"
transport = "stdio"
command = "npx"
args = ["chrome-devtools-mcp@latest"]
```

</details>

<details>
<summary>OpenCode</summary>

Expand Down Expand Up @@ -568,6 +584,10 @@ The Chrome DevTools MCP server supports the following configuration option:
Exposes experimental screencast tools (requires ffmpeg). Install ffmpeg https://www.ffmpeg.org/download.html and ensure it is available in the MCP server PATH.
- **Type:** boolean

- **`--experimentalWebmcp`/ `--experimental-webmcp`**
Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`
- **Type:** boolean

- **`--chromeArg`/ `--chrome-arg`**
Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
- **Type:** array
Expand Down Expand Up @@ -605,6 +625,11 @@ The Chrome DevTools MCP server supports the following configuration option:
Exposes a "slim" set of 3 tools covering navigation, script execution and screenshots only. Useful for basic browser tasks.
- **Type:** boolean

- **`--redactNetworkHeaders`/ `--redact-network-headers`**
If true, redacts some of the network headers considered senstive before returning to the client.
- **Type:** boolean
- **Default:** `false`

<!-- END AUTO GENERATED OPTIONS -->

Pass them via the `args` property in the JSON configuration. For example:
Expand Down
6 changes: 6 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
## Security policy

The Chrome DevTools MCP project takes security very seriously. Please use [Chromium’s process to report security issues](https://www.chromium.org/Home/chromium-security/reporting-security-bugs/).

### Scope

In general, it is the expectation that the AI agent or client using this MCP server validates any input before sending it. The server provides powerful capabilities for browser automation and inspection, and it is the responsibility of the calling agent to ensure these are used safely and as intended.

Several tools in this project have the ability to perform actions such as writing files to disk (e.g., via browser downloads or screenshots) or dynamically loading Chrome extensions. These are intentional, documented features and are not vulnerabilities.
Loading
Loading