chrome-devtools-mcp 0.12.1 → 0.13.0

package/build/src/main.js

@@ -6,21 +6,27 @@
 import './polyfill.js';
 import process from 'node:process';
 import { ensureBrowserConnected, ensureBrowserLaunched } from './browser.js';
-import { parseArguments } from './cli.js';
+import { cliOptions, parseArguments } from './cli.js';
 import { loadIssueDescriptions } from './issue-descriptions.js';
 import { logger, saveLogsToFile } from './logger.js';
 import { McpContext } from './McpContext.js';
 import { McpResponse } from './McpResponse.js';
 import { Mutex } from './Mutex.js';
+import { ClearcutLogger } from './telemetry/clearcut-logger.js';
+import { computeFlagUsage } from './telemetry/flag-utils.js';
 import { McpServer, StdioServerTransport, SetLevelRequestSchema, } from './third_party/index.js';
 import { ToolCategory } from './tools/categories.js';
 import { tools } from './tools/tools.js';
 // If moved update release-please config
 // x-release-please-start-version
-const VERSION = '0.12.1';
+const VERSION = '0.13.0';
 // x-release-please-end
 export const args = parseArguments(VERSION);
 const logFile = args.logFile ? saveLogsToFile(args.logFile) : undefined;
+let clearcutLogger;
+if (args.usageStatistics) {
+    clearcutLogger = new ClearcutLogger();
+}
 process.on('unhandledRejection', (reason, promise) => {
     logger('Unhandled promise rejection', promise, reason);
 });
@@ -35,9 +41,10 @@ server.server.setRequestHandler(SetLevelRequestSchema, () => {
 });
 let context;
 async function getContext() {
-    const extraArgs = (args.chromeArg ?? []).map(String);
+    const chromeArgs = (args.chromeArg ?? []).map(String);
+    const ignoreDefaultChromeArgs = (args.ignoreDefaultChromeArg ?? []).map(String);
     if (args.proxyServer) {
-        extraArgs.push(`--proxy-server=${args.proxyServer}`);
+        chromeArgs.push(`--proxy-server=${args.proxyServer}`);
     }
     const devtools = args.experimentalDevtools ?? false;
     const browser = args.browserUrl || args.wsEndpoint || args.autoConnect
@@ -58,7 +65,8 @@ async function getContext() {
             userDataDir: args.userDataDir,
             logFile,
             viewport: args.viewport,
-            args: extraArgs,
+            chromeArgs,
+            ignoreDefaultChromeArgs,
             acceptInsecureCerts: args.acceptInsecureCerts,
             devtools,
         });
@@ -74,6 +82,11 @@ const logDisclaimers = () => {
     console.error(`chrome-devtools-mcp exposes content of the browser instance to the MCP clients allowing them to inspect,
 debug, and modify any data in the browser or DevTools.
 Avoid sharing sensitive or personal information that you do not want to share with MCP clients.`);
+    if (args.usageStatistics) {
+        console.error(`
+Google collects usage statistics to improve Chrome DevTools MCP. To opt-out, run with --no-usage-statistics.
+For more details, visit: https://github.com/ChromeDevTools/chrome-devtools-mcp#usage-statistics`);
+    }
 };
 const toolMutex = new Mutex();
 function registerTool(tool) {
@@ -89,12 +102,22 @@ function registerTool(tool) {
         args.categoryNetwork === false) {
         return;
     }
+    if (tool.annotations.conditions?.includes('computerVision') &&
+        !args.experimentalVision) {
+        return;
+    }
+    if (tool.annotations.conditions?.includes('experimentalInteropTools') &&
+        !args.experimentalInteropTools) {
+        return;
+    }
     server.registerTool(tool.name, {
         description: tool.description,
         inputSchema: tool.schema,
         annotations: tool.annotations,
     }, async (params) => {
         const guard = await toolMutex.acquire();
+        const startTime = Date.now();
+        let success = false;
         try {
             logger(`${tool.name} request: ${JSON.stringify(params, null, '  ')}`);
             const context = await getContext();
@@ -104,10 +127,15 @@ function registerTool(tool) {
             await tool.handler({
                 params,
             }, response, context);
-            const content = await response.handle(tool.name, context);
-            return {
+            const { content, structuredContent } = await response.handle(tool.name, context);
+            const result = {
                 content,
             };
+            success = true;
+            if (args.experimentalStructuredContent) {
+                result.structuredContent = structuredContent;
+            }
+            return result;
         }
         catch (err) {
             logger(`${tool.name} error:`, err, err?.stack);
@@ -126,6 +154,11 @@ function registerTool(tool) {
             };
         }
         finally {
+            void clearcutLogger?.logToolInvocation({
+                toolName: tool.name,
+                success,
+                latencyMs: Date.now() - startTime,
+            });
             guard.dispose();
         }
     });
@@ -138,3 +171,4 @@ const transport = new StdioServerTransport();
 await server.connect(transport);
 logger('Chrome DevTools MCP Server connected');
 logDisclaimers();
+void clearcutLogger?.logServerStart(computeFlagUsage(args, cliOptions));

package/build/src/telemetry/clearcut-logger.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClearcutSender } from './clearcut-sender.js';
+export class ClearcutLogger {
+    #sender;
+    constructor(sender) {
+        this.#sender = sender ?? new ClearcutSender();
+    }
+    async logToolInvocation(args) {
+        await this.#sender.send({
+            tool_invocation: {
+                tool_name: args.toolName,
+                success: args.success,
+                latency_ms: args.latencyMs,
+            },
+        });
+    }
+    async logServerStart(flagUsage) {
+        await this.#sender.send({
+            server_start: {
+                flag_usage: flagUsage,
+            },
+        });
+    }
+}

