chrome-devtools-mcp 0.24.0 → 0.25.0

package/README.md

@@ -477,7 +477,7 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 
 <!-- BEGIN AUTO GENERATED TOOLS -->
 
-- **Input automation** (9 tools)
+- **Input automation** (10 tools)
   - [`click`](docs/tool-reference.md#click)
   - [`drag`](docs/tool-reference.md#drag)
   - [`fill`](docs/tool-reference.md#fill)
@@ -487,6 +487,7 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
   - [`press_key`](docs/tool-reference.md#press_key)
   - [`type_text`](docs/tool-reference.md#type_text)
   - [`upload_file`](docs/tool-reference.md#upload_file)
+  - [`click_at`](docs/tool-reference.md#click_at)
 - **Navigation automation** (6 tools)
   - [`close_page`](docs/tool-reference.md#close_page)
   - [`list_pages`](docs/tool-reference.md#list_pages)
@@ -504,21 +505,32 @@ If you run into any issues, checkout our [troubleshooting guide](./docs/troubles
 - **Network** (2 tools)
   - [`get_network_request`](docs/tool-reference.md#get_network_request)
   - [`list_network_requests`](docs/tool-reference.md#list_network_requests)
-- **Debugging** (6 tools)
+- **Debugging** (8 tools)
   - [`evaluate_script`](docs/tool-reference.md#evaluate_script)
   - [`get_console_message`](docs/tool-reference.md#get_console_message)
   - [`lighthouse_audit`](docs/tool-reference.md#lighthouse_audit)
   - [`list_console_messages`](docs/tool-reference.md#list_console_messages)
   - [`take_screenshot`](docs/tool-reference.md#take_screenshot)
   - [`take_snapshot`](docs/tool-reference.md#take_snapshot)
+  - [`screencast_start`](docs/tool-reference.md#screencast_start)
+  - [`screencast_stop`](docs/tool-reference.md#screencast_stop)
+- **Memory** (4 tools)
+  - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)
+  - [`get_memory_snapshot_details`](docs/tool-reference.md#get_memory_snapshot_details)
+  - [`get_nodes_by_class`](docs/tool-reference.md#get_nodes_by_class)
+  - [`load_memory_snapshot`](docs/tool-reference.md#load_memory_snapshot)
 - **Extensions** (5 tools)
   - [`install_extension`](docs/tool-reference.md#install_extension)
   - [`list_extensions`](docs/tool-reference.md#list_extensions)
   - [`reload_extension`](docs/tool-reference.md#reload_extension)
   - [`trigger_extension_action`](docs/tool-reference.md#trigger_extension_action)
   - [`uninstall_extension`](docs/tool-reference.md#uninstall_extension)
-- **Memory** (1 tools)
-  - [`take_memory_snapshot`](docs/tool-reference.md#take_memory_snapshot)
+- **Third-party** (2 tools)
+  - [`execute_3p_developer_tool`](docs/tool-reference.md#execute_3p_developer_tool)
+  - [`list_3p_developer_tools`](docs/tool-reference.md#list_3p_developer_tools)
+- **WebMCP** (2 tools)
+  - [`execute_webmcp_tool`](docs/tool-reference.md#execute_webmcp_tool)
+  - [`list_webmcp_tools`](docs/tool-reference.md#list_webmcp_tools)
 
 <!-- END AUTO GENERATED TOOLS -->
 
@@ -595,7 +607,7 @@ The Chrome DevTools MCP server supports the following configuration option:
   Path to ffmpeg executable for screencast recording.
   - **Type:** string
 
-- **`--experimentalWebmcp`/ `--experimental-webmcp`**
+- **`--categoryExperimentalWebmcp`/ `--category-experimental-webmcp`**
   Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`
   - **Type:** boolean
 
@@ -627,6 +639,11 @@ The Chrome DevTools MCP server supports the following configuration option:
   - **Type:** boolean
   - **Default:** `false`
 
+- **`--categoryExperimentalThirdParty`/ `--category-experimental-third-party`**
+  Set to true to enable third-party developer tools exposed by the inspected page itself
+  - **Type:** boolean
+  - **Default:** `false`
+
 - **`--performanceCrux`/ `--performance-crux`**
   Set to false to disable sending URLs from performance traces to CrUX API to get field performance data.
   - **Type:** boolean

package/build/src/McpPage.js

@@ -30,7 +30,7 @@ export class McpPage {
     // Dialog
     #dialog;
     #dialogHandler;
-    inPageTools;
+    thirdPartyDeveloperTools;
     constructor(page, id) {
         this.pptrPage = page;
         this.id = id;
@@ -53,8 +53,8 @@ export class McpPage {
             throw new Error(`A dialog is open (${this.#dialog.type()}: ${this.#dialog.message()}).`);
         }
     }
-    getInPageTools() {
-        return this.inPageTools;
+    getThirdPartyDeveloperTools() {
+        return this.thirdPartyDeveloperTools;
     }
     getWebMcpTools() {
         return this.pptrPage.webmcp.tools();
@@ -88,7 +88,7 @@ export class McpPage {
     dispose() {
         this.pptrPage.off('dialog', this.#dialogHandler);
     }
-    async executeInPageTool(toolName, params, response) {
+    async executeThirdPartyDeveloperTool(toolName, params, response) {
         // Creates array of ElementHandles from the UIDs in the params.
         // We do not replace the uids with the ElementsHandles yet, because
         // the `evaluate` function only turns them into DOM elements if they

package/build/src/McpResponse.js

@@ -125,7 +125,7 @@ export class McpResponse {
     #networkRequestsOptions;
     #consoleDataOptions;
     #listExtensions;
-    #listInPageTools;
+    #listThirdPartyDeveloperTools;
     #listWebMcpTools;
     #devToolsData;
     #tabId;
@@ -163,9 +163,9 @@ export class McpResponse {
     setListExtensions() {
         this.#listExtensions = true;
     }
-    setListInPageTools() {
-        if (this.#args.categoryExperimentalInPage) {
-            this.#listInPageTools = true;
+    setListThirdPartyDeveloperTools() {
+        if (this.#args.categoryExperimentalThirdParty) {
+            this.#listThirdPartyDeveloperTools = true;
         }
     }
     setListWebMcpTools() {
@@ -381,14 +381,14 @@ export class McpResponse {
         if (this.#listExtensions) {
             extensions = await context.listExtensions();
         }
-        let inPageTools;
-        if (this.#listInPageTools) {
+        let thirdPartyDeveloperTools;
+        if (this.#listThirdPartyDeveloperTools) {
             const page = this.#page ?? context.getSelectedMcpPage();
-            inPageTools = await getToolGroup(page);
-            page.inPageTools = inPageTools;
+            thirdPartyDeveloperTools = await getToolGroup(page);
+            page.thirdPartyDeveloperTools = thirdPartyDeveloperTools;
         }
         let webmcpTools;
-        if (this.#listWebMcpTools && this.#args.experimentalWebmcp) {
+        if (this.#listWebMcpTools && this.#args.categoryExperimentalWebmcp) {
             const page = this.#page ?? context.getSelectedMcpPage();
             webmcpTools = page.getWebMcpTools();
         }
@@ -469,7 +469,7 @@ export class McpResponse {
             traceSummary: this.#attachedTraceSummary,
             extensions,
             lighthouseResult: this.#attachedLighthouseResult,
-            inPageTools,
+            thirdPartyDeveloperTools,
             webmcpTools,
             errorMessage: this.#error?.message,
         });
@@ -700,14 +700,16 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 response.push(extensionsMessage);
             }
         }
-        if (this.#listInPageTools) {
-            structuredContent.inPageTools = data.inPageTools ?? undefined;
-            response.push('## In-page tools');
-            if (!data.inPageTools || !data.inPageTools.tools) {
-                response.push('No in-page tools available.');
+        if (this.#listThirdPartyDeveloperTools) {
+            structuredContent.thirdPartyDeveloperTools =
+                data.thirdPartyDeveloperTools ?? undefined;
+            response.push('## Third-party developer tools');
+            if (!data.thirdPartyDeveloperTools ||
+                !data.thirdPartyDeveloperTools.tools) {
+                response.push('No third-party developer tools available.');
             }
             else {
-                const toolGroup = data.inPageTools;
+                const toolGroup = data.thirdPartyDeveloperTools;
                 response.push(`${toolGroup.name}: ${toolGroup.description}`);
                 response.push('Available tools:');
                 const toolDefinitionsMessage = toolGroup.tools

package/build/src/TextSnapshot.js

@@ -99,8 +99,8 @@ export class TextSnapshot {
         return snapshot;
     }
     // ExtraHandles represent DOM nodes which might not be part of the accessibility tree, e.g. DOM nodes
-    // returned by in-page tools. We insert them into the tree by finding the closest ancestor in the
-    // tree and inserting the node as a child. The ancestor's child nodes are re-parented if necessary.
+    // returned by third-party developer tools. We insert them into the tree by finding the closest ancestor
+    // in the tree and inserting the node as a child. The ancestor's child nodes are re-parented if necessary.
     static async insertExtraNodes(page, idToNode, seenUniqueIds, snapshotId, idCounter, rootNodeWithId, seenBackendNodeIds, extraHandles) {
         const { uniqueBackendNodeIdToMcpId } = page;
         const createExtraNode = async (handle) => {

package/build/src/bin/chrome-devtools-cli-options.js

@@ -162,9 +162,27 @@ export const commands = {
             },
         },
     },
+    execute_3p_developer_tool: {
+        description: 'Executes a tool exposed by the page. (requires flag: --categoryExperimentalThirdParty=true)',
+        category: 'Third-party',
+        args: {
+            toolName: {
+                name: 'toolName',
+                type: 'string',
+                description: 'The name of the tool to execute',
+                required: true,
+            },
+            params: {
+                name: 'params',
+                type: 'string',
+                description: 'The JSON-stringified parameters to pass to the tool',
+                required: false,
+            },
+        },
+    },
     execute_webmcp_tool: {
-        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --experimentalWebmcp=true)',
-        category: 'Debugging',
+        description: 'Executes a WebMCP tool exposed by the page. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
         args: {
             toolName: {
                 name: 'toolName',
@@ -371,6 +389,11 @@ export const commands = {
             },
         },
     },
+    list_3p_developer_tools: {
+        description: "Lists all third-party developer tools the page exposes for providing runtime information.\n  Third-party developer tools can be called via the 'execute_3p_developer_tool()' MCP tool.\n  Alternatively, third-party developer tools can be executed by calling 'evaluate_script' and adding the\n  following command to the script:\n  'window.__dtmcp.executeTool(toolName, params)'\n  This might be helpful when the third-party developer tools return non-serializable values or when composing\n  third-party developer tools with additional functionality. (requires flag: --categoryExperimentalThirdParty=true)",
+        category: 'Third-party',
+        args: {},
+    },
     list_console_messages: {
         description: 'List all console messages for the currently selected page since the last navigation.',
         category: 'Debugging',
@@ -444,8 +467,8 @@ export const commands = {
         args: {},
     },
     list_webmcp_tools: {
-        description: 'Lists all WebMCP tools the page exposes. (requires flag: --experimentalWebmcp=true)',
-        category: 'Debugging',
+        description: 'Lists all WebMCP tools the page exposes. (requires flag: --categoryExperimentalWebmcp=true)',
+        category: 'WebMCP',
         args: {},
     },
     load_memory_snapshot: {

package/build/src/bin/chrome-devtools-mcp-cli-options.js

@@ -183,7 +183,7 @@ export const cliOptions = {
         describe: 'Path to ffmpeg executable for screencast recording.',
         implies: 'experimentalScreencast',
     },
-    experimentalWebmcp: {
+    categoryExperimentalWebmcp: {
         type: 'boolean',
         describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 149+ with the following flags: `--enable-features=WebMCPTesting,DevToolsWebMCPSupport`',
     },
@@ -216,11 +216,10 @@ export const cliOptions = {
         default: false,
         describe: 'Set to true to include tools related to extensions. Note: This feature is currently only supported with a pipe connection. autoConnect, browserUrl, and wsEndpoint are not supported with this feature until 149 will be released.',
     },
-    categoryExperimentalInPage: {
+    categoryExperimentalThirdParty: {
         type: 'boolean',
-        hidden: true,
         default: false,
-        describe: 'Set to true to enable tools exposed by the inspected page itself',
+        describe: 'Set to true to enable third-party developer tools exposed by the inspected page itself',
     },
     performanceCrux: {
         type: 'boolean',
@@ -262,7 +261,7 @@ export const cliOptions = {
         default: false,
     },
 };
-export function parseArguments(version, argv = process.argv) {
+export function parseArguments(version, argv = process.argv, env = process.env) {
     const yargsInstance = yargs(hideBin(argv))
         .scriptName('npx chrome-devtools-mcp@latest')
         .options(cliOptions)
@@ -275,6 +274,10 @@ export function parseArguments(version, argv = process.argv) {
             !args.executablePath) {
             args.channel = 'stable';
         }
+        if (env['CI'] || env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS']) {
+            console.error("turning off usage statistics. process.env['CI'] || process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.");
+            args.usageStatistics = false;
+        }
         return true;
     })
         .example([

package/build/src/bin/chrome-devtools-mcp-main.js

@@ -15,11 +15,6 @@ import { cliOptions, parseArguments } from './chrome-devtools-mcp-cli-options.js
 await checkForUpdates('Run `npm install chrome-devtools-mcp@latest` to update.');
 export const args = parseArguments(VERSION);
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
-if (process.env['CI'] ||
-    process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS']) {
-    console.error("turning off usage statistics. process.env['CI'] || process.env['CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS'] is set.");
-    args.usageStatistics = false;
-}
 if (process.env['CHROME_DEVTOOLS_MCP_CRASH_ON_UNCAUGHT'] !== 'true') {
     process.on('unhandledRejection', (reason, promise) => {
         logger('Unhandled promise rejection', promise, reason);

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -869,14 +869,14 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: puppeteer-core
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
-Version: 24.42.0
+Version: 24.43.0
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: @puppeteer/browsers
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/browsers
-Version: 2.13.0
+Version: 2.13.1
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
@@ -1598,7 +1598,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: ws
 URL: https://github.com/websockets/ws
-Version: 8.19.0
+Version: 8.20.0
 License: MIT
 
 Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>

package/build/src/third_party/bundled-packages.json

@@ -1,11 +1,11 @@
 {
   "@modelcontextprotocol/sdk": "1.29.0",
-  "chrome-devtools-frontend": "1.0.1618066",
+  "chrome-devtools-frontend": "1.0.1625079",
   "core-js": "3.49.0",
   "debug": "4.4.3",
   "lighthouse": "13.2.0",
   "semver": "^7.7.4",
   "urlpattern-polyfill": "^10.1.0",
   "yargs": "18.0.0",
-  "puppeteer-core": "24.42.0"
+  "puppeteer-core": "24.43.0"
 }

package/build/src/third_party/devtools-formatter-worker.js

@@ -85,6 +85,15 @@ const HOST_RUNTIME$2 = {
         return new WebWorker(url);
     },
     workerScope: new WebWorkerScope(),
+    getOnLine() {
+        return navigator.onLine;
+    },
+    getUserAgent() {
+        return navigator.userAgent;
+    },
+    getLocalStorage() {
+        return 'localStorage' in globalThis ? globalThis.localStorage : undefined;
+    },
 };
 
 var HostRuntime$1 = /*#__PURE__*/Object.freeze({
@@ -167,6 +176,15 @@ const HOST_RUNTIME$1 = {
         return new NodeWorker(url);
     },
     workerScope: new NodeWorkerScope(),
+    getOnLine() {
+        return true;
+    },
+    getUserAgent() {
+        return 'Node.js';
+    },
+    getLocalStorage() {
+        return undefined;
+    },
 };
 
 var HostRuntime = /*#__PURE__*/Object.freeze({

package/build/src/third_party/devtools-heap-snapshot-worker.js

@@ -125,6 +125,15 @@ const HOST_RUNTIME$2 = {
         return new WebWorker(url);
     },
     workerScope: new WebWorkerScope(),
+    getOnLine() {
+        return navigator.onLine;
+    },
+    getUserAgent() {
+        return navigator.userAgent;
+    },
+    getLocalStorage() {
+        return 'localStorage' in globalThis ? globalThis.localStorage : undefined;
+    },
 };
 
 var HostRuntime$1 = /*#__PURE__*/Object.freeze({
@@ -207,6 +216,15 @@ const HOST_RUNTIME$1 = {
         return new NodeWorker(url);
     },
     workerScope: new NodeWorkerScope(),
+    getOnLine() {
+        return true;
+    },
+    getUserAgent() {
+        return 'Node.js';
+    },
+    getLocalStorage() {
+        return undefined;
+    },
 };
 
 var HostRuntime = /*#__PURE__*/Object.freeze({