chrome-devtools-mcp 0.17.0 → 0.17.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -9
- package/build/src/main.js +4 -4
- package/build/src/telemetry/{clearcut-logger.js → ClearcutLogger.js} +1 -1
- package/build/src/telemetry/watchdog/main.js +1 -1
- package/build/src/third_party/THIRD_PARTY_NOTICES +3 -3
- package/build/src/third_party/bundled-packages.json +2 -2
- package/build/src/third_party/index.js +1083 -1062
- package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidAllowlistItemType.md +12 -0
- package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidHeader.md +12 -0
- package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidUrlPattern.md +8 -0
- package/build/src/third_party/issue-descriptions/connectionAllowlistItemNotInnerList.md +12 -0
- package/build/src/third_party/issue-descriptions/connectionAllowlistMoreThanOneList.md +7 -0
- package/build/src/third_party/issue-descriptions/connectionAllowlistReportingEndpointNotToken.md +10 -0
- package/package.json +4 -3
- package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataHttpNotFound.md +0 -1
- package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataInvalidResponse.md +0 -1
- package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataNoResponse.md +0 -1
- /package/build/src/telemetry/{watchdog-client.js → WatchdogClient.js} +0 -0
- /package/build/src/telemetry/{flag-utils.js → flagUtils.js} +0 -0
- /package/build/src/telemetry/{metric-utils.js → metricUtils.js} +0 -0
- /package/build/src/telemetry/watchdog/{clearcut-sender.js → ClearcutSender.js} +0 -0
package/README.md
CHANGED
|
@@ -113,12 +113,31 @@ Chrome DevTools MCP will not start the browser instance automatically using this
|
|
|
113
113
|
|
|
114
114
|
<details>
|
|
115
115
|
<summary>Claude Code</summary>
|
|
116
|
-
|
|
116
|
+
|
|
117
|
+
**Install via CLI (MCP only)**
|
|
118
|
+
|
|
119
|
+
Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://code.claude.com/docs/en/mcp">guide</a>):
|
|
117
120
|
|
|
118
121
|
```bash
|
|
119
122
|
claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest
|
|
120
123
|
```
|
|
121
124
|
|
|
125
|
+
**Install as a Plugin (MCP + Skills)**
|
|
126
|
+
|
|
127
|
+
To install Chrome DevTools MCP with skills, add the marketplace registry in Claude Code:
|
|
128
|
+
|
|
129
|
+
```sh
|
|
130
|
+
/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Then, install the plugin:
|
|
134
|
+
|
|
135
|
+
```sh
|
|
136
|
+
/plugin install chrome-devtools-mcp
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
Restart Claude Code to have the MCP server and skills load (check with `/skills`).
|
|
140
|
+
|
|
122
141
|
</details>
|
|
123
142
|
|
|
124
143
|
<details>
|
|
@@ -266,6 +285,30 @@ Or, from the IDE **Activity Bar** > `Kiro` > `MCP Servers` > `Click Open MCP Con
|
|
|
266
285
|
|
|
267
286
|
</details>
|
|
268
287
|
|
|
288
|
+
<details>
|
|
289
|
+
<summary>Katalon Studio</summary>
|
|
290
|
+
|
|
291
|
+
The Chrome DevTools MCP server can be used with <a href="https://docs.katalon.com/katalon-studio/studioassist/mcp-servers/setting-up-chrome-devtools-mcp-server-for-studioassist">Katalon StudioAssist</a> via an MCP proxy.
|
|
292
|
+
|
|
293
|
+
**Step 1:** Install the MCP proxy by following the <a href="https://docs.katalon.com/katalon-studio/studioassist/mcp-servers/setting-up-mcp-proxy-for-stdio-mcp-servers">MCP proxy setup guide</a>.
|
|
294
|
+
|
|
295
|
+
**Step 2:** Start the Chrome DevTools MCP server with the proxy:
|
|
296
|
+
|
|
297
|
+
```bash
|
|
298
|
+
mcp-proxy --transport streamablehttp --port 8080 -- npx -y chrome-devtools-mcp@latest
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
**Note:** You may need to pick another port if 8080 is already in use.
|
|
302
|
+
|
|
303
|
+
**Step 3:** In Katalon Studio, add the server to StudioAssist with the following settings:
|
|
304
|
+
|
|
305
|
+
- **Connection URL:** `http://127.0.0.1:8080/mcp`
|
|
306
|
+
- **Transport type:** `HTTP`
|
|
307
|
+
|
|
308
|
+
Once connected, the Chrome DevTools MCP tools will be available in StudioAssist.
|
|
309
|
+
|
|
310
|
+
</details>
|
|
311
|
+
|
|
269
312
|
<details>
|
|
270
313
|
<summary>OpenCode</summary>
|
|
271
314
|
|
|
@@ -669,11 +712,4 @@ Please consult [these instructions](./docs/debugging-android.md).
|
|
|
669
712
|
|
|
670
713
|
## Known limitations
|
|
671
714
|
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
Some MCP clients allow sandboxing the MCP server using macOS Seatbelt or Linux
|
|
675
|
-
containers. If sandboxes are enabled, `chrome-devtools-mcp` is not able to start
|
|
676
|
-
Chrome that requires permissions to create its own sandboxes. As a workaround,
|
|
677
|
-
either disable sandboxing for `chrome-devtools-mcp` in your MCP client or use
|
|
678
|
-
`--browser-url` to connect to a Chrome instance that you start manually outside
|
|
679
|
-
of the MCP client sandbox.
|
|
715
|
+
See [Troubleshooting](./docs/troubleshooting.md).
|
package/build/src/main.js
CHANGED
|
@@ -12,15 +12,15 @@ import { logger, saveLogsToFile } from './logger.js';
|
|
|
12
12
|
import { McpContext } from './McpContext.js';
|
|
13
13
|
import { McpResponse } from './McpResponse.js';
|
|
14
14
|
import { Mutex } from './Mutex.js';
|
|
15
|
-
import { ClearcutLogger } from './telemetry/
|
|
16
|
-
import { computeFlagUsage } from './telemetry/
|
|
17
|
-
import { bucketizeLatency } from './telemetry/
|
|
15
|
+
import { ClearcutLogger } from './telemetry/ClearcutLogger.js';
|
|
16
|
+
import { computeFlagUsage } from './telemetry/flagUtils.js';
|
|
17
|
+
import { bucketizeLatency } from './telemetry/metricUtils.js';
|
|
18
18
|
import { McpServer, StdioServerTransport, SetLevelRequestSchema, } from './third_party/index.js';
|
|
19
19
|
import { ToolCategory } from './tools/categories.js';
|
|
20
20
|
import { tools } from './tools/tools.js';
|
|
21
21
|
// If moved update release-please config
|
|
22
22
|
// x-release-please-start-version
|
|
23
|
-
const VERSION = '0.17.
|
|
23
|
+
const VERSION = '0.17.1';
|
|
24
24
|
// x-release-please-end
|
|
25
25
|
export const args = parseArguments(VERSION);
|
|
26
26
|
const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
|
|
@@ -7,7 +7,7 @@ import process from 'node:process';
|
|
|
7
7
|
import { logger } from '../logger.js';
|
|
8
8
|
import { FilePersistence } from './persistence.js';
|
|
9
9
|
import { WatchdogMessageType, OsType } from './types.js';
|
|
10
|
-
import { WatchdogClient } from './
|
|
10
|
+
import { WatchdogClient } from './WatchdogClient.js';
|
|
11
11
|
const MS_PER_DAY = 24 * 60 * 60 * 1000;
|
|
12
12
|
function detectOsType() {
|
|
13
13
|
switch (process.platform) {
|
|
@@ -8,7 +8,7 @@ import readline from 'node:readline';
|
|
|
8
8
|
import { parseArgs } from 'node:util';
|
|
9
9
|
import { logger, flushLogs, saveLogsToFile } from '../../logger.js';
|
|
10
10
|
import { WatchdogMessageType } from '../types.js';
|
|
11
|
-
import { ClearcutSender } from './
|
|
11
|
+
import { ClearcutSender } from './ClearcutSender.js';
|
|
12
12
|
function parseWatchdogArgs() {
|
|
13
13
|
const { values } = parseArgs({
|
|
14
14
|
options: {
|
|
@@ -636,21 +636,21 @@ SOFTWARE.
|
|
|
636
636
|
|
|
637
637
|
Name: puppeteer-core
|
|
638
638
|
URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
|
|
639
|
-
Version: 24.37.
|
|
639
|
+
Version: 24.37.3
|
|
640
640
|
License: Apache-2.0
|
|
641
641
|
|
|
642
642
|
-------------------- DEPENDENCY DIVIDER --------------------
|
|
643
643
|
|
|
644
644
|
Name: @puppeteer/browsers
|
|
645
645
|
URL: https://github.com/puppeteer/puppeteer/tree/main/packages/browsers
|
|
646
|
-
Version: 2.12.
|
|
646
|
+
Version: 2.12.1
|
|
647
647
|
License: Apache-2.0
|
|
648
648
|
|
|
649
649
|
-------------------- DEPENDENCY DIVIDER --------------------
|
|
650
650
|
|
|
651
651
|
Name: semver
|
|
652
652
|
URL: git+https://github.com/npm/node-semver.git
|
|
653
|
-
Version: 7.7.
|
|
653
|
+
Version: 7.7.4
|
|
654
654
|
License: ISC
|
|
655
655
|
|
|
656
656
|
The ISC License
|