chrome-devtools-mcp 1.1.1 → 1.3.0

package/build/src/{DevtoolsUtils.js → devtools/DevtoolsUtils.js}

@@ -3,9 +3,10 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Mutex } from '../Mutex.js';
+import { DevTools } from '../third_party/index.js';
 import { PuppeteerDevToolsConnection } from './DevToolsConnectionAdapter.js';
-import { Mutex } from './Mutex.js';
-import { DevTools } from './third_party/index.js';
+import { McpHostBindingAdapter } from './McpHostBindingAdapter.js';
 /**
  * A mock implementation of an issues manager that only implements the methods
  * that are actually used by the IssuesAggregator
@@ -16,22 +17,82 @@ export class FakeIssuesManager extends DevTools.Common.ObjectWrapper
         return [];
     }
 }
-// DevTools CDP errors can get noisy.
-DevTools.ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
-DevTools.I18n.DevToolsLocale.DevToolsLocale.instance({
-    create: true,
-    data: {
-        navigatorLanguage: 'en-US',
-        settingLanguage: 'en-US',
-        lookupClosestDevToolsLocale: l => l,
-    },
-});
-DevTools.I18n.i18n.registerLocaleDataForTest('en-US', {});
-DevTools.Formatter.FormatterWorkerPool.FormatterWorkerPool.instance({
-    forceNew: true,
-    entrypointURL: import.meta
-        .resolve('./third_party/devtools-formatter-worker.js'),
-});
+export function overrideDevToolsGlobals({ loadResource, }) {
+    DevTools.Host.InspectorFrontendHost.installInspectorFrontendHost(new McpHostBindingAdapter(loadResource));
+    // DevTools CDP errors can get noisy.
+    DevTools.ProtocolClient.InspectorBackend.test.suppressRequestErrors = true;
+    // Stub out Network emulation commands on the DevTools Agent prototype globally.
+    // This prevents the DevTools Frontend from ever resetting/clearing Puppeteer's
+    // active network blocking/throttling rules during target setup or session lifetime.
+    const networkAgentPrototype = DevTools.ProtocolClient.InspectorBackend.inspectorBackend.agentPrototypes.get('Network');
+    if (networkAgentPrototype) {
+        Object.defineProperty(networkAgentPrototype, 'invoke_emulateNetworkConditionsByRule', {
+            value: () => {
+                return Promise.resolve({
+                    ruleIds: [],
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_overrideNetworkState', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_enable', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_disable', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+        Object.defineProperty(networkAgentPrototype, 'invoke_setBlockedURLs', {
+            value: () => {
+                return Promise.resolve({
+                    getError: () => undefined,
+                });
+            },
+            writable: true,
+            configurable: true,
+            enumerable: true,
+        });
+    }
+    DevTools.I18n.DevToolsLocale.DevToolsLocale.instance({
+        create: true,
+        data: {
+            navigatorLanguage: 'en-US',
+            settingLanguage: 'en-US',
+            lookupClosestDevToolsLocale: l => l,
+        },
+    });
+    DevTools.I18n.i18n.registerLocaleDataForTest('en-US', {});
+    DevTools.Formatter.FormatterWorkerPool.FormatterWorkerPool.instance({
+        forceNew: true,
+        entrypointURL: import.meta
+            .resolve('../third_party/devtools-formatter-worker.js'),
+    });
+}
 export class UniverseManager {
     #browser;
     #createUniverseFor;

package/build/src/devtools/McpHostBindingAdapter.js

@@ -0,0 +1,165 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* eslint-disable @typescript-eslint/no-empty-function */
+import { DevTools } from '../third_party/index.js';
+/**
+ * BaseClass that is noop or throws for methods.
+ * the McpHostBindingAdapter should only implement methods
+ * that it needs to support.
+ */
+class BaseMcpHostBindingAdapter {
+    connectAutomaticFileSystem() { }
+    disconnectAutomaticFileSystem() { }
+    addFileSystem() { }
+    loadCompleted() { }
+    indexPath() { }
+    setInspectedPageBounds() { }
+    showCertificateViewer() { }
+    setWhitelistedShortcuts() { }
+    setEyeDropperActive() { }
+    inspectElementCompleted() { }
+    openInNewTab() { }
+    openSearchResultsInNewTab() { }
+    showItemInFolder() { }
+    removeFileSystem() { }
+    requestFileSystems() { }
+    save() { }
+    append() { }
+    close() { }
+    searchInPath() { }
+    stopIndexing() { }
+    bringToFront() { }
+    closeWindow() { }
+    copyText() { }
+    inspectedURLChanged() { }
+    isolatedFileSystem() {
+        throw new Error('Not implemented');
+    }
+    registerPreference() { }
+    getPreferences() { }
+    getPreference() { }
+    setPreference() { }
+    removePreference() { }
+    clearPreferences() { }
+    getSyncInformation() { }
+    getHostConfig() { }
+    upgradeDraggedFileSystemPermissions() { }
+    platform() {
+        throw new Error('Not implemented');
+    }
+    recordCountHistogram() { }
+    recordEnumeratedHistogram() { }
+    recordPerformanceHistogram() { }
+    recordPerformanceHistogramMedium() { }
+    recordUserMetricsAction() { }
+    recordNewBadgeUsage() { }
+    sendMessageToBackend() { }
+    setDevicesDiscoveryConfig() { }
+    setDevicesUpdatesEnabled() { }
+    openRemotePage() { }
+    openNodeFrontend() { }
+    setInjectedScriptForOrigin() { }
+    setIsDocked() { }
+    showSurvey() { }
+    canShowSurvey() { }
+    zoomFactor() {
+        throw new Error('Not implemented');
+    }
+    zoomIn() { }
+    zoomOut() { }
+    resetZoom() { }
+    showContextMenuAtPoint() { }
+    reattach() { }
+    readyForTest() { }
+    connectionReady() { }
+    setOpenNewWindowForPopups() { }
+    isHostedMode() {
+        throw new Error('Not implemented');
+    }
+    setAddExtensionCallback() { }
+    initialTargetId() {
+        throw new Error('Not implemented');
+    }
+    doAidaConversation(_request, _streamId, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    registerAidaClientEvent(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    aidaCodeComplete(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    dispatchHttpRequest(_request, cb) {
+        cb({
+            error: 'Not implemented',
+        });
+    }
+    recordImpression() { }
+    recordResize() { }
+    recordClick() { }
+    recordHover() { }
+    recordDrag() { }
+    recordChange() { }
+    recordKeyDown() { }
+    recordSettingAccess() { }
+    recordFunctionCall() { }
+    setChromeFlag() { }
+    requestRestart() { }
+    loadNetworkResource(_urlString, _headers, _streamId, _callback) { }
+}
+export class McpHostBindingAdapter extends BaseMcpHostBindingAdapter {
+    #loadResource;
+    constructor(loadResource) {
+        super();
+        this.#loadResource = loadResource;
+    }
+    isolatedFileSystem() {
+        return null;
+    }
+    platform() {
+        switch (process.platform) {
+            case 'darwin':
+                return 'mac';
+            case 'win32':
+                return 'windows';
+            default:
+                return 'linux';
+        }
+    }
+    zoomFactor() {
+        return 1;
+    }
+    isHostedMode() {
+        return true;
+    }
+    initialTargetId() {
+        return Promise.resolve(null);
+    }
+    loadNetworkResource(urlString, _headers, streamId, callback) {
+        if (!URL.canParse(urlString)) {
+            callback({
+                statusCode: 404,
+                urlValid: false,
+            });
+            return;
+        }
+        this.#loadResource(urlString)
+            .then(content => {
+            DevTools.Host.ResourceLoader.streamWrite(streamId, content);
+            callback({ statusCode: 200 });
+        })
+            .catch(() => {
+            callback({ statusCode: 404 });
+        });
+    }
+}
+//# sourceMappingURL=McpHostBindingAdapter.js.map

package/build/src/formatters/ConsoleFormatter.js

@@ -3,7 +3,7 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { createStackTraceForConsoleMessage, SymbolizedError, } from '../DevtoolsUtils.js';
+import { createStackTraceForConsoleMessage, SymbolizedError, } from '../devtools/DevtoolsUtils.js';
 import { UncaughtError } from '../PageCollector.js';
 import * as DevTools from '../third_party/index.js';
 export class ConsoleFormatter {

package/build/src/formatters/HeapSnapshotFormatter.js

@@ -45,6 +45,28 @@ export class HeapSnapshotFormatter {
         }
         return lines.join('\n');
     }
+    static formatRetainingPaths(retainingPaths) {
+        const lines = [];
+        function formatEdge(edge, depth) {
+            const indent = '  '.repeat(depth);
+            lines.push(`${indent}<- @${edge.nodeId} ${edge.nodeName} via ${edge.edgeType} ${edge.edgeName} (distance: ${edge.distance})`);
+            for (const child of edge.children) {
+                formatEdge(child, depth + 1);
+            }
+        }
+        for (const path of retainingPaths) {
+            formatEdge(path, 0);
+        }
+        return lines.join('\n');
+    }
+    static formatDominators(dominators) {
+        const lines = [];
+        lines.push('nodeId,nodeName,selfSize,retainedSize');
+        for (const node of dominators) {
+            lines.push(`${node.nodeId},${node.nodeName},${DevTools.I18n.ByteUtilities.formatBytesToKb(node.selfSize)},${DevTools.I18n.ByteUtilities.formatBytesToKb(node.retainedSize)}`);
+        }
+        return lines.join('\n');
+    }
     #getSortedAggregates() {
         return Object.values(this.#aggregates).sort((a, b) => b.maxRet - a.maxRet);
     }

package/build/src/formatters/IssueFormatter.js

@@ -99,7 +99,7 @@ export class IssueFormatter {
         const markdownDescription = this.#issue.getDescription();
         const filename = markdownDescription?.file;
         if (!filename) {
-            logger(`no description found for issue:` + this.#issue.code());
+            logger?.(`no description found for issue:` + this.#issue.code());
             return undefined;
         }
         // We already have the description logic in #getDescription, but title extraction is separate
@@ -107,7 +107,7 @@ export class IssueFormatter {
         // Ideally we should process markdown once.
         const rawMarkdown = ISSUE_UTILS.getIssueDescription(filename);
         if (!rawMarkdown) {
-            logger(`no markdown ${filename} found for issue:` + this.#issue.code());
+            logger?.(`no markdown ${filename} found for issue:` + this.#issue.code());
             return undefined;
         }
         try {
@@ -115,13 +115,13 @@ export class IssueFormatter {
             const markdownAst = DevTools.Marked.Marked.lexer(processedMarkdown);
             const title = DevTools.MarkdownIssueDescription.findTitleFromMarkdownAst(markdownAst);
             if (!title) {
-                logger('cannot read issue title from ' + filename);
+                logger?.('cannot read issue title from ' + filename);
                 return undefined;
             }
             return title;
         }
         catch {
-            logger('error parsing markdown for issue ' + this.#issue.code());
+            logger?.('error parsing markdown for issue ' + this.#issue.code());
             return undefined;
         }
     }

package/build/src/index.js

@@ -43,7 +43,7 @@ export async function createMcpServer(serverArgs, options) {
             context?.setRoots(roots.roots);
         }
         catch (e) {
-            logger('Failed to list roots', e);
+            logger?.('Failed to list roots', e);
         }
     };
     server.server.oninitialized = () => {
@@ -66,6 +66,12 @@ export async function createMcpServer(serverArgs, options) {
             chromeArgs.push(`--proxy-server=${serverArgs.proxyServer}`);
         }
         const devtools = serverArgs.experimentalDevtools ?? false;
+        const blocklist = serverArgs.blockedUrlPattern
+            ? serverArgs.blockedUrlPattern.map(String)
+            : undefined;
+        const allowlist = serverArgs.allowedUrlPattern
+            ? serverArgs.allowedUrlPattern.map(String)
+            : undefined;
         const browser = serverArgs.browserUrl || serverArgs.wsEndpoint || serverArgs.autoConnect
             ? await ensureBrowserConnected({
                 browserURL: serverArgs.browserUrl,
@@ -77,6 +83,8 @@ export async function createMcpServer(serverArgs, options) {
                     : undefined,
                 userDataDir: serverArgs.userDataDir,
                 devtools,
+                blocklist,
+                allowlist,
             })
             : await ensureBrowserLaunched({
                 headless: serverArgs.headless,
@@ -92,12 +100,16 @@ export async function createMcpServer(serverArgs, options) {
                 devtools,
                 enableExtensions: serverArgs.categoryExtensions,
                 viaCli: serverArgs.viaCli,
+                blocklist,
+                allowlist,
             });
         if (context?.browser !== browser) {
             context = await McpContext.from(browser, logger, {
                 experimentalDevToolsDebugging: devtools,
                 experimentalIncludeAllPages: serverArgs.experimentalIncludeAllPages,
                 performanceCrux: serverArgs.performanceCrux,
+                hasNetworkBlockOrAllowlist: Boolean((blocklist && blocklist.length > 0) ||
+                    (allowlist && allowlist.length > 0)),
             });
             await updateRoots();
         }

package/build/src/telemetry/ClearcutLogger.js

@@ -136,7 +136,7 @@ export class ClearcutLogger {
             }
         }
         catch (err) {
-            logger('Error in logDailyActiveIfNeeded:', err);
+            logger?.('Error in logDailyActiveIfNeeded:', err);
         }
     }
     async logServerError(args) {

package/build/src/telemetry/WatchdogClient.js

@@ -35,10 +35,10 @@ export class WatchdogClient {
         });
         this.#childProcess.unref();
         this.#childProcess.on('error', err => {
-            logger('Watchdog process error:', err);
+            logger?.('Watchdog process error:', err);
         });
         this.#childProcess.on('exit', (code, signal) => {
-            logger(`Watchdog exited with code ${code} and signal ${signal}`);
+            logger?.(`Watchdog exited with code ${code} and signal ${signal}`);
         });
     }
     send(message) {
@@ -50,11 +50,11 @@ export class WatchdogClient {
                 this.#childProcess.stdin.write(line);
             }
             catch (err) {
-                logger('Failed to write to watchdog stdin', err);
+                logger?.('Failed to write to watchdog stdin', err);
             }
         }
         else {
-            logger('Watchdog stdin not available, dropping message');
+            logger?.('Watchdog stdin not available, dropping message');
         }
     }
 }

package/build/src/telemetry/persistence.js

@@ -45,7 +45,7 @@ export class FilePersistence {
             return JSON.parse(content);
         }
         catch (error) {
-            logger(`Failed to read telemetry state from ${filePath}:`, error);
+            logger?.(`Failed to read telemetry state from ${filePath}:`, error);
             void ClearcutLogger.get()?.logServerError({
                 errorCode: ErrorCode.ERROR_CODE_PERSISTENCE_FILE_READ_FAILED,
             });
@@ -62,7 +62,7 @@ export class FilePersistence {
         }
         catch (error) {
             // Ignore errors during state saving to avoid crashing the server
-            logger(`Failed to save telemetry state to ${filePath}:`, error);
+            logger?.(`Failed to save telemetry state to ${filePath}:`, error);
             void ClearcutLogger.get()?.logServerError({
                 errorCode: ErrorCode.ERROR_CODE_PERSISTENCE_FILE_SAVE_FAILED,
             });

package/build/src/telemetry/watchdog/ClearcutSender.js

@@ -48,7 +48,7 @@ export class ClearcutSender {
             app_version: this.#appVersion,
             os_type: this.#osType,
         };
-        logger('Enqueing telemetry event', JSON.stringify(eventToSend, null, 2));
+        logger?.('Enqueing telemetry event', JSON.stringify(eventToSend, null, 2));
         this.#addToBuffer(eventToSend);
         if (!this.#timerStarted) {
             this.#timerStarted = true;
@@ -69,10 +69,10 @@ export class ClearcutSender {
                 this.#finalFlush(),
                 new Promise(resolve => setTimeout(resolve, SHUTDOWN_TIMEOUT_MS)),
             ]);
-            logger('Final flush completed');
+            logger?.('Final flush completed');
         }
         catch (error) {
-            logger('Final flush failed:', error);
+            logger?.('Final flush failed:', error);
         }
     }
     async #flush() {
@@ -97,7 +97,7 @@ export class ClearcutSender {
                 }
             }
             else if (result.isPermanentError) {
-                logger('Permanent error, dropped batch of', eventsToSend.length, 'events');
+                logger?.('Permanent error, dropped batch of', eventsToSend.length, 'events');
             }
             else {
                 // Transient error: Requeue events at the front of the buffer
@@ -108,7 +108,7 @@ export class ClearcutSender {
         catch (error) {
             // Safety catch for unexpected errors, requeue events
             this.#buffer = [...eventsToSend, ...this.#buffer];
-            logger('Flush failed unexpectedly:', error);
+            logger?.('Flush failed unexpectedly:', error);
         }
         finally {
             this.#isFlushing = false;
@@ -118,7 +118,7 @@ export class ClearcutSender {
     #addToBuffer(event) {
         if (this.#buffer.length >= MAX_BUFFER_SIZE) {
             this.#buffer.shift();
-            logger('Telemetry buffer overflow: dropped oldest event');
+            logger?.('Telemetry buffer overflow: dropped oldest event');
         }
         this.#buffer.push({
             event,
@@ -126,18 +126,18 @@ export class ClearcutSender {
         });
     }
     #scheduleFlush(delayMs) {
-        logger(`Scheduling flush in ${delayMs}`);
+        logger?.(`Scheduling flush in ${delayMs}`);
         if (this.#flushTimer) {
             clearTimeout(this.#flushTimer);
         }
         this.#flushTimer = setTimeout(() => {
             this.#flush().catch(err => {
-                logger('Flush error:', err);
+                logger?.('Flush error:', err);
             });
         }, delayMs);
     }
     async #sendBatch(events) {
-        logger(`Sending batch of ${events.length}`);
+        logger?.(`Sending batch of ${events.length}`);
         const requestBody = {
             log_source: LOG_SOURCE,
             request_time_ms: Date.now().toString(),
@@ -176,7 +176,7 @@ export class ClearcutSender {
             if (status >= 500 || status === 429) {
                 return { success: false };
             }
-            logger('Telemetry permanent error:', status);
+            logger?.('Telemetry permanent error:', status);
             return { success: false, isPermanentError: true };
         }
         catch {

package/build/src/telemetry/watchdog/main.js

@@ -65,7 +65,7 @@ function main() {
             process.exit(code);
         });
     };
-    logger('Watchdog started', JSON.stringify({
+    logger?.('Watchdog started', JSON.stringify({
         pid: process.pid,
         parentPid,
         version: appVersion,
@@ -84,15 +84,15 @@ function main() {
             return;
         }
         isShuttingDown = true;
-        logger(`Parent death detected (${reason}). Sending shutdown event...`);
+        logger?.(`Parent death detected (${reason}). Sending shutdown event...`);
         sender
             .sendShutdownEvent()
             .then(() => {
-            logger('Shutdown event sent. Exiting.');
+            logger?.('Shutdown event sent. Exiting.');
             exit(0);
         })
             .catch(err => {
-            logger('Failed to send shutdown event', err);
+            logger?.('Failed to send shutdown event', err);
             exit(1);
         });
     }
@@ -114,7 +114,7 @@ function main() {
             }
         }
         catch (err) {
-            logger('Failed to parse IPC message', err);
+            logger?.('Failed to parse IPC message', err);
         }
     });
 }

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -324,7 +324,7 @@ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH RE
 
 Name: semver
 URL: git+https://github.com/npm/node-semver.git
-Version: 7.8.1
+Version: 7.8.3
 License: ISC
 
 The ISC License
@@ -906,6 +906,36 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 
+-------------------- DEPENDENCY DIVIDER --------------------
+
+Name: @toon-format/toon
+URL: https://toonformat.dev
+Version: 2.3.0
+License: MIT
+
+MIT License
+
+Copyright (c) 2025-PRESENT Johann Schopplich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: chrome-devtools-frontend

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

@@ -1,6 +1,7 @@
 {
   "@modelcontextprotocol/sdk": "1.29.0",
-  "chrome-devtools-frontend": "1.0.1632065",
+  "@toon-format/toon": "^2.2.0",
+  "chrome-devtools-frontend": "1.0.1646286",
   "core-js": "3.49.0",
   "debug": "4.4.3",
   "lighthouse": "13.3.0",

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

@@ -2645,9 +2645,9 @@ var ExperimentName;
     ExperimentName["ALL"] = "*";
     ExperimentName["PROTOCOL_MONITOR"] = "protocol-monitor";
     ExperimentName["INSTRUMENTATION_BREAKPOINTS"] = "instrumentation-breakpoints";
-    ExperimentName["USE_SOURCE_MAP_SCOPES"] = "use-source-map-scopes";
     ExperimentName["DURABLE_MESSAGES"] = "durable-messages";
     ExperimentName["JPEG_XL"] = "jpeg-xl";
+    ExperimentName["PLUS_BUTTON"] = "plus-button";
 })(ExperimentName || (ExperimentName = {}));
 
 // Copyright 2016 The Chromium Authors