chrome-devtools-mcp 0.22.0 → 0.24.0

package/build/src/index.js

@@ -12,11 +12,68 @@ import { Mutex } from './Mutex.js';
 import { SlimMcpResponse } from './SlimMcpResponse.js';
 import { ClearcutLogger } from './telemetry/ClearcutLogger.js';
 import { bucketizeLatency } from './telemetry/metricUtils.js';
-import { McpServer, SetLevelRequestSchema, } from './third_party/index.js';
-import { ToolCategory } from './tools/categories.js';
+import { McpServer, SetLevelRequestSchema, ListRootsResultSchema, RootsListChangedNotificationSchema, } from './third_party/index.js';
+import { labels, OFF_BY_DEFAULT_CATEGORIES } from './tools/categories.js';
 import { pageIdSchema } from './tools/ToolDefinition.js';
 import { createTools } from './tools/tools.js';
 import { VERSION } from './version.js';
+export function buildFlag(category) {
+    return `category${category.charAt(0).toUpperCase() + category.slice(1)}`;
+}
+function buildDisabledMessage(toolName, flag, categoryLabel) {
+    const reason = categoryLabel
+        ? `is in category ${categoryLabel} which`
+        : `requires experimental feature ${flag} and`;
+    return `Tool ${toolName} ${reason} is currently disabled. Enable it by running chrome-devtools start ${flag}=true. For more information check the README.`;
+}
+function getCategoryStatus(category, serverArgs) {
+    const categoryFlag = buildFlag(category);
+    const flagValue = serverArgs[categoryFlag];
+    const isDisabled = OFF_BY_DEFAULT_CATEGORIES.includes(category)
+        ? !flagValue
+        : flagValue === false;
+    if (isDisabled) {
+        return {
+            categoryFlag,
+            disabled: true,
+        };
+    }
+    return {
+        disabled: false,
+    };
+}
+function getConditionStatus(condition, serverArgs) {
+    if (condition && !serverArgs[condition]) {
+        return { conditionFlag: condition, disabled: true };
+    }
+    return { disabled: false };
+}
+function getToolStatusInfo(tool, serverArgs) {
+    const category = tool.annotations.category;
+    const categoryCheck = getCategoryStatus(category, serverArgs);
+    if (category && categoryCheck.disabled) {
+        if (!categoryCheck.categoryFlag) {
+            throw new Error('when the category is disabled there should always be a flag set');
+        }
+        return {
+            disabled: true,
+            reason: buildDisabledMessage(tool.name, `--${categoryCheck.categoryFlag}`, labels[category]),
+        };
+    }
+    for (const condition of tool.annotations.conditions || []) {
+        const conditionCheck = getConditionStatus(condition, serverArgs);
+        if (conditionCheck.disabled) {
+            if (!conditionCheck.conditionFlag) {
+                throw new Error('when the condition is disabled there should always be a flag set');
+            }
+            return {
+                disabled: true,
+                reason: buildDisabledMessage(tool.name, `--${conditionCheck.conditionFlag}`),
+            };
+        }
+    }
+    return { disabled: false };
+}
 export async function createMcpServer(serverArgs, options) {
     let clearcutLogger;
     if (serverArgs.usageStatistics) {
@@ -36,11 +93,29 @@ export async function createMcpServer(serverArgs, options) {
     server.server.setRequestHandler(SetLevelRequestSchema, () => {
         return {};
     });
+    const updateRoots = async () => {
+        if (!server.server.getClientCapabilities()?.roots) {
+            return;
+        }
+        try {
+            const roots = await server.server.request({ method: 'roots/list' }, ListRootsResultSchema);
+            context?.setRoots(roots.roots);
+        }
+        catch (e) {
+            logger('Failed to list roots', e);
+        }
+    };
     server.server.oninitialized = () => {
         const clientName = server.server.getClientVersion()?.name;
         if (clientName) {
             clearcutLogger?.setClientName(clientName);
         }
+        if (server.server.getClientCapabilities()?.roots) {
+            void updateRoots();
+            server.server.setNotificationHandler(RootsListChangedNotificationSchema, () => {
+                void updateRoots();
+            });
+        }
     };
     let context;
     async function getContext() {
@@ -83,49 +158,14 @@ export async function createMcpServer(serverArgs, options) {
                 experimentalIncludeAllPages: serverArgs.experimentalIncludeAllPages,
                 performanceCrux: serverArgs.performanceCrux,
             });
+            await updateRoots();
         }
         return context;
     }
     const toolMutex = new Mutex();
     function registerTool(tool) {
-        if (tool.annotations.category === ToolCategory.EMULATION &&
-            serverArgs.categoryEmulation === false) {
-            return;
-        }
-        if (tool.annotations.category === ToolCategory.PERFORMANCE &&
-            serverArgs.categoryPerformance === false) {
-            return;
-        }
-        if (tool.annotations.category === ToolCategory.NETWORK &&
-            serverArgs.categoryNetwork === false) {
-            return;
-        }
-        if (tool.annotations.category === ToolCategory.EXTENSIONS &&
-            serverArgs.categoryExtensions === false) {
-            return;
-        }
-        if (tool.annotations.category === ToolCategory.IN_PAGE &&
-            !serverArgs.categoryInPageTools) {
-            return;
-        }
-        if (tool.annotations.conditions?.includes('computerVision') &&
-            !serverArgs.experimentalVision) {
-            return;
-        }
-        if (tool.annotations.conditions?.includes('experimentalMemory') &&
-            !serverArgs.experimentalMemory) {
-            return;
-        }
-        if (tool.annotations.conditions?.includes('experimentalInteropTools') &&
-            !serverArgs.experimentalInteropTools) {
-            return;
-        }
-        if (tool.annotations.conditions?.includes('screencast') &&
-            !serverArgs.experimentalScreencast) {
-            return;
-        }
-        if (tool.annotations.conditions?.includes('experimentalWebmcp') &&
-            !serverArgs.experimentalWebmcp) {
+        const { disabled, reason: disabledReason } = getToolStatusInfo(tool, serverArgs);
+        if (disabled && !serverArgs.viaCli) {
             return;
         }
         const schema = 'pageScoped' in tool &&
@@ -139,6 +179,17 @@ export async function createMcpServer(serverArgs, options) {
             inputSchema: schema,
             annotations: tool.annotations,
         }, async (params) => {
+            if (disabledReason) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: disabledReason,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
             const guard = await toolMutex.acquire();
             const startTime = Date.now();
             let success = false;
@@ -151,29 +202,40 @@ export async function createMcpServer(serverArgs, options) {
                     ? new SlimMcpResponse(serverArgs)
                     : new McpResponse(serverArgs);
                 response.setRedactNetworkHeaders(serverArgs.redactNetworkHeaders);
-                if ('pageScoped' in tool && tool.pageScoped) {
+                try {
                     const page = serverArgs.experimentalPageIdRouting &&
                         params.pageId &&
                         !serverArgs.slim
                         ? context.getPageById(params.pageId)
                         : context.getSelectedMcpPage();
                     response.setPage(page);
-                    await tool.handler({
-                        params,
-                        page,
-                    }, response, context);
+                    if (tool.blockedByDialog) {
+                        page.throwIfDialogOpen();
+                    }
+                    if ('pageScoped' in tool && tool.pageScoped) {
+                        await tool.handler({
+                            params,
+                            page,
+                        }, response, context);
+                    }
+                    else {
+                        await tool.handler(
+                        // @ts-expect-error types do not match.
+                        {
+                            params,
+                        }, response, context);
+                    }
                 }
-                else {
-                    await tool.handler(
-                    // @ts-expect-error types do not match.
-                    {
-                        params,
-                    }, response, context);
+                catch (err) {
+                    response.setError(err);
                 }
                 const { content, structuredContent } = await response.handle(tool.name, context);
                 const result = {
                     content,
                 };
+                if (response.error) {
+                    result.isError = true;
+                }
                 success = true;
                 if (serverArgs.experimentalStructuredContent) {
                     result.structuredContent = structuredContent;
@@ -228,3 +290,4 @@ Google collects usage statistics to improve Chrome DevTools MCP. To opt-out, run
 For more details, visit: https://github.com/ChromeDevTools/chrome-devtools-mcp#usage-statistics`);
     }
 };
+//# sourceMappingURL=index.js.map

package/build/src/issue-descriptions.js

@@ -37,3 +37,4 @@ export const ISSUE_UTILS = {
     loadIssueDescriptions,
     getIssueDescription,
 };
+//# sourceMappingURL=issue-descriptions.js.map

package/build/src/logger.js

@@ -34,3 +34,4 @@ export function flushLogs(logFile, timeoutMs = 2000) {
     });
 }
 export const logger = debug(mcpDebugNamespace);
+//# sourceMappingURL=logger.js.map

package/build/src/polyfill.js

@@ -5,3 +5,4 @@
  */
 // polyfills are now bundled with all other dependencies
 import './third_party/index.js';
+//# sourceMappingURL=polyfill.js.map

package/build/src/telemetry/ClearcutLogger.js

@@ -64,9 +64,20 @@ export function transformArgType(zodType) {
             throw new Error(`Unsupported zod type for tool parameter: ${zodType}`);
     }
 }
+const BUCKETS = [
+    0, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, 2000, 5000, 10000,
+];
+function bucketize(value) {
+    for (const bucket of BUCKETS) {
+        if (bucket >= value) {
+            return bucket;
+        }
+    }
+    return BUCKETS[BUCKETS.length - 1];
+}
 function transformValue(zodType, value) {
     if (zodType === 'ZodString') {
-        return value.length;
+        return bucketize(value.length);
     }
     else if (zodType === 'ZodArray') {
         return value.length;
@@ -239,3 +250,4 @@ export class ClearcutLogger {
         return !isSameDay;
     }
 }
+//# sourceMappingURL=ClearcutLogger.js.map

package/build/src/telemetry/WatchdogClient.js

@@ -58,3 +58,4 @@ export class WatchdogClient {
         }
     }
 }
+//# sourceMappingURL=WatchdogClient.js.map

package/build/src/telemetry/flagUtils.js

@@ -85,3 +85,4 @@ export function getPossibleFlagMetrics(options) {
     }
     return metrics;
 }
+//# sourceMappingURL=flagUtils.js.map

package/build/src/telemetry/metricUtils.js

@@ -12,3 +12,4 @@ export function bucketizeLatency(latencyMs) {
     }
     return LATENCY_BUCKETS[LATENCY_BUCKETS.length - 1];
 }