package/build/src/telemetry/clearcut-sender.js

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { logger } from '../logger.js';
+export class ClearcutSender {
+    async send(event) {
+        logger('Telemetry event', JSON.stringify(event, null, 2));
+    }
+}

package/build/src/telemetry/flag-utils.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { toSnakeCase } from '../utils/string.js';
+/**
+ * Computes telemetry flag usage from parsed arguments and CLI options.
+ *
+ * Iterates over the defined CLI options to construct a payload:
+ * - Flag names are converted to snake_case (e.g. `browserUrl` -> `browser_url`).
+ * - A flag is logged as `{flag_name}_present` if:
+ *    - It has no default value, OR
+ *    - The provided value differs from the default value.
+ * - Boolean flags are logged with their literal value.
+ * - String flags with defined `choices` (Enums) are logged as their uppercase value.
+ */
+export function computeFlagUsage(args, options) {
+    const usage = {};
+    for (const [flagName, config] of Object.entries(options)) {
+        const value = args[flagName];
+        const snakeCaseName = toSnakeCase(flagName);
+        // If there isn't a default value provided for the flag,
+        // we're going to log whether it's present on the args user
+        // provided or not. If there is a default value, we only log presence
+        // if the value differs from the default, implying explicit user intent.
+        if (!('default' in config) || value !== config.default) {
+            usage[`${snakeCaseName}_present`] = value !== undefined && value !== null;
+        }
+        if (config.type === 'boolean' && typeof value === 'boolean') {
+            // For boolean options, we're going to log the value directly.
+            usage[snakeCaseName] = value;
+        }
+        else if (config.type === 'string' &&
+            typeof value === 'string' &&
+            'choices' in config &&
+            config.choices) {
+            // For enums, log the value as uppercase
+            // We're going to have an enum for such flags with choices represented
+            // as an `enum` where the keys of the enum will map to the uppercase `choice`.
+            usage[snakeCaseName] = value.toUpperCase();
+        }
+    }
+    return usage;
+}

package/build/src/telemetry/types.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Enums
+export var OsType;
+(function (OsType) {
+    OsType[OsType["OS_TYPE_UNSPECIFIED"] = 0] = "OS_TYPE_UNSPECIFIED";
+    OsType[OsType["OS_TYPE_WINDOWS"] = 1] = "OS_TYPE_WINDOWS";
+    OsType[OsType["OS_TYPE_MACOS"] = 2] = "OS_TYPE_MACOS";
+    OsType[OsType["OS_TYPE_LINUX"] = 3] = "OS_TYPE_LINUX";
+})(OsType || (OsType = {}));
+export var ChromeChannel;
+(function (ChromeChannel) {
+    ChromeChannel[ChromeChannel["CHROME_CHANNEL_UNSPECIFIED"] = 0] = "CHROME_CHANNEL_UNSPECIFIED";
+    ChromeChannel[ChromeChannel["CHROME_CHANNEL_CANARY"] = 1] = "CHROME_CHANNEL_CANARY";
+    ChromeChannel[ChromeChannel["CHROME_CHANNEL_DEV"] = 2] = "CHROME_CHANNEL_DEV";
+    ChromeChannel[ChromeChannel["CHROME_CHANNEL_BETA"] = 3] = "CHROME_CHANNEL_BETA";
+    ChromeChannel[ChromeChannel["CHROME_CHANNEL_STABLE"] = 4] = "CHROME_CHANNEL_STABLE";
+})(ChromeChannel || (ChromeChannel = {}));
+export var McpClient;
+(function (McpClient) {
+    McpClient[McpClient["MCP_CLIENT_UNSPECIFIED"] = 0] = "MCP_CLIENT_UNSPECIFIED";
+    McpClient[McpClient["MCP_CLIENT_CLAUDE_CODE"] = 1] = "MCP_CLIENT_CLAUDE_CODE";
+    McpClient[McpClient["MCP_CLIENT_GEMINI_CLI"] = 2] = "MCP_CLIENT_GEMINI_CLI";
+})(McpClient || (McpClient = {}));

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -421,7 +421,7 @@ SOFTWARE.
 
 Name: @modelcontextprotocol/sdk
 URL: https://modelcontextprotocol.io
-Version: 1.24.3
+Version: 1.25.2
 License: MIT
 
 MIT License
@@ -635,14 +635,14 @@ SOFTWARE.
 
 Name: puppeteer-core
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
-Version: 24.33.0
+Version: 24.35.0
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
 
 Name: @puppeteer/browsers
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/browsers
-Version: 2.11.0
+Version: 2.11.1
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
@@ -1054,7 +1054,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: basic-ftp
 URL: https://github.com/patrickjuchli/basic-ftp.git
-Version: 5.0.5
+Version: 5.1.0
 License: MIT
 
 Copyright (c) 2019 Patrick Juchli
@@ -1388,7 +1388,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 Name: ws
 URL: https://github.com/websockets/ws
-Version: 8.18.3
+Version: 8.19.0
 License: MIT
 
 Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>