Merge remote-tracking branch 'origin/main' into feat/semantic-filtering

Author: natorion

.github/ISSUE_TEMPLATE/02-feature.yml

@@ -3,7 +3,7 @@ description: Suggest an idea for for chrome-devtools-mcp
 title: '<short description of the feature request>'
 type: 'Feature'
 labels:
-  - enhancement
+  - feature
 body:
   - id: description
     type: textarea

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.20.1"
+  ".": "0.20.2"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.20.2](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.20.1...chrome-devtools-mcp-v0.20.2) (2026-03-18)
+
+
+### 📄 Documentation
+
+* add troubleshooting for Claude Code plugin HTTPS clone failures ([#1195](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/1195)) ([d082ca4](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/d082ca4ecd35a023d09f9c1ff949d5fb0c3fb069))
+
 ## [0.20.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.20.0...chrome-devtools-mcp-v0.20.1) (2026-03-16)
 
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.20.1",
+  "version": "0.20.2",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -59,7 +59,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1596260",
+    "chrome-devtools-frontend": "1.0.1599001",
     "core-js": "3.48.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",

package.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "source": "github"
   },
-  "version": "0.20.1",
+  "version": "0.20.2",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "chrome-devtools-mcp",
-      "version": "0.20.1",
+      "version": "0.20.2",
       "transport": {
         "type": "stdio"
       },

server.json

@@ -15,6 +15,61 @@ import type {
   Target as PuppeteerTarget,
 } from './third_party/index.js';
 
+export function extractUrlLikeFromDevToolsTitle(
+  title: string,
+): string | undefined {
+  const match = title.match(new RegExp(`DevTools - (.*)`));
+  return match?.[1] ?? undefined;
+}
+
+export function urlsEqual(url1: string, url2: string): boolean {
+  const normalizedUrl1 = normalizeUrl(url1);
+  const normalizedUrl2 = normalizeUrl(url2);
+  return normalizedUrl1 === normalizedUrl2;
+}
+
+/**
+ * For the sake of the MCP server, when we determine if two URLs are equal we
+ * remove some parts:
+ *
+ * 1. We do not care about the protocol.
+ * 2. We do not care about trailing slashes.
+ * 3. We do not care about "www".
+ * 4. We ignore the hash parts.
+ *
+ * For example, if the user types "record a trace on foo.com", we would want to
+ * match a tab in the connected Chrome instance that is showing "www.foo.com/"
+ */
+function normalizeUrl(url: string): string {
+  let result = url.trim();
+
+  // Remove protocols
+  if (result.startsWith('https://')) {
+    result = result.slice(8);
+  } else if (result.startsWith('http://')) {
+    result = result.slice(7);
+  }
+
+  // Remove 'www.'. This ensures that we find the right URL regardless of if the user adds `www` or not.
+  if (result.startsWith('www.')) {
+    result = result.slice(4);
+  }
+
+  // We use target URLs to locate DevTools but those often do
+  // no include hash.
+  const hashIdx = result.lastIndexOf('#');
+  if (hashIdx !== -1) {
+    result = result.slice(0, hashIdx);
+  }
+
+  // Remove trailing slash
+  if (result.endsWith('/')) {
+    result = result.slice(0, -1);
+  }
+
+  return result;
+}
+
 /**
  * A mock implementation of an issues manager that only implements the methods
  * that are actually used by the IssuesAggregator

src/DevtoolsUtils.ts

@@ -8,7 +8,11 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import type {TargetUniverse} from './DevtoolsUtils.js';
-import {UniverseManager} from './DevtoolsUtils.js';
+import {
+  extractUrlLikeFromDevToolsTitle,
+  UniverseManager,
+  urlsEqual,
+} from './DevtoolsUtils.js';
 import {McpPage} from './McpPage.js';
 import type {ListenerMap, UncaughtError} from './PageCollector.js';
 import {NetworkCollector, ConsoleCollector} from './PageCollector.js';
@@ -649,21 +653,37 @@ export class McpContext implements Context {
   async detectOpenDevToolsWindows() {
     this.logger('Detecting open DevTools windows');
     const {pages} = await this.#getAllPages();
-
-    await Promise.all(
-      pages.map(async page => {
-        const mcpPage = this.#mcpPages.get(page);
-        if (!mcpPage) {
-          return;
-        }
-
-        if (await page.hasDevTools()) {
-          mcpPage.devToolsPage = await page.openDevTools();
-        } else {
-          mcpPage.devToolsPage = undefined;
+    // Clear all devToolsPage references before re-detecting.
+    for (const mcpPage of this.#mcpPages.values()) {
+      mcpPage.devToolsPage = undefined;
+    }
+    for (const devToolsPage of pages) {
+      if (devToolsPage.url().startsWith('devtools://')) {
+        try {
+          this.logger('Calling getTargetInfo for ' + devToolsPage.url());
+          const data = await devToolsPage
+            // @ts-expect-error no types for _client().
+            ._client()
+            .send('Target.getTargetInfo');
+          const devtoolsPageTitle = data.targetInfo.title;
+          const urlLike = extractUrlLikeFromDevToolsTitle(devtoolsPageTitle);
+          if (!urlLike) {
+            continue;
+          }
+          // TODO: lookup without a loop.
+          for (const page of this.#pages) {
+            if (urlsEqual(page.url(), urlLike)) {
+              const mcpPage = this.#mcpPages.get(page);
+              if (mcpPage) {
+                mcpPage.devToolsPage = devToolsPage;
+              }
+            }
+          }
+        } catch (error) {
+          this.logger('Issue occurred while trying to find DevTools', error);
         }
-      }),
-    );
+      }
+    }
   }
 
   getExtensionServiceWorkers(): ExtensionServiceWorker[] {

src/McpContext.ts

@@ -12,7 +12,7 @@ export const cliOptions = {
     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: boolean | undefined) => {
       if (!value) {
@@ -26,7 +26,7 @@ export const cliOptions = {
     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: string | undefined) => {
       if (!url) {
         return;
@@ -44,7 +44,7 @@ export const cliOptions = {
     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: string | undefined) => {
       if (!url) {
         return;
@@ -211,9 +211,10 @@ 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',

src/bin/chrome-devtools-mcp-cli-options.ts

@@ -129,7 +129,7 @@ export async function createMcpServer(
     }
     if (
       tool.annotations.category === ToolCategory.EXTENSIONS &&
-      serverArgs.categoryExtensions === false
+      !serverArgs.categoryExtensions
     ) {
       return;
     }