+//# sourceMappingURL=metricUtils.js.map

package/build/src/telemetry/persistence.js

@@ -51,3 +51,4 @@ export class FilePersistence {
         }
     }
 }
+//# sourceMappingURL=persistence.js.map

package/build/src/telemetry/toolMetricsUtils.js

@@ -32,7 +32,7 @@ export function applyToExistingMetrics(existing, update) {
         return tool;
     });
 }
-function applyToExisting(existing, update) {
+export function applyToExisting(existing, update) {
     const existingNames = new Set(existing.map(item => item.name));
     const updatedNames = new Set(update.map(item => item.name));
     const result = [];
@@ -86,3 +86,4 @@ export function generateToolMetrics(tools) {
         };
     });
 }
+//# sourceMappingURL=toolMetricsUtils.js.map

package/build/src/telemetry/types.js

@@ -36,3 +36,4 @@ export var WatchdogMessageType;
 (function (WatchdogMessageType) {
     WatchdogMessageType["LOG_EVENT"] = "log-event";
 })(WatchdogMessageType || (WatchdogMessageType = {}));
+//# sourceMappingURL=types.js.map

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

@@ -202,3 +202,4 @@ export class ClearcutSender {
         return this.#buffer.length;
     }
 }
+//# sourceMappingURL=ClearcutSender.js.map

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

