chrome-devtools-mcp 0.10.2 → 0.12.0

package/build/src/formatters/snapshotFormatter.js

@@ -1,5 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
 export function formatSnapshotNode(root, snapshot, depth = 0) {
-    let result = '';
+    const chunks = [];
+    if (depth === 0) {
+        // Top-level content of the snapshot.
+        if (snapshot?.verbose &&
+            snapshot?.hasSelectedElement &&
+            !snapshot.selectedElementUid) {
+            chunks.push(`Note: there is a selected element in the DevTools Elements panel but it is not included into the current a11y tree snapshot.
+Get a verbose snapshot to include all elements if you are interested in the selected element.\n\n`);
+        }
+    }
     const attributes = getAttributes(root);
     const line = ' '.repeat(depth * 2) +
         attributes.join(' ') +
@@ -7,11 +21,11 @@ export function formatSnapshotNode(root, snapshot, depth = 0) {
             ? ' [selected in the DevTools Elements panel]'
             : '') +
         '\n';
-    result += line;
+    chunks.push(line);
     for (const child of root.children) {
-        result += formatSnapshotNode(child, snapshot, depth + 1);
+        chunks.push(formatSnapshotNode(child, snapshot, depth + 1));
     }
-    return result;
+    return chunks.join('');
 }
 function getAttributes(serializedAXNodeRoot) {
     const attributes = [`uid=${serializedAXNodeRoot.id}`];

package/build/src/issue-descriptions.js

@@ -33,3 +33,7 @@ export async function loadIssueDescriptions() {
 export function getIssueDescription(fileName) {
     return issueDescriptions[fileName] ?? null;
 }
+export const ISSUE_UTILS = {
+    loadIssueDescriptions,
+    getIssueDescription,
+};

package/build/src/main.js

@@ -6,7 +6,6 @@
 import './polyfill.js';
 import { ensureBrowserConnected, ensureBrowserLaunched } from './browser.js';
 import { parseArguments } from './cli.js';
-import { features } from './features.js';
 import { loadIssueDescriptions } from './issue-descriptions.js';
 import { logger, saveLogsToFile } from './logger.js';
 import { McpContext } from './McpContext.js';
@@ -14,18 +13,10 @@ import { McpResponse } from './McpResponse.js';
 import { Mutex } from './Mutex.js';
 import { McpServer, StdioServerTransport, SetLevelRequestSchema, } from './third_party/index.js';
 import { ToolCategory } from './tools/categories.js';
-import * as consoleTools from './tools/console.js';
-import * as emulationTools from './tools/emulation.js';
-import * as inputTools from './tools/input.js';
-import * as networkTools from './tools/network.js';
-import * as pagesTools from './tools/pages.js';
-import * as performanceTools from './tools/performance.js';
-import * as screenshotTools from './tools/screenshot.js';
-import * as scriptTools from './tools/script.js';
-import * as snapshotTools from './tools/snapshot.js';
+import { tools } from './tools/tools.js';
 // If moved update release-please config
 // x-release-please-start-version
-const VERSION = '0.10.2';
+const VERSION = '0.12.0';
 // x-release-please-end
 export const args = parseArguments(VERSION);
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
@@ -45,18 +36,22 @@ async function getContext() {
         extraArgs.push(`--proxy-server=${args.proxyServer}`);
     }
     const devtools = args.experimentalDevtools ?? false;
-    const browser = args.browserUrl || args.wsEndpoint
+    const browser = args.browserUrl || args.wsEndpoint || args.autoConnect
         ? await ensureBrowserConnected({
             browserURL: args.browserUrl,
             wsEndpoint: args.wsEndpoint,
             wsHeaders: args.wsHeaders,
+            // Important: only pass channel, if autoConnect is true.
+            channel: args.autoConnect ? args.channel : undefined,
+            userDataDir: args.userDataDir,
             devtools,
         })
         : await ensureBrowserLaunched({
             headless: args.headless,
             executablePath: args.executablePath,
             channel: args.channel,
-            isolated: args.isolated,
+            isolated: args.isolated ?? false,
+            userDataDir: args.userDataDir,
             logFile,
             viewport: args.viewport,
             args: extraArgs,
@@ -105,54 +100,36 @@ function registerTool(tool) {
             await tool.handler({
                 params,
             }, response, context);
-            try {
-                const content = await response.handle(tool.name, context);
-                return {
-                    content,
-                };
-            }
-            catch (error) {
-                const errorText = error instanceof Error ? error.message : String(error);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: errorText,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
+            const content = await response.handle(tool.name, context);
+            return {
+                content,
+            };
         }
         catch (err) {
-            logger(`${tool.name} error: ${err.message}`);
-            throw err;
+            logger(`${tool.name} error:`, err, err?.stack);
+            let errorText = err && 'message' in err ? err.message : String(err);
+            if ('cause' in err && err.cause) {
+                errorText += `\nCause: ${err.cause.message}`;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: errorText,
+                    },
+                ],
+                isError: true,
+            };
         }
         finally {
             guard.dispose();
         }
     });
 }
-const tools = [
-    ...Object.values(consoleTools),
-    ...Object.values(emulationTools),
-    ...Object.values(inputTools),
-    ...Object.values(networkTools),
-    ...Object.values(pagesTools),
-    ...Object.values(performanceTools),
-    ...Object.values(screenshotTools),
-    ...Object.values(scriptTools),
-    ...Object.values(snapshotTools),
-];
-tools.sort((a, b) => {
-    return a.name.localeCompare(b.name);
-});
 for (const tool of tools) {
     registerTool(tool);
 }
-if (features.issues) {
-    await loadIssueDescriptions();
-}
+await loadIssueDescriptions();
 const transport = new StdioServerTransport();
 await server.connect(transport);
 logger('Chrome DevTools MCP Server connected');

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -1,6 +1,6 @@
 Name: core-js
 URL: https://core-js.io
-Version: 3.46.0
+Version: 3.47.0
 License: MIT
 
 Copyright (c) 2014-2025 Denis Pushkarev, 2025 CoreJS Company
@@ -421,7 +421,7 @@ SOFTWARE.
 
 Name: @modelcontextprotocol/sdk
 URL: https://modelcontextprotocol.io
-Version: 1.21.1
+Version: 1.24.3
 License: MIT
 
 MIT License
@@ -447,6 +447,29 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
+-------------------- DEPENDENCY DIVIDER --------------------
+
+Name: zod-to-json-schema
+URL: https://github.com/StefanTerdell/zod-to-json-schema
+Version: 3.25.0
+License: ISC
+
+ISC License
+
+Copyright (c) 2020, Stefan Terdell
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: ajv
@@ -608,41 +631,18 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 
--------------------- DEPENDENCY DIVIDER --------------------
-
-Name: zod-to-json-schema
-URL: https://github.com/StefanTerdell/zod-to-json-schema
-Version: 3.24.6
-License: ISC
-
-ISC License
-
-Copyright (c) 2020, Stefan Terdell
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted, provided that the above
-copyright notice and this permission notice appear in all copies.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: puppeteer-core
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
-Version: 24.30.0
+Version: 24.32.1
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: @puppeteer/browsers
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/browsers
-Version: 2.10.13
+Version: 2.11.0
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------