文件历史

提交图

76 次代码提交

作者 SHA1 备注 提交日期
Alex Rudenko 7e279f1b67 feat: enable usage statistics by default with opt-out (#855)
## **Usage statistics**

Google collects usage statistics (such as tool invocation success rates,
latency, and environment information) to improve the reliability and
performance of Chrome DevTools MCP.

Data collection is **enabled by default**. You can opt-out by passing
the `--no-usage-statistics` flag when starting the server:

```json
"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]
```

Google handles this data in accordance with the [Google Privacy
Policy](https://policies.google.com/privacy).

Google's collection of usage statistics for Chrome DevTools MCP is
independent from the Chrome browser's usage statistics. Opting out of
Chrome metrics does not automatically opt you out of this tool, and
vice-versa.

The code determining statistics that are collected is in here
https://github.com/ChromeDevTools/chrome-devtools-mcp/tree/main/src/telemetry.
2026-01-28 10:18:10 +00:00
Alex Rudenko 0610d11aa9 docs: document how to add extensions to gemini-cli (#834) 2026-01-27 10:04:34 +00:00
zyzyzyryxy 6854d474c0 chore: fix bad html closing tag in README.md (#801)
Update ending tag of <a> to match.

Co-authored-by: Piotr Paulski <piotrpaulski@chromium.org>
2026-01-20 18:14:03 +00:00
Michael Hablich 6e52e66a7a docs: Update README.md to include a link to Android debugging (#783) 2026-01-16 09:34:24 +00:00
Alex Rudenko a106fbadbc docs: update auto-connect docs (#779)
Refs https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/775
2026-01-15 18:31:21 +00:00
adam jones f81cd2d8df docs: Update Claude Code instructions in README.md (#711)
Heya, Adam from @anthropics here 👋

We moved our Claude Code MCP docs, this PR updates the link. I've also
added the scope parameter given I think most users will prefer this to
be installed globally (and this matches the installation scope for other
coding assistants).
2026-01-13 12:34:52 +00:00
Lakshan Perera 9a51af219f feat: Allow opting out of default Chrome launch arguments (#729)
Related Issue -
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/430

### Description

When Chrome is launched via Puppeteer, it automatically adds a set of
default flags like `--enable-automation --disable-extensions
--disable-component-extensions-with-background-pages.`

Currently, there is no way to opt out of these defaults, which makes
certain use cases difficult or impossible to support. this PR adds a way
to selectively ignore specific default Chrome launch flags applied by
Puppeteer using its
[ignoreDefaultArgs](https://pptr.dev/api/puppeteer.launchoptions#ignoredefaultargs)
property.

```json
{
  "name": "chrome-devtools-mcp",
  "version": "latest",
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--ignore-default-chrome-arg='--enable-automation'",
        "--ignore-default-chrome-arg='--disable-extensions'"
      ]
    }
  }
}
```

**Feedback appreciated** @OrKoN
2026-01-12 10:08:18 +00:00
maroKanatani 1f532b8faf docs: claude code broken link (#707)
I fixed the broken link to Claude Code in the README.
2026-01-12 10:03:10 +00:00
Aiden Cline fbba3c9461 docs: update readme to include OpenCode example (#560)
closes: https://github.com/sst/opencode/issues/4377

---------

Co-authored-by: Sebastian Benz <sbenz@google.com>
2026-01-05 08:44:14 +00:00
Sebastian Benz 28b8ff8164 docs: autoConnect - clarify how the mcp server selects a profile (#693) 2025-12-18 18:05:47 +00:00
Sebastian Benz ab2340f401 docs: update auto connect docs to mention min Chrome version (#681) 2025-12-16 09:45:15 +01:00
Alex Rudenko 81cbd99f52 docs: enhance cli docs + sort required vs opt params (#674) 2025-12-13 09:16:04 +00:00
Sebastian Benz a537a8c8ce docs: explain new auto connection feature (#664) 2025-12-11 20:04:34 +01:00
Shayne Boyer 61ede1c053 fix: Update installation badges in README.md for VS Code (#660)
Broken images
2025-12-11 14:20:51 +00:00
Sebastian Benz 09111cc164 docs: improve autoConnect docs (#653)
Mention chrome://inspect/#remote-debugging in CLI docs and error
message.
2025-12-09 11:49:56 +01:00
Alex Rudenko 6ab6d85d50 feat: support --auto-connect to a Chrome instance (#651)
This PR adds a new connection mode called `--auto-connect`. To activate
it, add the `--auto-connect` flag to the chrome-devtools-mcp server
configuration. With this, chrome-devtools-mcp will automatically connect
to the running Chrome instance by looking up the port and the URL in the
user data dir for the specified `--channel` (by default, `stable`).
Requires Chrome M145.
2025-12-08 12:20:35 +00:00
Michael Hablich 90ed192c55 docs: Add AX design principles (#643) 2025-12-05 15:36:08 +01:00
Harald Kirschner cc4d065dd6 docs: add VS Code install badges (#532)
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/531

(Once https://github.com/mcp is the default GA registry in VS Code, the
link can be updated to show the registry page)

---------

Co-authored-by: Alex Rudenko <alexrudenko@chromium.org>
2025-12-03 10:17:29 +01:00
sntaoo 1a16f15546 docs: add Qoder CLI to the MCP client configuration section in the README. (#552)
This PR adds [Qoder CLI](https://qoder.com/cli) to the MCP client
configuration section in the README.

The Qoder CLI section:

Follows the same format as other MCP clients
Is placed in alphabetical order (between Qoder and Visual Studio)
Includes a link to the Qoder CLI
[documentation](https://docs.qoder.com/cli/using-cli#mcp-servsers)
Provides the command to add the Chrome DevTools MCP server using
`qodercli mcp add`

---------

Co-authored-by: Test <shaonengtao.snt@alibaba-inc.com>
2025-12-03 10:13:54 +01:00
Sebastian Benz 05cf8cb8a6 docs: clarify browser-url parameter in README (#613)
Fixes #609

---------

Co-authored-by: Paul Irish <paulirish@users.noreply.github.com>
2025-12-03 10:13:26 +01:00
Alex Rudenko fcaf55354c feat: support --user-data-dir (#622)
Allow configuring Chrome's `--user-data-dir` to allow changing the
defaults to support discovery of running Chrome instances later on.
2025-11-28 10:49:36 +01:00
Sebastian Benz 2d89865ddb docs: update readme to explain agy's browser integration (#612) 2025-11-26 16:28:50 +00:00
Michael Hablich fae2608887 docs: Fix Antigravity docs (#605) 2025-11-25 10:51:19 +00:00
Sebastian Benz 6f9182f4b6 docs: add Antigravity config (#580) 2025-11-19 17:53:12 +01:00
Eno Reyes 016e2fd6ee docs: add Factory CLI configuration to MCP clients (#523)
This PR adds Factory CLI to the MCP client configuration section in the
README.

The Factory CLI section:
- Follows the same format as other MCP clients
- Is placed in alphabetical order (between Cursor and Gemini CLI)
- Includes a link to the Factory documentation
- Provides the command to add the Chrome DevTools MCP server using
`droid mcp add`
2025-11-11 08:42:40 +00:00
Kilian Valkhof 8854a3400c docs: fix typos in README.md exlcude -> exclude (#513)
drive-by PR to fix some typos I spotted in the readme.
2025-11-03 14:21:34 +01:00
Alex Rudenko c06f4522ee refactor: merge emulate tools into one (#494)
Merges emulateCpu and emulateNetwork into a single tool to reduce token
consumption. Changes descriptions to be more concise.
2025-10-30 08:50:36 +00:00
Jack Franklin 63a5d824c2 docs: add Windsurf to the editor config README (#493) 2025-10-29 10:33:36 +00:00
Alex Rudenko d177087981 feat: support page reload (#462)
- merges navigation tools into a single tool.
- adds reload functionality.
- in a follow-up we will add options to reload.
2025-10-24 09:00:04 +00:00
Alex Rudenko b427392392 feat: add a press_key tool (#458)
Press key can be used to test shortcuts and individual key presses.
2025-10-23 16:18:58 +00:00
Alex Rudenko 0fe2b8a2b4 feat: allow configuring tool categories (#454)
This PR introduces a feature to disable some of the MCP server tool
categories to tailor it to specific use cases.

For example,

```
npx chrome-devtools-mcp@latest --no-category-emulation        Disable tools in the emulation category
npx chrome-devtools-mcp@latest --no-category-performance      Disable tools in the performance category
npx chrome-devtools-mcp@latest --no-category-network          Disable tools in the network category
```
2025-10-22 12:32:16 +02:00
Alina Varkki 92055933dc feat: tool to get a verbose single console message (#435) 2025-10-20 11:18:41 +02:00
Sean Gallen c7733a8180 docs: Update Copilot CLI instructions (#423)
This PR addresses issue #359 and updates instructions for Copilot CLI.
It removes the argument section and combines it with the command field.
2025-10-18 08:00:52 +02:00
Đào Hoàng Sơn 41d6a107ba feat: add WebSocket endpoint and custom headers support (#404)
## Summary
Add support for connecting to Chrome via WebSocket endpoint with custom
headers, enabling authenticated remote debugging scenarios and providing
an alternative to the HTTP-based connection method.

## What's New
This PR introduces two new CLI arguments:

- **`--wsEndpoint` / `-w`**: Connect directly to Chrome using a
WebSocket URL
  - Example: `ws://127.0.0.1:9222/devtools/browser/<id>`
  - Alternative to `--browserUrl` (mutually exclusive)
  
- **`--wsHeaders`**: Pass custom headers for WebSocket connections (JSON
format)
  - Example: `'{"Authorization":"Bearer token"}'`
  - Only works with `--wsEndpoint`

## Use Cases
- **Authenticated remote debugging**: Use API keys, tokens, or custom
auth headers
- **Secured instances**: Connect to browser instances requiring
authentication
2025-10-17 11:06:36 +02:00
circle33 9f9dab0787 docs: add VM-to-host remote debugging workaround (#399)
I think this part should be included in the document, I investigated it
for a long time at first, and it's not just me:
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/328
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/131
https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/139
2025-10-17 08:24:18 +02:00
hacke2 d8df784127 docs: add instructions for Qoder (#386)
Adds instructions on how to add Chrome DevTools MCP to
[Qoder](https://qoder.com/).

<img width="790" height="770" alt="image"
src="https://github.com/user-attachments/assets/f35ea275-91c2-49af-a5a4-09539164187a"
/>
2025-10-16 06:59:01 +00:00
siegerts f415c3ec57 docs: add instructions for Kiro (#347)
Adds instructions on how to add Chrome DevTools MCP to
[Kiro](https://kiro.dev).

<img width="706" height="449" alt="image"
src="https://github.com/user-attachments/assets/dab524b9-e684-4726-8f80-bffdfb3197cf"
/>
2025-10-12 17:44:21 +02:00
Michał Kiełbowicz 4ca045f9c6 docs: add Amp configuration to MCP client setup docs (#343)
Tool's website: https://ampcode.com

---------

Co-authored-by: Alex <alexei.rudenko@gmail.com>
2025-10-12 14:49:03 +00:00
Alex Rudenko 070e88cd63 docs: update browser URL from localhost to 127.0.0.1 (#342)
Chrome only listens on IPv4 and localhost might resolve to an IPv6 in
some environments.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/341
2025-10-11 21:15:10 +02:00
Alex Rudenko e1b5363653 feat: support passing args to Chrome (#338)
Drive-by: removes custom devtools frontend as a dedicated argument.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/261
2025-10-10 15:05:41 +00:00
Michael Hablich 1674c09f05 docs: Add step-by-step guide for connecting to running Chrome instance (#140) (#330) 2025-10-10 16:09:39 +02:00
Alex Rudenko 4892a6e3a7 docs: fix arg name typo (#327) 2025-10-10 07:11:36 +00:00
HARSHITH LUCKY 0c3b019b49 docs: fix typo in save configuration shortcut (#307) 2025-10-08 09:00:23 +00:00
Alex Rudenko 357db65d18 fix: change default screen size in headless (#299)
Sets the screen size in headless to be 3840x2160px to allow resize tool
to work correctly for most use cases.

Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/294
2025-10-07 13:27:23 +00:00
Xin Huang 3b197bccb0 docs: fix macOS typo (#263)
Fix the typo, rename MacOS to MacOS.
2025-10-07 09:06:55 +02:00
Nikolay Vitkov 2714158eb3 docs: fix typos (#260)
This also implements the suggestion from
https://github.com/ChromeDevTools/chrome-devtools-mcp/pull/244
but that includes other parts that I am not sure we would want for now.
2025-10-02 16:59:09 +02:00
Kim Hallberg 1de509eb87 docs: add instructions for Warp (#253)
Adds instructions on how to add Chrome DevTools MCP to Warp.
 
<img width="797" height="485" alt="Screenshot 2025-10-02 at 12 34 28"
src="https://github.com/user-attachments/assets/a62aa05d-512c-468e-86f8-41ce56357600"
/>

Co-authored-by: Sebastian Benz <sbenz@google.com>
2025-10-02 14:36:11 +00:00
shiomiyan 639d57d682 docs: update README.md typo (#251) 2025-10-02 11:35:18 +02:00
Alex Rudenko efb106dc94 feat: support --accept-insecure-certs CLI (#231)
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/155

Exposes the Puppeteer option only for the instances launched by the MCP
to avoid changing behavior for instances started by other means.
2025-10-01 10:21:05 +02:00
Alex Rudenko dfacc75ee9 feat: support --proxy-server CLI (#230)
Closes https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/155
2025-10-01 10:15:32 +02:00