chrome-devtools-mcp 0.6.0 → 0.7.0

package/build/src/browser.js

@@ -27,8 +27,6 @@ function targetFilter(target) {
 }
 const connectOptions = {
     targetFilter,
-    // We do not expect any single CDP command to take more than 10sec.
-    protocolTimeout: 10_000,
 };
 export async function ensureBrowserConnected(browserURL) {
     if (browser?.connected) {
@@ -60,9 +58,12 @@ export async function launch(options) {
     if (customDevTools) {
         args.push(`--custom-devtools-frontend=file://${customDevTools}`);
     }
-    let puppeterChannel;
+    if (headless) {
+        args.push('--screen-info={3840x2160}');
+    }
+    let puppeteerChannel;
     if (!executablePath) {
-        puppeterChannel =
+        puppeteerChannel =
             channel && channel !== 'stable'
                 ? `chrome-${channel}`
                 : 'chrome';
@@ -70,7 +71,7 @@ export async function launch(options) {
     try {
         const browser = await puppeteer.launch({
             ...connectOptions,
-            channel: puppeterChannel,
+            channel: puppeteerChannel,
             executablePath,
             defaultViewport: null,
             userDataDir,

package/build/src/cli.js

@@ -11,7 +11,15 @@ export const cliOptions = {
         description: 'Connect to a running Chrome instance using port forwarding. For more details see: https://developer.chrome.com/docs/devtools/remote-debugging/local-server.',
         alias: 'u',
         coerce: (url) => {
-            new URL(url);
+            if (!url) {
+                return;
+            }
+            try {
+                new URL(url);
+            }
+            catch {
+                throw new Error(`Provided browserUrl ${url} is not valid URL.`);
+            }
             return url;
         },
     },
@@ -50,7 +58,7 @@ export const cliOptions = {
     },
     viewport: {
         type: 'string',
-        describe: 'Initial viewport size for the Chromee instances started by the server. For example, `1280x720`',
+        describe: 'Initial viewport size for the Chrome instances started by the server. For example, `1280x720`. In headless mode, max size is 3840x2160px.',
         coerce: (arg) => {
             if (arg === undefined) {
                 return;

package/build/src/formatters/consoleFormatter.js

@@ -30,7 +30,7 @@ async function formatConsoleMessage(msg) {
                 return error.toString();
             })
                 .catch(() => {
-                return 'Error occured';
+                return 'Error occurred';
             });
             void errorHandle.dispose().catch();
             const formattedArgs = await formatArgs(args.slice(1));

package/build/src/formatters/networkFormatter.js

@@ -3,6 +3,8 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { isUtf8 } from 'node:buffer';
+const BODY_CONTEXT_SIZE_LIMIT = 10000;
 export function getShortDescriptionForRequest(request) {
     return `${request.url()} ${request.method()} ${getStatusFromRequest(request)}`;
 }
@@ -32,3 +34,45 @@ export function getFormattedHeaderValue(headers) {
     }
     return response;
 }
+export async function getFormattedResponseBody(httpResponse, sizeLimit = BODY_CONTEXT_SIZE_LIMIT) {
+    try {
+        const responseBuffer = await httpResponse.buffer();
+        if (isUtf8(responseBuffer)) {
+            const responseAsTest = responseBuffer.toString('utf-8');
+            if (responseAsTest.length === 0) {
+                return `<empty response>`;
+            }
+            return `${getSizeLimitedString(responseAsTest, sizeLimit)}`;
+        }
+        return `<binary data>`;
+    }
+    catch {
+        // buffer() call might fail with CDP exception, in this case we don't print anything in the context
+        return;
+    }
+}
+export async function getFormattedRequestBody(httpRequest, sizeLimit = BODY_CONTEXT_SIZE_LIMIT) {
+    if (httpRequest.hasPostData()) {
+        const data = httpRequest.postData();
+        if (data) {
+            return `${getSizeLimitedString(data, sizeLimit)}`;
+        }
+        try {
+            const fetchData = await httpRequest.fetchPostData();
+            if (fetchData) {
+                return `${getSizeLimitedString(fetchData, sizeLimit)}`;
+            }
+        }
+        catch {
+            // fetchPostData() call might fail with CDP exception, in this case we don't print anything in the context
+            return;
+        }
+    }
+    return;
+}
+function getSizeLimitedString(text, sizeLimit) {
+    if (text.length > sizeLimit) {
+        return `${text.substring(0, sizeLimit) + '... <truncated>'}`;
+    }
+    return `${text}`;
+}

package/build/src/tools/emulation.js

@@ -9,11 +9,12 @@ import { ToolCategories } from './categories.js';
 import { defineTool } from './ToolDefinition.js';
 const throttlingOptions = [
     'No emulation',
+    'Offline',
     ...Object.keys(PredefinedNetworkConditions),
 ];
 export const emulateNetwork = defineTool({
     name: 'emulate_network',
-    description: `Emulates network conditions such as throttling on the selected page.`,
+    description: `Emulates network conditions such as throttling or offline mode on the selected page.`,
     annotations: {
         category: ToolCategories.EMULATION,
         readOnlyHint: false,
@@ -21,7 +22,7 @@ export const emulateNetwork = defineTool({
     schema: {
         throttlingOption: z
             .enum(throttlingOptions)
-            .describe(`The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable.`),
+            .describe(`The network throttling option to emulate. Available throttling options are: ${throttlingOptions.join(', ')}. Set to "No emulation" to disable. Set to "Offline" to simulate offline network conditions.`),
     },
     handler: async (request, _response, context) => {
         const page = context.getSelectedPage();
@@ -31,6 +32,16 @@ export const emulateNetwork = defineTool({
             context.setNetworkConditions(null);
             return;
         }
+        if (conditions === 'Offline') {
+            await page.emulateNetworkConditions({
+                offline: true,
+                download: 0,
+                upload: 0,
+                latency: 0,
+            });
+            context.setNetworkConditions('Offline');
+            return;
+        }
         if (conditions in PredefinedNetworkConditions) {
             const networkCondition = PredefinedNetworkConditions[conditions];
             await page.emulateNetworkConditions(networkCondition);

package/build/src/tools/performance.js

@@ -84,7 +84,7 @@ export const stopTrace = defineTool({
     },
     schema: {},
     handler: async (_request, response, context) => {
-        if (!context.isRunningPerformanceTrace) {
+        if (!context.isRunningPerformanceTrace()) {
             return;
         }
         const page = context.getSelectedPage();
@@ -93,7 +93,7 @@ export const stopTrace = defineTool({
 });
 export const analyzeInsight = defineTool({
     name: 'performance_analyze_insight',
-    description: 'Provides more detailed information on a specific Performance Insight that was highlighed in the results of a trace recording.',
+    description: 'Provides more detailed information on a specific Performance Insight that was highlighted in the results of a trace recording.',
     annotations: {
         category: ToolCategories.PERFORMANCE,
         readOnlyHint: true,
@@ -124,7 +124,6 @@ async function stopTracingAndAppendOutput(page, response, context) {
         response.appendResponseLine('The performance trace has been stopped.');
         if (traceResultIsSuccess(result)) {
             context.storeTraceRecording(result);
-            response.appendResponseLine('Here is a high level summary of the trace and the Insights that were found:');
             const traceSummaryText = getTraceSummary(result);
             response.appendResponseLine(traceSummaryText);
         }
@@ -136,7 +135,7 @@ async function stopTracingAndAppendOutput(page, response, context) {
     catch (e) {
         const errorText = e instanceof Error ? e.message : JSON.stringify(e);
         logger(`Error stopping performance trace: ${errorText}`);
-        response.appendResponseLine('An error occured generating the response for this trace:');
+        response.appendResponseLine('An error occurred generating the response for this trace:');
         response.appendResponseLine(errorText);
     }
     finally {

package/build/src/tools/screenshot.js

@@ -3,7 +3,6 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { writeFile } from 'node:fs/promises';
 import z from 'zod';
 import { ToolCategories } from './categories.js';
 import { defineTool } from './ToolDefinition.js';
@@ -65,8 +64,8 @@ export const screenshot = defineTool({
             response.appendResponseLine("Took a screenshot of the current page's viewport.");
         }
         if (request.params.filePath) {
-            await writeFile(request.params.filePath, screenshot);
-            response.appendResponseLine(`Saved screenshot to ${request.params.filePath}.`);
+            const file = await context.saveFile(screenshot, request.params.filePath);
+            response.appendResponseLine(`Saved screenshot to ${file.filename}.`);
         }
         else if (screenshot.length >= 2_000_000) {
             const { filename } = await context.saveTemporaryFile(screenshot, `image/${request.params.format}`);

package/build/src/trace-processing/parse.js

@@ -43,7 +43,7 @@ export async function parseRawTraceBuffer(buffer) {
     }
     catch (e) {
         const errorText = e instanceof Error ? e.message : JSON.stringify(e);
-        logger(`Unexpeced error parsing trace: ${errorText}`);
+        logger(`Unexpected error parsing trace: ${errorText}`);
         return {
             error: errorText,
         };
@@ -53,15 +53,16 @@ const extraFormatDescriptions = `Information on performance traces may contain m
 
 ${PerformanceTraceFormatter.callFrameDataFormatDescription}
 
-${PerformanceTraceFormatter.networkDataFormatDescription}
-`;
+${PerformanceTraceFormatter.networkDataFormatDescription}`;
 export function getTraceSummary(result) {
     const focus = AgentFocus.fromParsedTrace(result.parsedTrace);
     const formatter = new PerformanceTraceFormatter(focus);
-    const output = formatter.formatTraceSummary();
-    return `${extraFormatDescriptions}
+    const summaryText = formatter.formatTraceSummary();
+    return `## Summary of Performance trace findings:
+${summaryText}
 
-${output}`;
+## Details on call tree & network request formats:
+${extraFormatDescriptions}`;
 }
 export function getInsightOutput(result, insightName) {
     if (!result.insights) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
@@ -37,11 +37,12 @@
   "homepage": "https://github.com/ChromeDevTools/chrome-devtools-mcp#readme",
   "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.18.2",
+    "@modelcontextprotocol/sdk": "1.19.1",
     "core-js": "3.45.1",
     "debug": "4.4.3",
-    "puppeteer-core": "24.22.3",
-    "yargs": "18.0.0"
+    "puppeteer-core": "^24.23.1",
+    "yargs": "18.0.0",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@eslint/js": "^9.35.0",
@@ -53,13 +54,13 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1521880",
+    "chrome-devtools-frontend": "1.0.1524741",
     "eslint": "^9.35.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.22.3",
+    "puppeteer": "24.23.1",
     "sinon": "^21.0.0",
     "typescript": "^5.9.2",
     "typescript-eslint": "^8.43.0"