@@ -125,3 +125,4 @@ catch (err) {
     console.error('Watchdog fatal error:', err);
     process.exit(1);
 }
+//# sourceMappingURL=main.js.map

package/build/src/third_party/THIRD_PARTY_NOTICES

@@ -1,3 +1,30 @@
+Name: urlpattern-polyfill
+URL: https://github.com/kenchris/urlpattern-polyfill
+Version: 10.1.0
+License: MIT
+
+Copyright 2020 Intel Corporation
+
+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: core-js
 URL: https://core-js.io
 Version: 3.49.0
@@ -2525,7 +2552,7 @@ SOFTWARE.
 
 Name: axe-core
 URL: https://www.deque.com/axe/
-Version: 4.11.2
+Version: 4.11.4
 License: MPL-2.0
 
 Mozilla Public License, version 2.0
@@ -3961,7 +3988,7 @@ SOFTWARE.
 
 Name: puppeteer-core
 URL: https://github.com/puppeteer/puppeteer/tree/main/packages/puppeteer-core
-Version: 24.40.0
+Version: 24.42.0
 License: Apache-2.0
 
 -------------------- DEPENDENCY DIVIDER --------------------
@@ -4027,7 +4054,7 @@ SOFTWARE.
 
 Name: tldts-core
 URL: https://github.com/remusao/tldts#readme
-Version: 7.0.27
+Version: 7.0.29
 License: MIT
 
 Copyright (c) 2017 Thomas Parisot, 2018 Rémi Berson
@@ -4049,7 +4076,7 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTH
 
 Name: tldts-icann
 URL: https://github.com/remusao/tldts#readme
-Version: 7.0.27
+Version: 7.0.29
 License: MIT
 
 Copyright (c) 2017 Thomas Parisot, 2018 Rémi Berson
@@ -4091,7 +4118,7 @@ PERFORMANCE OF THIS SOFTWARE.
 
 Name: web-features
 URL: git+https://github.com/web-platform-dx/web-features.git
-Version: 3.21.0
+Version: 3.25.0
 License: Apache-2.0
 
                                  Apache License

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

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