Merge upstream/main into feat/switch-browser-tool

elijahr · elijahr · commit d4aaba44b75a · 2025-11-19T18:23:11.000-06:00
Resolved conflicts between two independent refactorings:
- Our branch: extracted VERSION/args to config.js, added switch_browser tool
- Upstream: added features.js for feature flags, bumped VERSION to 0.10.2

Changes:
- Updated VERSION to 0.10.2 in config.ts
- Added features.js import and conditional issue loading
- Retained all switch_browser tool functionality
- No duplicate code, clean integration

All 203 tests pass.
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.10.1"
+  ".": "0.10.2"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.10.2](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.10.1...chrome-devtools-mcp-v0.10.2) (2025-11-19)
+
+
+### 📄 Documentation
+
+* add Factory CLI configuration to MCP clients ([#523](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/523)) ([016e2fd](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/016e2fd6ee57447103f7385285dd503b5576a860))
+
+
+### ♻️ Chores
+
+* clear issue aggregator on page navigation ([#565](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/565)) ([c3784d1](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/c3784d1990a926f651951e4eef05520c5c448964))
+* disable issues in list_console_messages for now ([#575](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/575)) ([08e9a9f](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/08e9a9f42e6ff1a92c60b3e958b0817c7b785afc))
+* simplify issue management ([#564](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/564)) ([3b016f1](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/3b016f1a814b1a69750813548b3f35e79bfb6fef))
+
 ## [0.10.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.10.0...chrome-devtools-mcp-v0.10.1) (2025-11-07)
 
 
diff --git a/README.md b/README.md
@@ -63,6 +63,28 @@ amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
 
 </details>
 
+<details>
+  <summary>Antigravity</summary>
+
+To use the Chrome DevTools MCP server, disable the built-in browser in the settings and add the following config to ` ~/.gemini/antigravity/mcp_config.json`:
+
+```bash
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "chrome-devtools-mcp@latest",
+        "-y"
+      ]
+    }
+  }
+}
+```
+
+</details>
+
 <details>
   <summary>Claude Code</summary>
     Use the Claude Code CLI to add the Chrome DevTools MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp">guide</a>):
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
diff --git a/scripts/post-build.ts b/scripts/post-build.ts
@@ -53,69 +53,22 @@ function main(): void {
 
   // Create i18n mock
   const i18nDir = path.join(BUILD_DIR, devtoolsFrontEndCorePath, 'i18n');
-  fs.mkdirSync(i18nDir, {recursive: true});
-  const i18nFile = path.join(i18nDir, 'i18n.js');
-  const i18nContent = `
-export const i18n = {
-  registerUIStrings: () => {},
-  getLocalizedString: (_, str) => {
-    // So that the string passed in gets output verbatim.
-    return str;
-  },
-  lockedLazyString: () => {},
-  getLazilyComputedLocalizedString: () => ()=>{},
-};
-
-// TODO(jacktfranklin): once the DocumentLatency insight does not depend on
-// this method, we can remove this stub.
-export const TimeUtilities = {
-  millisToString(x) {
-    const separator = '\xA0';
-    const formatter = new Intl.NumberFormat('en-US', {
-      style: 'unit',
-      unitDisplay: 'narrow',
-      minimumFractionDigits: 0,
-      maximumFractionDigits: 1,
-      unit: 'millisecond',
-    });
-
-    const parts = formatter.formatToParts(x);
-    for (const part of parts) {
-      if (part.type === 'literal') {
-        if (part.value === ' ') {
-          part.value = separator;
-        }
-      }
-    }
+  const localesFile = path.join(i18nDir, 'locales.js');
+  const localesContent = `
+export const LOCALES = [
+  'en-US',
+];
 
-    return parts.map(part => part.value).join('');
-  }
-};
-
-// TODO(jacktfranklin): once the ImageDelivery insight does not depend on this method, we can remove this stub.
-export const ByteUtilities = {
-  bytesToString(x) {
-    const separator = '\xA0';
-    const formatter = new Intl.NumberFormat('en-US', {
-      style: 'unit',
-      unit: 'kilobyte',
-      unitDisplay: 'narrow',
-      minimumFractionDigits: 1,
-      maximumFractionDigits: 1,
-    });
-    const parts = formatter.formatToParts(x / 1000);
-    for (const part of parts) {
-      if (part.type === 'literal') {
-        if (part.value === ' ') {
-          part.value = separator;
-        }
-      }
-    }
+export const BUNDLED_LOCALES = [
+  'en-US',
+];
 
-    return parts.map(part => part.value).join('');
-  }
-};`;
-  writeFile(i18nFile, i18nContent);
+export const DEFAULT_LOCALE = 'en-US';
+
+export const REMOTE_FETCH_PATTERN = '@HOST@/remote/serve_file/@VERSION@/core/i18n/locales/@LOCALE@.json';
+
+export const LOCAL_FETCH_PATTERN = './locales/@LOCALE@.json';`;
+  writeFile(localesFile, localesContent);
 
   // Create codemirror.next mock.
   const codeMirrorDir = path.join(
diff --git a/server.json b/server.json
@@ -1,18 +1,19 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
   "name": "io.github.ChromeDevTools/chrome-devtools-mcp",
+  "title": "Chrome DevTools MCP",
   "description": "MCP server for Chrome DevTools",
   "repository": {
     "url": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
     "source": "github"
   },
-  "version": "0.10.1",
+  "version": "0.10.2",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "chrome-devtools-mcp",
-      "version": "0.10.1",
+      "version": "0.10.2",
       "transport": {
         "type": "stdio"
       },
diff --git a/src/DevtoolsUtils.ts b/src/DevtoolsUtils.ts
@@ -8,6 +8,7 @@ import {
   type Issue,
   type IssuesManagerEventTypes,
   Common,
+  I18n,
 } from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 
 export function extractUrlLikeFromDevToolsTitle(
@@ -67,3 +68,13 @@ export class FakeIssuesManager extends Common.ObjectWrapper
     return [];
   }
 }
+
+I18n.DevToolsLocale.DevToolsLocale.instance({
+  create: true,
+  data: {
+    navigatorLanguage: 'en-US',
+    settingLanguage: 'en-US',
+    lookupClosestDevToolsLocale: l => l,
+  },
+});
+I18n.i18n.registerLocaleDataForTest('en-US', {});
diff --git a/src/PageCollector.ts b/src/PageCollector.ts
@@ -16,6 +16,7 @@ import {
 } from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
 
 import {FakeIssuesManager} from './DevtoolsUtils.js';
+import {features} from './features.js';
 import {logger} from './logger.js';
 import type {
   CDPSession,
@@ -231,6 +232,9 @@ export class ConsoleCollector extends PageCollector<
 
   override addPage(page: Page): void {
     super.addPage(page);
+    if (!features.issues) {
+      return;
+    }
     if (!this.#subscribedPages.has(page)) {
       const subscriber = new PageIssueSubscriber(page);
       this.#subscribedPages.set(page, subscriber);
diff --git a/src/config.ts b/src/config.ts
@@ -8,7 +8,7 @@ import {parseArguments} from './cli.js';
 
 // If moved update release-please config
 // x-release-please-start-version
-const VERSION = '0.10.1';
+const VERSION = '0.10.2';
 // x-release-please-end
 
 export const args = parseArguments(VERSION);
diff --git a/src/features.ts b/src/features.ts
@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+let issuesEnabled = false;
+
+export const features = {
+  get issues() {
+    return issuesEnabled;
+  },
+};
+
+export function setIssuesEnabled(value: boolean) {
+  issuesEnabled = value;
+}
diff --git a/src/main.ts b/src/main.ts
@@ -13,6 +13,7 @@ import {
   getContext as getContextInstance,
   setContextInstance,
 } from './context.js';
+import {features} from './features.js';
 import {loadIssueDescriptions} from './issue-descriptions.js';
 import {logger, saveLogsToFile} from './logger.js';
 import {McpContext} from './McpContext.js';
@@ -207,7 +208,9 @@ for (const tool of tools) {
   registerTool(tool);
 }
 
-await loadIssueDescriptions();
+if (features.issues) {
+  await loadIssueDescriptions();
+}
 const transport = new StdioServerTransport();
 await server.connect(transport);
 logger('Chrome DevTools MCP Server connected');
diff --git a/src/tools/console.ts b/src/tools/console.ts
@@ -4,14 +4,15 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import {features} from '../features.js';
 import {zod} from '../third_party/index.js';
 import type {ConsoleMessageType} from '../third_party/index.js';
 
 import {ToolCategory} from './categories.js';
 import {defineTool} from './ToolDefinition.js';
 type ConsoleResponseType = ConsoleMessageType | 'issue';
 
-const FILTERABLE_MESSAGE_TYPES: readonly [
+const FILTERABLE_MESSAGE_TYPES: [
   ConsoleResponseType,
   ...ConsoleResponseType[],
 ] = [
@@ -37,6 +38,10 @@ const FILTERABLE_MESSAGE_TYPES: readonly [
   'issue',
 ];
 
+if (features.issues) {
+  FILTERABLE_MESSAGE_TYPES.push('issue');
+}
+
 export const listConsoleMessages = defineTool({
   name: 'list_console_messages',
   description:
diff --git a/tests/PageCollector.test.ts b/tests/PageCollector.test.ts
@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import assert from 'node:assert';
-import {beforeEach, describe, it} from 'node:test';
+import {afterEach, beforeEach, describe, it} from 'node:test';
 
 import type {
   Browser,
@@ -17,6 +17,7 @@ import type {
 import sinon from 'sinon';
 
 import {AggregatedIssue} from '../node_modules/chrome-devtools-frontend/mcp/mcp.js';
+import {setIssuesEnabled} from '../src/features.js';
 import type {ListenerMap} from '../src/PageCollector.js';
 import {
   ConsoleCollector,
@@ -357,6 +358,11 @@ describe('ConsoleCollector', () => {
         },
       },
     };
+    setIssuesEnabled(true);
+  });
+
+  afterEach(() => {
+    setIssuesEnabled(false);
   });
 
   it('emits issues on page', async () => {
diff --git a/tests/tools/console.test.ts b/tests/tools/console.test.ts
diff --git a/tests/trace-processing/parse.test.ts b/tests/trace-processing/parse.test.ts
diff --git a/tsconfig.json b/tsconfig.json

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.10.1"`
	`2`	`+ ".": "0.10.2"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "chrome-devtools-mcp",`
`3`		`- "version": "0.10.1",`
	`3`	`+ "version": "0.10.2",`
`4`	`4`	`"description": "MCP server for Chrome DevTools",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"bin": "./build/src/index.js",`