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.
Files changed (21) hide show
  1. package/README.md +45 -9
  2. package/build/src/main.js +4 -4
  3. package/build/src/telemetry/{clearcut-logger.js → ClearcutLogger.js} +1 -1
  4. package/build/src/telemetry/watchdog/main.js +1 -1
  5. package/build/src/third_party/THIRD_PARTY_NOTICES +3 -3
  6. package/build/src/third_party/bundled-packages.json +2 -2
  7. package/build/src/third_party/index.js +1083 -1062
  8. package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidAllowlistItemType.md +12 -0
  9. package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidHeader.md +12 -0
  10. package/build/src/third_party/issue-descriptions/connectionAllowlistInvalidUrlPattern.md +8 -0
  11. package/build/src/third_party/issue-descriptions/connectionAllowlistItemNotInnerList.md +12 -0
  12. package/build/src/third_party/issue-descriptions/connectionAllowlistMoreThanOneList.md +7 -0
  13. package/build/src/third_party/issue-descriptions/connectionAllowlistReportingEndpointNotToken.md +10 -0
  14. package/package.json +4 -3
  15. package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataHttpNotFound.md +0 -1
  16. package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataInvalidResponse.md +0 -1
  17. package/build/src/third_party/issue-descriptions/federatedAuthRequestClientMetadataNoResponse.md +0 -1
  18. /package/build/src/telemetry/{watchdog-client.js → WatchdogClient.js} +0 -0
  19. /package/build/src/telemetry/{flag-utils.js → flagUtils.js} +0 -0
  20. /package/build/src/telemetry/{metric-utils.js → metricUtils.js} +0 -0
  21. /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
- Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://code.claude.com/docs/en/mcp">guide</a>):
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
- ### Operating system sandboxes
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/clearcut-logger.js';
16
- import { computeFlagUsage } from './telemetry/flag-utils.js';
17
- import { bucketizeLatency } from './telemetry/metric-utils.js';
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.0';
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 './watchdog-client.js';
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 './clearcut-sender.js';
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.2
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.0
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.3
653
+ Version: 7.7.4
654
654
  License: ISC
655
655
 
656
656
  The ISC License
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "@modelcontextprotocol/sdk": "1.26.0",
3
- "chrome-devtools-frontend": "1.0.1581449",
3
+ "chrome-devtools-frontend": "1.0.1583146",
4
4
  "core-js": "3.48.0",
5
5
  "debug": "4.4.3",
6
6
  "yargs": "18.0.0",
7
- "puppeteer-core": "24.37.2"
7
+ "puppeteer-core": "24.37.3"
8
8
  }