merge

Author: OrKoN

.github/workflows/pre-release.yml

@@ -23,6 +23,22 @@ jobs:
         with:
           cache: npm
           node-version-file: '.nvmrc'
+          registry-url: 'https://registry.npmjs.org'
+
+      # Ensure npm 11.5.1 or later is installed
+      - name: Update npm
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build and bundle
+        run: npm run bundle
+        env:
+          NODE_ENV: 'production'
 
       - name: Verify server.json
         run: npm run verify-server-json-version
+
+      - name: Verify npm package
+        run: npm run verify-npm-package

README.md

@@ -497,6 +497,10 @@ The Chrome DevTools MCP server supports the following configuration option:
   If enabled, ignores errors relative to self-signed and expired certificates. Use with caution.
   - **Type:** boolean
 
+- **`--experimentalScreencast`/ `--experimental-screencast`**
+  Exposes experimental screencast tools (requires ffmpeg). Install ffmpeg https://www.ffmpeg.org/download.html and ensure it is available in the MCP server PATH.
+  - **Type:** boolean
+
 - **`--chromeArg`/ `--chrome-arg`**
   Additional arguments for Chrome. Only applies when Chrome is launched by chrome-devtools-mcp.
   - **Type:** array

docs/tool-reference.md

@@ -1,6 +1,6 @@
 <!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->
 
-# Chrome DevTools MCP Tool Reference (~6922 cl100k_base tokens)
+# Chrome DevTools MCP Tool Reference (~6980 cl100k_base tokens)
 
 - **[Audits](#audits)** (1 tools)
   - [`lighthouse_audit`](#lighthouse_audit)
@@ -188,6 +188,7 @@
 
 - **url** (string) **(required)**: URL to load in a new page.
 - **background** (boolean) _(optional)_: Whether to open the page in the background without bringing it to the front. Default is false (foreground).
+- **isolatedContext** (string) _(optional)_: If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isolated.
 - **timeout** (integer) _(optional)_: Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
 
 ---

package-lock.json

@@ -7,7 +7,7 @@
   "main": "index.js",
   "scripts": {
     "clean": "node -e \"require('fs').rmSync('build', {recursive: true, force: true})\"",
-    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\"",
+    "bundle": "npm run clean && npm run build && rollup -c rollup.config.mjs && node -e \"require('fs').rmSync('build/node_modules', {recursive: true, force: true})\" && node --experimental-strip-types scripts/append-lighthouse-notices.ts",
     "build": "tsc && node --experimental-strip-types --no-warnings=ExperimentalWarning scripts/post-build.ts",
     "typecheck": "tsc --noEmit",
     "format": "eslint --cache --fix . && prettier --write --cache .",
@@ -23,12 +23,12 @@
     "prepare": "node --experimental-strip-types scripts/prepare.ts",
     "verify-server-json-version": "node --experimental-strip-types scripts/verify-server-json-version.ts",
     "update-lighthouse": "node --experimental-strip-types scripts/update-lighthouse.ts",
+    "verify-npm-package": "node scripts/verify-npm-package.mjs",
     "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": [
     "build/src",
-    "build/node_modules",
     "LICENSE",
     "!*.tsbuildinfo"
   ],
@@ -64,8 +64,8 @@
     "globals": "^17.0.0",
     "lighthouse": "13.0.2",
     "prettier": "^3.6.2",
-    "puppeteer": "24.37.4",
-    "rollup": "4.57.1",
+    "puppeteer": "24.37.5",
+    "rollup": "4.58.0",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "sinon": "^21.0.0",

package.json

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+const ROOT_DIR = process.cwd();
+const TARGET_DIR = path.join(ROOT_DIR, 'build/src/third_party');
+const SOURCE_DIR = path.join(ROOT_DIR, 'src/third_party');
+
+function main() {
+  const lighthouseNotices = fs.readFileSync(
+    path.join(SOURCE_DIR, 'LIGHTHOUSE_MCP_BUNDLE_THIRD_PARTY_NOTICES'),
+    'utf8',
+  );
+  const bundledNotices = fs.readFileSync(
+    path.join(TARGET_DIR, 'THIRD_PARTY_NOTICES'),
+    'utf8',
+  );
+  fs.writeFileSync(
+    path.join(TARGET_DIR, 'THIRD_PARTY_NOTICES'),
+    bundledNotices +
+      '\n\n-------------------- DEPENDENCY DIVIDER --------------------\n\n' +
+      lighthouseNotices,
+  );
+  console.log('Done.');
+}
+
+main();

scripts/append-lighthouse-notices.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import assert from 'node:assert';
+
+import type {TestScenario} from '../eval_gemini.ts';
+
+export const scenario: TestScenario = {
+  prompt:
+    'Create a new page <TEST_URL> in an isolated context called contextB. Take a screenshot there.',
+  maxTurns: 3,
+  htmlRoute: {
+    path: '/test.html',
+    htmlContent: `
+      <h1>test</h1>
+    `,
+  },
+  expectations: calls => {
+    console.log(JSON.stringify(calls, null, 2));
+    assert.strictEqual(calls.length, 2);
+    assert.ok(calls[0].name === 'new_page', 'First call should be navigation');
+    assert.deepStrictEqual(calls[0].args.isolatedContext, 'contextB');
+    assert.ok(
+      calls[1].name === 'take_screenshot',
+      'Second call should be a screenshot',
+    );
+  },
+};

scripts/eval_scenarios/isolated_context_test.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import assert from 'node:assert';
+
+import type {TestScenario} from '../eval_gemini.ts';
+
+export const scenario: TestScenario = {
+  prompt: 'Check a11y issues on the current page',
+  maxTurns: 1,
+  expectations: calls => {
+    assert.strictEqual(calls.length, 1);
+    assert.ok(
+      calls[0].name === 'lighthouse_audit',
+      'First call should be lighthouse_audit',
+    );
+  },
+};

scripts/eval_scenarios/lighthouse_a11y_test.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import assert from 'node:assert';
+
+import type {TestScenario} from '../eval_gemini.ts';
+
+export const scenario: TestScenario = {
+  prompt: 'Check for best practices on the current page',
+  maxTurns: 1,
+  expectations: calls => {
+    assert.strictEqual(calls.length, 1);
+    assert.ok(
+      calls[0].name === 'lighthouse_audit',
+      'First call should be lighthouse_audit',
+    );
+  },
+};

scripts/eval_scenarios/lighthouse_best_practices_test.ts

@@ -68,6 +68,7 @@ async function runTests(attempt) {
       env: {
         ...process.env,
         CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: true,
+        CHROME_DEVTOOLS_MCP_CRASH_ON_UNCAUGHT: true,
       },
     });