chrome-devtools-mcp 0.10.1 → 0.11.0

package/build/src/tools/console.js

@@ -26,6 +26,7 @@ const FILTERABLE_MESSAGE_TYPES = [
     'count',
     'timeEnd',
     'verbose',
+    'issue',
 ];
 export const listConsoleMessages = defineTool({
     name: 'list_console_messages',

package/build/src/tools/emulation.js

@@ -29,18 +29,32 @@ export const emulate = defineTool({
             .max(20)
             .optional()
             .describe('Represents the CPU slowdown factor. Set the rate to 1 to disable throttling. If omitted, throttling remains unchanged.'),
+        geolocation: zod
+            .object({
+            latitude: zod
+                .number()
+                .min(-90)
+                .max(90)
+                .describe('Latitude between -90 and 90.'),
+            longitude: zod
+                .number()
+                .min(-180)
+                .max(180)
+                .describe('Longitude between -180 and 180.'),
+        })
+            .nullable()
+            .optional()
+            .describe('Geolocation to emulate. Set to null to clear the geolocation override.'),
     },
     handler: async (request, _response, context) => {
         const page = context.getSelectedPage();
-        const networkConditions = request.params.networkConditions;
-        const cpuThrottlingRate = request.params.cpuThrottlingRate;
+        const { networkConditions, cpuThrottlingRate, geolocation } = request.params;
         if (networkConditions) {
             if (networkConditions === 'No emulation') {
                 await page.emulateNetworkConditions(null);
                 context.setNetworkConditions(null);
-                return;
             }
-            if (networkConditions === 'Offline') {
+            else if (networkConditions === 'Offline') {
                 await page.emulateNetworkConditions({
                     offline: true,
                     download: 0,
@@ -48,9 +62,8 @@ export const emulate = defineTool({
                     latency: 0,
                 });
                 context.setNetworkConditions('Offline');
-                return;
             }
-            if (networkConditions in PredefinedNetworkConditions) {
+            else if (networkConditions in PredefinedNetworkConditions) {
                 const networkCondition = PredefinedNetworkConditions[networkConditions];
                 await page.emulateNetworkConditions(networkCondition);
                 context.setNetworkConditions(networkConditions);
@@ -60,5 +73,15 @@ export const emulate = defineTool({
             await page.emulateCPUThrottling(cpuThrottlingRate);
             context.setCpuThrottlingRate(cpuThrottlingRate);
         }
+        if (geolocation !== undefined) {
+            if (geolocation === null) {
+                await page.setGeolocation({ latitude: 0, longitude: 0 });
+                context.setGeolocation(null);
+            }
+            else {
+                await page.setGeolocation(geolocation);
+                context.setGeolocation(geolocation);
+            }
+        }
     },
 });

package/build/src/tools/screenshot.js

@@ -49,10 +49,12 @@ export const screenshot = defineTool({
         else {
             pageOrHandle = context.getSelectedPage();
         }
+        const format = request.params.format;
+        const quality = format === 'png' ? undefined : request.params.quality;
         const screenshot = await pageOrHandle.screenshot({
-            type: request.params.format,
+            type: format,
             fullPage: request.params.fullPage,
-            quality: request.params.quality,
+            quality,
             optimizeForSpeed: true, // Bonus: optimize encoding for speed
         });
         if (request.params.uid) {

package/build/src/tools/snapshot.js

@@ -45,7 +45,7 @@ export const waitFor = defineTool({
         ...timeoutSchema,
     },
     handler: async (request, response, context) => {
-        await context.waitForTextOnPage(request.params);
+        await context.waitForTextOnPage(request.params.text, request.params.timeout);
         response.appendResponseLine(`Element with text "${request.params.text}" found.`);
         response.includeSnapshot();
     },

package/build/src/tools/tools.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as consoleTools from './console.js';
+import * as emulationTools from './emulation.js';
+import * as inputTools from './input.js';
+import * as networkTools from './network.js';
+import * as pagesTools from './pages.js';
+import * as performanceTools from './performance.js';
+import * as screenshotTools from './screenshot.js';
+import * as scriptTools from './script.js';
+import * as snapshotTools from './snapshot.js';
+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);
+});
+export { tools };

package/build/src/utils/keyboard.js

@@ -1,3 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
 // See the KeyInput type for the list of supported keys.
 const validKeys = new Set([
     '0',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",
@@ -40,7 +40,7 @@
   "mcpName": "io.github.ChromeDevTools/chrome-devtools-mcp",
   "devDependencies": {
     "@eslint/js": "^9.35.0",
-    "@modelcontextprotocol/sdk": "1.21.0",
+    "@modelcontextprotocol/sdk": "1.24.1",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
@@ -48,20 +48,20 @@
     "@types/debug": "^4.1.12",
     "@types/filesystem": "^0.0.36",
     "@types/node": "^24.3.3",
-    "@types/sinon": "^17.0.4",
+    "@types/sinon": "^21.0.0",
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1539728",
-    "core-js": "3.46.0",
+    "chrome-devtools-frontend": "1.0.1550444",
+    "core-js": "3.47.0",
     "debug": "4.4.3",
     "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.29.1",
-    "rollup": "4.52.5",
+    "puppeteer": "24.32.0",
+    "rollup": "4.53.3",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "sinon": "^21.0.0",

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/Linkifier.js

@@ -1,34 +0,0 @@
-// Copyright 2019 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-export class Linkifier {
-    static async linkify(object, options) {
-        if (!object) {
-            throw new Error('Can\'t linkify ' + object);
-        }
-        const linkifierRegistration = getApplicableRegisteredlinkifiers(object)[0];
-        if (!linkifierRegistration) {
-            throw new Error('No linkifiers registered for object ' + object);
-        }
-        const linkifier = await linkifierRegistration.loadLinkifier();
-        return linkifier.linkify(object, options);
-    }
-}
-const registeredLinkifiers = [];
-export function registerLinkifier(registration) {
-    registeredLinkifiers.push(registration);
-}
-export function getApplicableRegisteredlinkifiers(object) {
-    return registeredLinkifiers.filter(isLinkifierApplicableToContextTypes);
-    function isLinkifierApplicableToContextTypes(linkifierRegistration) {
-        if (!linkifierRegistration.contextTypes) {
-            return true;
-        }
-        for (const contextType of linkifierRegistration.contextTypes()) {
-            if (object instanceof contextType) {
-                return true;
-            }
-        }
-        return false;
-    }
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/platform/DOMUtilities.js

@@ -1,122 +0,0 @@
-// Copyright 2022 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-/**
- * `document.activeElement` will not enter shadow roots to find the element
- * that has focus; use this method if you need to traverse through any shadow
- * roots to find the actual, specific focused element.
- */
-export function deepActiveElement(doc) {
-    let activeElement = doc.activeElement;
-    while (activeElement?.shadowRoot?.activeElement) {
-        activeElement = activeElement.shadowRoot.activeElement;
-    }
-    return activeElement;
-}
-export function getEnclosingShadowRootForNode(node) {
-    let parentNode = node.parentNodeOrShadowHost();
-    while (parentNode) {
-        if (parentNode instanceof ShadowRoot) {
-            return parentNode;
-        }
-        parentNode = parentNode.parentNodeOrShadowHost();
-    }
-    return null;
-}
-export function rangeOfWord(rootNode, offset, stopCharacters, stayWithinNode, direction) {
-    let startNode;
-    let startOffset = 0;
-    let endNode;
-    let endOffset = 0;
-    if (!stayWithinNode) {
-        stayWithinNode = rootNode;
-    }
-    if (!direction || direction === 'backward' || direction === 'both') {
-        let node = rootNode;
-        while (node) {
-            if (node === stayWithinNode) {
-                if (!startNode) {
-                    startNode = stayWithinNode;
-                }
-                break;
-            }
-            if (node.nodeType === Node.TEXT_NODE && node.nodeValue !== null) {
-                const start = (node === rootNode ? (offset - 1) : (node.nodeValue.length - 1));
-                for (let i = start; i >= 0; --i) {
-                    if (stopCharacters.indexOf(node.nodeValue[i]) !== -1) {
-                        startNode = node;
-                        startOffset = i + 1;
-                        break;
-                    }
-                }
-            }
-            if (startNode) {
-                break;
-            }
-            node = node.traversePreviousNode(stayWithinNode);
-        }
-        if (!startNode) {
-            startNode = stayWithinNode;
-            startOffset = 0;
-        }
-    }
-    else {
-        startNode = rootNode;
-        startOffset = offset;
-    }
-    if (!direction || direction === 'forward' || direction === 'both') {
-        let node = rootNode;
-        while (node) {
-            if (node === stayWithinNode) {
-                if (!endNode) {
-                    endNode = stayWithinNode;
-                }
-                break;
-            }
-            if (node.nodeType === Node.TEXT_NODE && node.nodeValue !== null) {
-                const start = (node === rootNode ? offset : 0);
-                for (let i = start; i < node.nodeValue.length; ++i) {
-                    if (stopCharacters.indexOf(node.nodeValue[i]) !== -1) {
-                        endNode = node;
-                        endOffset = i;
-                        break;
-                    }
-                }
-            }
-            if (endNode) {
-                break;
-            }
-            node = node.traverseNextNode(stayWithinNode);
-        }
-        if (!endNode) {
-            endNode = stayWithinNode;
-            endOffset = stayWithinNode.nodeType === Node.TEXT_NODE ? stayWithinNode.nodeValue?.length || 0 :
-                stayWithinNode.childNodes.length;
-        }
-    }
-    else {
-        endNode = rootNode;
-        endOffset = offset;
-    }
-    if (!rootNode.ownerDocument) {
-        throw new Error('No `ownerDocument` found for rootNode');
-    }
-    const result = rootNode.ownerDocument.createRange();
-    result.setStart(startNode, startOffset);
-    result.setEnd(endNode, endOffset);
-    return result;
-}
-/**
- * Appends the list of `styles` as individual `<style>` elements to the
- * given `node`.
- *
- * @param node the `Node` to append the `<style>` elements to.
- * @param styles an optional list of styles to append to the `node`.
- */
-export function appendStyle(node, ...styles) {
-    for (const cssText of styles) {
-        const style = (node.ownerDocument ?? document).createElement('style');
-        style.textContent = cssText;
-        node.appendChild(style);
-    }
-}

package/build/node_modules/chrome-devtools-frontend/front_end/core/protocol_client/NodeURL.js

@@ -1,31 +0,0 @@
-// Copyright 2018 The Chromium Authors
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-import * as Common from '../common/common.js';
-import * as Host from '../host/host.js';
-export class NodeURL {
-    static patch(object) {
-        process(object, '');
-        function process(object, path) {
-            if (object.url && NodeURL.isPlatformPath(object.url, Host.Platform.isWin())) {
-                // object.url can be of both types: RawPathString and UrlString
-                object.url = Common.ParsedURL.ParsedURL.rawPathToUrlString(object.url);
-            }
-            for (const entry of Object.entries(object)) {
-                const key = entry[0];
-                const value = entry[1];
-                const entryPath = path + '.' + key;
-                if (entryPath !== '.result.result.value' && value !== null && typeof value === 'object') {
-                    process(value, entryPath);
-                }
-            }
-        }
-    }
-    static isPlatformPath(fileSystemPath, isWindows) {
-        if (isWindows) {
-            const re = /^([a-z]:[\/\\]|\\\\)/i;
-            return re.test(fileSystemPath);
-        }
-        return fileSystemPath.length ? fileSystemPath[0] === '/' : false;
-    }
-}