chrome-devtools-mcp 0.20.1 → 0.20.3

package/README.md

@@ -156,6 +156,9 @@ Then, install the plugin:
 
 Restart Claude Code to have the MCP server and skills load (check with `/skills`).
 
+> [!TIP]
+> If the plugin installation fails with a `Failed to clone repository` error (e.g., HTTPS connectivity issues behind a corporate firewall), see the [troubleshooting guide](./docs/troubleshooting.md#claude-code-plugin-installation-fails-with-failed-to-clone-repository) for workarounds, or use the CLI installation method above instead.
+
 </details>
 
 <details>

package/build/src/McpContext.js

@@ -7,7 +7,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { UniverseManager } from './DevtoolsUtils.js';
 import { McpPage } from './McpPage.js';
-import { NetworkCollector, ConsoleCollector } from './PageCollector.js';
+import { NetworkCollector, ConsoleCollector, } from './PageCollector.js';
 import { Locator } from './third_party/index.js';
 import { PredefinedNetworkConditions } from './third_party/index.js';
 import { listPages } from './tools/pages.js';
@@ -472,10 +472,18 @@ export class McpContext {
             if (!mcpPage) {
                 return;
             }
-            if (await page.hasDevTools()) {
-                mcpPage.devToolsPage = await page.openDevTools();
+            // Prior to Chrome 144.0.7559.59, the command fails,
+            // Some Electron apps still use older version
+            // Fall back to not exposing DevTools at all.
+            try {
+                if (await page.hasDevTools()) {
+                    mcpPage.devToolsPage = await page.openDevTools();
+                }
+                else {
+                    mcpPage.devToolsPage = undefined;
+                }
             }
-            else {
+            catch {
                 mcpPage.devToolsPage = undefined;
             }
         }));

package/build/src/PageCollector.js

@@ -28,7 +28,7 @@ export class PageCollector {
     #browser;
     #listenersInitializer;
     #listeners = new WeakMap();
-    #maxNavigationSaved = 3;
+    maxNavigationSaved = 3;
     /**
      * This maps a Page to a list of navigations with a sub-list
      * of all collected resources.
@@ -109,7 +109,7 @@ export class PageCollector {
         }
         // Add the latest navigation first
         navigations.unshift([]);
-        navigations.splice(this.#maxNavigationSaved);
+        navigations.splice(this.maxNavigationSaved);
     }
     cleanupPageDestroyed(page) {
         const listeners = this.#listeners.get(page);
@@ -129,7 +129,7 @@ export class PageCollector {
             return navigations[0];
         }
         const data = [];
-        for (let index = this.#maxNavigationSaved; index >= 0; index--) {
+        for (let index = this.maxNavigationSaved; index >= 0; index--) {
             if (navigations[index]) {
                 data.push(...navigations[index]);
             }
@@ -305,5 +305,6 @@ export class NetworkCollector extends PageCollector {
         else {
             navigations.unshift([]);
         }
+        navigations.splice(this.maxNavigationSaved);
     }
 }

package/build/src/bin/chrome-devtools-mcp-cli-options.js

@@ -8,7 +8,7 @@ export const cliOptions = {
     autoConnect: {
         type: 'boolean',
         description: 'If specified, automatically connects to a browser (Chrome 144+) running locally from the user data directory identified by the channel param (default channel is stable). Requires the remoted debugging server to be started in the Chrome instance via chrome://inspect/#remote-debugging.',
-        conflicts: ['isolated', 'executablePath'],
+        conflicts: ['isolated', 'executablePath', 'categoryExtensions'],
         default: false,
         coerce: (value) => {
             if (!value) {
@@ -21,7 +21,7 @@ export const cliOptions = {
         type: 'string',
         description: 'Connect to a running, debuggable Chrome instance (e.g. `http://127.0.0.1:9222`). For more details see: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.',
         alias: 'u',
-        conflicts: 'wsEndpoint',
+        conflicts: ['wsEndpoint', 'categoryExtensions'],
         coerce: (url) => {
             if (!url) {
                 return;
@@ -39,7 +39,7 @@ export const cliOptions = {
         type: 'string',
         description: 'WebSocket endpoint to connect to a running Chrome instance (e.g., ws://127.0.0.1:9222/devtools/browser/<id>). Alternative to --browserUrl.',
         alias: 'w',
-        conflicts: 'browserUrl',
+        conflicts: ['browserUrl', 'categoryExtensions'],
         coerce: (url) => {
             if (!url) {
                 return;
@@ -193,9 +193,9 @@ export const cliOptions = {
     },
     categoryExtensions: {
         type: 'boolean',
-        default: false,
         hidden: true,
-        describe: 'Set to false to exclude tools related to extensions.',
+        conflicts: ['browserUrl', 'autoConnect', 'wsEndpoint'],
+        describe: 'Set to true to include tools related to extensions. Note: This feature is only supported with a pipe connection. autoConnect is not supported.',
     },
     performanceCrux: {
         type: 'boolean',

package/build/src/index.js

@@ -95,7 +95,7 @@ export async function createMcpServer(serverArgs, options) {
             return;
         }
         if (tool.annotations.category === ToolCategory.EXTENSIONS &&
-            serverArgs.categoryExtensions === false) {
+            !serverArgs.categoryExtensions) {
             return;
         }
         if (tool.annotations.conditions?.includes('computerVision') &&

package/build/src/third_party/bundled-packages.json

@@ -1,6 +1,6 @@
 {
   "@modelcontextprotocol/sdk": "1.27.1",
-  "chrome-devtools-frontend": "1.0.1596260",
+  "chrome-devtools-frontend": "1.0.1599001",
   "core-js": "3.48.0",
   "debug": "4.4.3",
   "lighthouse": "13.0.3",

package/build/src/third_party/devtools-formatter-worker.js

@@ -3117,7 +3117,6 @@ var ExperimentName;
     ExperimentName["SHOW_OPTION_TO_EXPOSE_INTERNALS_IN_HEAP_SNAPSHOT"] = "show-option-to-expose-internals-in-heap-snapshot";
     ExperimentName["TIMELINE_INVALIDATION_TRACKING"] = "timeline-invalidation-tracking";
     ExperimentName["TIMELINE_SHOW_ALL_EVENTS"] = "timeline-show-all-events";
-    ExperimentName["TIMELINE_V8_RUNTIME_CALL_STATS"] = "timeline-v8-runtime-call-stats";
     ExperimentName["APCA"] = "apca";
     ExperimentName["FONT_EDITOR"] = "font-editor";
     ExperimentName["FULL_ACCESSIBILITY_TREE"] = "full-accessibility-tree";