Merge branch 'main' into docker-mcp-gateway-2e860

Author: omalleyandy

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.16.0"
+  ".": "0.17.0"
 }

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.17.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.16.0...chrome-devtools-mcp-v0.17.0) (2026-02-10)
+
+
+### 🎉 Features
+
+* include Error.cause chain for uncaught errors and logged Errors ([#906](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/906)) ([05b01ec](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/05b01ecaba47cf1ce38564636663222c9cab46de))
+* Integrate CrUX data into performance trace summaries ([#733](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/733)) ([b747f9d](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/b747f9d74a12d2119b6531476b2f88ab66be0ff8))
+* show message and stack trace in details when console.log'ging Error objects ([#902](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/902)) ([ffa00da](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/ffa00dab1b65b2eac8db215e0289317b8ed9b725))
+
+
+### 🛠️ Fixes
+
+* console formatter hides frames from ignored scripts ([#927](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/927)) ([8e2380b](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/8e2380b434d9659ffa8a7043d2589261772fa04f))
+* limit stack traces to 50 lines ([#923](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/923)) ([caea23a](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/caea23a7cf33c87cd4ce426eb2a10724aba3cc71))
+
+
+### 📄 Documentation
+
+* add macOS Web Bluetooth troubleshooting note ([#930](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/930)) ([3c9528b](https://github.com/ChromeDevTools/chrome-devtools-mcp/commit/3c9528b43d9bbff166fcfcfee321149ff44ddd21)), closes [#917](https://github.com/ChromeDevTools/chrome-devtools-mcp/issues/917)
+
 ## [0.16.0](https://github.com/ChromeDevTools/chrome-devtools-mcp/compare/chrome-devtools-mcp-v0.15.1...chrome-devtools-mcp-v0.16.0) (2026-02-04)
 
 

docs/troubleshooting.md

@@ -55,6 +55,16 @@ This indicates that the browser could not be started. Make sure that no Chrome
 instances are running or close them. Make sure you have the latest stable Chrome
 installed and that [your system is able to run Chrome](https://support.google.com/chrome/a/answer/7100626?hl=en).
 
+### Chrome crashes on macOS when opening Web Bluetooth
+
+On macOS, Chrome launched by an MCP host app may crash with a macOS privacy
+permission violation (TCC, "Transparency, Consent, and Control") when a native
+Bluetooth chooser opens.
+
+Grant Bluetooth permission to the MCP host app in
+`System Settings > Privacy & Security > Bluetooth`, then restart the MCP host
+app and Chrome MCP session.
+
 ### Remote debugging between virtual machine (VM) and host fails
 
 When connecting DevTools inside a VM to Chrome running on the host, any domain is rejected by Chrome because of host header validation. Tunneling the port over SSH bypasses this restriction. In the VM, run:

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
@@ -55,7 +55,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1579812",
+    "chrome-devtools-frontend": "1.0.1581449",
     "core-js": "3.48.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",

package.json

@@ -142,7 +142,9 @@ async function runSingleScenario(
         name: request.name,
         args: (request.arguments as Record<string, unknown>) || {},
       });
-      return originalCallTool(request, schema);
+      const response = await originalCallTool(request, schema);
+      debugLog(`Tool response: ${JSON.stringify(response)}`);
+      return response;
     };
 
     const ai = new GoogleGenAI({apiKey});

scripts/eval_gemini.ts

@@ -0,0 +1,40 @@
+/**
+ * @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:
+    'Open new page <TEST_URL> and then open new page https://developers.chrome.com. Select the <TEST_URL> page.',
+  maxTurns: 3,
+  htmlRoute: {
+    path: '/test.html',
+    htmlContent: `
+      <h1>test</h1>
+    `,
+  },
+  expectations: calls => {
+    assert.strictEqual(calls.length, 3);
+    assert.ok(calls[0].name === 'new_page', 'First call should be navigation');
+    assert.ok(calls[1].name === 'new_page', 'Second call should be navigation');
+    assert.ok(
+      calls[2].name === 'select_page',
+      'Third call should be select_page',
+    );
+    assert.strictEqual(
+      calls[2].args.pageId,
+      2,
+      'PageId has to be set to 2. about:blank is 1, <TEST_URL> is 2, https://developers.chrome.com is 3.',
+    );
+    assert.strictEqual(
+      calls[2].args.bringToFront,
+      undefined,
+      'bringToFront should use the default value.',
+    );
+  },
+};

scripts/eval_scenarios/select_page_test.ts

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

server.json

@@ -10,7 +10,7 @@ import {
   SymbolizedError,
 } from '../DevtoolsUtils.js';
 import {UncaughtError} from '../PageCollector.js';
-import type * as DevTools from '../third_party/index.js';
+import * as DevTools from '../third_party/index.js';
 import type {ConsoleMessage} from '../third_party/index.js';
 
 export interface ConsoleFormatterOptions {
@@ -20,9 +20,16 @@ export interface ConsoleFormatterOptions {
   resolvedArgsForTesting?: unknown[];
   resolvedStackTraceForTesting?: DevTools.DevTools.StackTrace.StackTrace.StackTrace;
   resolvedCauseForTesting?: SymbolizedError;
+  isIgnoredForTesting?: IgnoreCheck;
 }
 
+export type IgnoreCheck = (
+  frame: DevTools.DevTools.StackTrace.StackTrace.Frame,
+) => boolean;
+
 export class ConsoleFormatter {
+  static readonly #STACK_TRACE_MAX_LINES = 50;
+
   readonly #id: number;
   readonly #type: string;
   readonly #text: string;
@@ -33,6 +40,8 @@ export class ConsoleFormatter {
   readonly #stack?: DevTools.DevTools.StackTrace.StackTrace.StackTrace;
   readonly #cause?: SymbolizedError;
 
+  readonly #isIgnored: IgnoreCheck;
+
   private constructor(params: {
     id: number;
     type: string;
@@ -41,6 +50,7 @@ export class ConsoleFormatter {
     resolvedArgs?: unknown[];
     stack?: DevTools.DevTools.StackTrace.StackTrace.StackTrace;
     cause?: SymbolizedError;
+    isIgnored: IgnoreCheck;
   }) {
     this.#id = params.id;
     this.#type = params.type;
@@ -49,12 +59,37 @@ export class ConsoleFormatter {
     this.#resolvedArgs = params.resolvedArgs ?? [];
     this.#stack = params.stack;
     this.#cause = params.cause;
+    this.#isIgnored = params.isIgnored;
   }
 
   static async from(
     msg: ConsoleMessage | UncaughtError,
     options: ConsoleFormatterOptions,
   ): Promise<ConsoleFormatter> {
+    const ignoreListManager = options?.devTools?.universe.context.get(
+      DevTools.DevTools.IgnoreListManager,
+    );
+    const isIgnored: IgnoreCheck =
+      options.isIgnoredForTesting ||
+      (frame => {
+        if (!ignoreListManager) {
+          return false;
+        }
+        if (frame.uiSourceCode) {
+          return ignoreListManager.isUserOrSourceMapIgnoreListedUISourceCode(
+            frame.uiSourceCode,
+          );
+        }
+        if (frame.url) {
+          return ignoreListManager.isUserIgnoreListedURL(
+            frame.url as Parameters<
+              DevTools.DevTools.IgnoreListManager['isUserIgnoreListedURL']
+            >[0],
+          );
+        }
+        return false;
+      });
+
     if (msg instanceof UncaughtError) {
       const error = await SymbolizedError.fromDetails({
         devTools: options?.devTools,
@@ -70,6 +105,7 @@ export class ConsoleFormatter {
         text: error.message,
         stack: error.stackTrace,
         cause: error.cause,
+        isIgnored,
       });
     }
 
@@ -118,6 +154,7 @@ export class ConsoleFormatter {
       argCount: resolvedArgs.length || msg.args().length,
       resolvedArgs,
       stack,
+      isIgnored,
     });
   }
 
@@ -134,7 +171,6 @@ export class ConsoleFormatter {
       this.#formatArgs(),
       this.#formatStackTrace(this.#stack, this.#cause, {
         includeHeading: true,
-        includeNote: true,
       }),
     ].filter(line => !!line);
     return result.join('\n');
@@ -158,7 +194,6 @@ export class ConsoleFormatter {
         arg.message,
         this.#formatStackTrace(arg.stackTrace, arg.cause, {
           includeHeading: false,
-          includeNote: true,
         }),
       ]
         .filter(line => !!line)
@@ -186,38 +221,65 @@ export class ConsoleFormatter {
   #formatStackTrace(
     stackTrace: DevTools.DevTools.StackTrace.StackTrace.StackTrace | undefined,
     cause: SymbolizedError | undefined,
-    opts: {includeHeading: boolean; includeNote: boolean},
+    opts: {includeHeading: boolean},
   ): string {
     if (!stackTrace) {
       return '';
     }
 
+    const lines = this.#formatStackTraceInner(stackTrace, cause);
+    const includedLines = lines.slice(
+      0,
+      ConsoleFormatter.#STACK_TRACE_MAX_LINES,
+    );
+    const reminderCount = lines.length - includedLines.length;
+
     return [
       opts.includeHeading ? '### Stack trace' : '',
-      this.#formatFragment(stackTrace.syncFragment),
-      ...stackTrace.asyncFragments.map(this.#formatAsyncFragment.bind(this)),
-      this.#formatCause(cause),
-      opts.includeNote
-        ? 'Note: line and column numbers use 1-based indexing'
-        : '',
+      ...includedLines,
+      reminderCount > 0 ? `... and ${reminderCount} more frames` : '',
+      'Note: line and column numbers use 1-based indexing',
     ]
       .filter(line => !!line)
       .join('\n');
   }
 
+  #formatStackTraceInner(
+    stackTrace: DevTools.DevTools.StackTrace.StackTrace.StackTrace | undefined,
+    cause: SymbolizedError | undefined,
+  ): string[] {
+    if (!stackTrace) {
+      return [];
+    }
+
+    return [
+      ...this.#formatFragment(stackTrace.syncFragment),
+      ...stackTrace.asyncFragments
+        .map(this.#formatAsyncFragment.bind(this))
+        .flat(),
+      ...this.#formatCause(cause),
+    ];
+  }
+
   #formatFragment(
     fragment: DevTools.DevTools.StackTrace.StackTrace.Fragment,
-  ): string {
-    return fragment.frames.map(this.#formatFrame.bind(this)).join('\n');
+  ): string[] {
+    const frames = fragment.frames.filter(frame => !this.#isIgnored(frame));
+    return frames.map(this.#formatFrame.bind(this));
   }
 
   #formatAsyncFragment(
     fragment: DevTools.DevTools.StackTrace.StackTrace.AsyncFragment,
-  ): string {
+  ): string[] {
+    const formattedFrames = this.#formatFragment(fragment);
+    if (formattedFrames.length === 0) {
+      return [];
+    }
+
     const separatorLineLength = 40;
     const prefix = `--- ${fragment.description || 'async'} `;
     const separator = prefix + '-'.repeat(separatorLineLength - prefix.length);
-    return separator + '\n' + this.#formatFragment(fragment);
+    return [separator, ...formattedFrames];
   }
 
   #formatFrame(frame: DevTools.DevTools.StackTrace.StackTrace.Frame): string {
@@ -231,20 +293,15 @@ export class ConsoleFormatter {
     return result;
   }
 
-  #formatCause(cause: SymbolizedError | undefined): string {
+  #formatCause(cause: SymbolizedError | undefined): string[] {
     if (!cause) {
-      return '';
+      return [];
     }
 
     return [
       `Caused by: ${cause.message}`,
-      this.#formatStackTrace(cause.stackTrace, cause.cause, {
-        includeHeading: false,
-        includeNote: false,
-      }),
-    ]
-      .filter(line => !!line)
-      .join('\n');
+      ...this.#formatStackTraceInner(cause.stackTrace, cause.cause),
+    ];
   }
 
   toJSON(): object {

src/formatters/ConsoleFormatter.ts

@@ -31,7 +31,7 @@ import {tools} from './tools/tools.js';
 
 // If moved update release-please config
 // x-release-please-start-version
-const VERSION = '0.16.0';
+const VERSION = '0.17.0';
 // x-release-please-end
 
 export const args = parseArguments(VERSION);