Merge branch 'main' into crux-for-trace

Author: OrKoN

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.14.0"
+  ".": "0.15.1"
 }

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.15.1](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.15.0...chrome-devtools-mcp-v0.15.1) (2026-01-30)
+
+
+### 🛠️ Fixes
+
+* disable usage statistics when CI or CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS env is set ([#862](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/862)) ([c0435a2](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/c0435a2d53eb51b7500fc5cce50344520ea164e7))
+* respect custom timeouts in navigate tools ([#865](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/865)) ([a0aeb97](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/a0aeb97693fd5ca641f45ebcd4ce3b4b08ce21b8))
+
+## [0.15.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.14.0...chrome-devtools-mcp-v0.15.0) (2026-01-28)
+
+
+### 🎉 Features
+
+* Add ability to inject script to run on page load ([#568](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/568)) ([d845ad4](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/d845ad48584a49aa57b11de308beeb17ed0b2e10))
+* enable usage statistics by default with opt-out ([#855](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/855)) ([7e279f1](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/7e279f1b67c5cfd4ad033a4147c51fe20a7833f7))
+* support testing light and dark mode ([#858](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/858)) ([5a23a8c](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/5a23a8c201d30d40395e283f4434d933826333fa))
+
 ## [0.14.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.13.0...chrome-devtools-mcp-v0.14.0) (2026-01-27)
 
 

README.md

@@ -47,6 +47,8 @@ Google handles this data in accordance with the [Google Privacy Policy](https://
 
 Google's collection of usage statistics for Chrome DevTools MCP is independent from the Chrome browser's usage statistics. Opting out of Chrome metrics does not automatically opt you out of this tool, and vice-versa.
 
+Collection is disabled if CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS or CI env variables are set.
+
 ## Requirements
 
 - [Node.js](https://nodejs.org/) v20.19 or a newer [latest maintenance LTS](https://github.com/nodejs/Release#release-schedule) version.
@@ -476,7 +478,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Default:** `true`
 
 - **`--usageStatistics`/ `--usage-statistics`**
-  Set to false to opt-out of usage statistics collection. Google collects usage data to improve the tool, handled under the Google Privacy Policy (https://policies.google.com/privacy). This is independent from Chrome browser metrics.
+  Set to false to opt-out of usage statistics collection. Google collects usage data to improve the tool, handled under the Google Privacy Policy (https://policies.google.com/privacy). This is independent from Chrome browser metrics. Disabled if CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS or CI env variables are set.
   - **Type:** boolean
   - **Default:** `true`
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
@@ -22,7 +22,7 @@
     "test:update-snapshots": "npm run build && node scripts/test.mjs --test-update-snapshots",
     "prepare": "node --experimental-strip-types scripts/prepare.ts",
     "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts",
-    "eval": "npm run build && node --experimental-strip-types scripts/eval_gemini.ts",
+    "eval": "npm run build && CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS=true node --experimental-strip-types scripts/eval_gemini.ts",
     "count-tokens": "node --experimental-strip-types scripts/count_tokens.ts"
   },
   "files": [

package.json

@@ -16,7 +16,7 @@
  */
 
 /**
- * @fileoverview take from {@link https://github.com/GoogleChromeLabs/chromium-bidi/blob/main/rollup.config.mjs | chromium-bidi}
+ * @fileoverview taken from {@link https://github.com/GoogleChromeLabs/chromium-bidi/blob/main/rollup.config.mjs | chromium-bidi}
  * and modified to specific requirement.
  */
 
@@ -41,23 +41,99 @@ const allowedLicenses = [
   '0BSD',
 ];
 
+const thirdPartyDir = './build/src/third_party';
+
+const {devDependencies = {}} = JSON.parse(
+  fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'),
+);
+
+// special case for puppeteer, from which we only bundle puppeteer-core
+devDependencies['puppeteer-core'] = devDependencies['puppeteer'];
+
+const aggregatedStats = {
+  bundlesProcessed: 0,
+  totalBundles: 0,
+  bundledPackages: new Set(),
+};
+
+const projectNodeModulesPath =
+  path.join(process.cwd(), 'node_modules') + path.sep;
+
+function getPackageName(modulePath) {
+  // Handle rollup's virtual module paths (paths starting with 0x00)
+  const absolutePathStart = modulePath.indexOf(projectNodeModulesPath);
+  if (absolutePathStart < 0) {
+    return null;
+  }
+
+  const relativePath = modulePath.slice(
+    projectNodeModulesPath.length + absolutePathStart,
+  );
+  const segments = relativePath.split(path.sep);
+
+  // handle scoped packages
+  if (segments[0].startsWith('@') && segments[1]) {
+    return `${segments[0]}/${segments[1]}`;
+  }
+  return segments[0];
+}
+
+/**
+ * @returns {import('rollup').Plugin}
+ */
+function listBundledDeps() {
+  aggregatedStats.totalBundles++;
+  return {
+    name: 'gather-bundled-dependencies',
+    generateBundle(options, bundle) {
+      for (const chunk of Object.values(bundle)) {
+        if (chunk.type === 'chunk' && chunk.modules) {
+          // chunk.modules is an object where keys are the absolute file paths
+          Object.keys(chunk.modules).forEach(modulePath => {
+            const packageName = getPackageName(modulePath);
+            if (packageName) {
+              aggregatedStats.bundledPackages.add(packageName);
+            }
+          });
+        }
+      }
+      aggregatedStats.bundlesProcessed++;
+
+      // Only write the file when the last bundle is finished
+      if (aggregatedStats.bundlesProcessed === aggregatedStats.totalBundles) {
+        const outputPath = path.join(thirdPartyDir, 'bundled-packages.json');
+
+        const bundledDevDeps = Object.fromEntries(
+          Object.entries(devDependencies).filter(
+            ([name]) =>
+              aggregatedStats.bundledPackages.has(name) ||
+              name === 'chrome-devtools-frontend',
+          ),
+        );
+
+        fs.writeFileSync(outputPath, JSON.stringify(bundledDevDeps, null, 2));
+      }
+    },
+  };
+}
+
 const seenDependencies = new Map();
 
 /**
- * @param {string} wrapperIndexPath
+ * @param {string} wrapperIndexName
  * @param {import('rollup').OutputOptions} [extraOutputOptions={}]
  * @param {import('rollup').ExternalOption} [external=[]]
  * @returns {import('rollup').RollupOptions}
  */
 const bundleDependency = (
-  wrapperIndexPath,
+  wrapperIndexName,
   extraOutputOptions = {},
   external = [],
 ) => ({
-  input: wrapperIndexPath,
+  input: path.join(thirdPartyDir, wrapperIndexName),
   output: {
     ...extraOutputOptions,
-    file: wrapperIndexPath,
+    file: path.join(thirdPartyDir, wrapperIndexName),
     sourcemap: !isProduction,
     format: 'esm',
   },
@@ -78,10 +154,7 @@ const bundleDependency = (
           failOnViolation: true,
         },
         output: {
-          file: path.join(
-            path.dirname(wrapperIndexPath),
-            'THIRD_PARTY_NOTICES',
-          ),
+          file: path.join(thirdPartyDir, 'THIRD_PARTY_NOTICES'),
           template(dependencies) {
             for (const dependency of dependencies) {
               const key = `${dependency.name}:${dependency.version}`;
@@ -164,6 +237,7 @@ const bundleDependency = (
         },
       },
     }),
+    listBundledDeps(),
     commonjs(),
     json(),
     nodeResolve(),
@@ -173,7 +247,7 @@ const bundleDependency = (
 
 export default [
   bundleDependency(
-    './build/src/third_party/index.js',
+    'index.js',
     {
       inlineDynamicImports: true,
     },
@@ -195,7 +269,7 @@ export default [
     },
   ),
   bundleDependency(
-    './build/src/third_party/devtools-formatter-worker.js',
+    'devtools-formatter-worker.js',
     {
       inlineDynamicImports: true,
     },

rollup.config.mjs

@@ -65,6 +65,10 @@ async function runTests(attempt) {
   return new Promise(resolve => {
     const child = spawn('node', nodeArgs, {
       stdio: 'inherit',
+      env: {
+        ...process.env,
+        CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: true,
+      },
     });
 
     child.on('close', code => {

scripts/test.mjs

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

server.json

@@ -733,7 +733,10 @@ export class McpContext implements Context {
     return new WaitForHelper(page, cpuMultiplier, networkMultiplier);
   }
 
-  waitForEventsAfterAction(action: () => Promise<unknown>): Promise<void> {
+  waitForEventsAfterAction(
+    action: () => Promise<unknown>,
+    options?: {timeout?: number},
+  ): Promise<void> {
     const page = this.getSelectedPage();
     const cpuMultiplier = this.getCpuThrottlingRate();
     const networkMultiplier = getNetworkMultiplierFromString(
@@ -744,7 +747,7 @@ export class McpContext implements Context {
       cpuMultiplier,
       networkMultiplier,
     );
-    return waitForHelper.waitForEventsAfterAction(action);
+    return waitForHelper.waitForEventsAfterAction(action, options);
   }
 
   getNetworkRequestStableId(request: HTTPRequest): number {

src/McpContext.ts

@@ -125,12 +125,13 @@ export class WaitForHelper {
 
   async waitForEventsAfterAction(
     action: () => Promise<unknown>,
+    options?: {timeout?: number},
   ): Promise<void> {
     const navigationFinished = this.waitForNavigationStarted()
       .then(navigationStated => {
         if (navigationStated) {
           return this.#page.waitForNavigation({
-            timeout: this.#navigationTimeout,
+            timeout: options?.timeout ?? this.#navigationTimeout,
             signal: this.#abortController.signal,
           });
         }