chrome-devtools-mcp 0.18.0 → 0.18.1

package/build/src/McpContext.js

@@ -53,6 +53,7 @@ export class McpContext {
     // Auto-generated name counter for when no name is provided.
     #nextIsolatedContextId = 1;
     #pages = [];
+    #extensionServiceWorkers = [];
     #pageToDevToolsPage = new Map();
     #selectedPage;
     #textSnapshot = null;
@@ -66,6 +67,8 @@ export class McpContext {
     #dialog;
     #pageIdMap = new WeakMap();
     #nextPageId = 1;
+    #extensionServiceWorkerMap = new WeakMap();
+    #nextExtensionServiceWorkerId = 1;
     #nextSnapshotId = 1;
     #traceResults = [];
     #locatorClass;
@@ -94,6 +97,7 @@ export class McpContext {
     }
     async #init() {
         const pages = await this.createPagesSnapshot();
+        await this.createExtensionServiceWorkersSnapshot();
         await this.#networkCollector.init(pages);
         await this.#consoleCollector.init(pages);
         await this.#devtoolsUniverseManager.init(pages);
@@ -350,7 +354,7 @@ export class McpContext {
             throw new Error('No page selected');
         }
         if (page.isClosed()) {
-            throw new Error(`The selected page has been closed. Call ${listPages.name} to see open pages.`);
+            throw new Error(`The selected page has been closed. Call ${listPages().name} to see open pages.`);
         }
         return page;
     }
@@ -426,6 +430,29 @@ export class McpContext {
             });
         }
     }
+    /**
+     * Creates a snapshot of the extension service workers.
+     */
+    async createExtensionServiceWorkersSnapshot() {
+        const allTargets = await this.browser.targets();
+        const serviceWorkers = allTargets.filter(target => {
+            return (target.type() === 'service_worker' &&
+                target.url().includes('chrome-extension://'));
+        });
+        for (const serviceWorker of serviceWorkers) {
+            if (!this.#extensionServiceWorkerMap.has(serviceWorker)) {
+                this.#extensionServiceWorkerMap.set(serviceWorker, 'sw-' + this.#nextExtensionServiceWorkerId++);
+            }
+        }
+        this.#extensionServiceWorkers = serviceWorkers.map(serviceWorker => {
+            return {
+                target: serviceWorker,
+                id: this.#extensionServiceWorkerMap.get(serviceWorker),
+                url: serviceWorker.url(),
+            };
+        });
+        return this.#extensionServiceWorkers;
+    }
     async createPagesSnapshot() {
         const allPages = await this.#getAllPages();
         for (const page of allPages) {
@@ -502,6 +529,12 @@ export class McpContext {
             }
         }
     }
+    getExtensionServiceWorkers() {
+        return this.#extensionServiceWorkers;
+    }
+    getExtensionServiceWorkerId(extensionServiceWorker) {
+        return this.#extensionServiceWorkerMap.get(extensionServiceWorker.target);
+    }
     getPages() {
         return this.#pages;
     }

package/build/src/McpResponse.js

@@ -14,6 +14,7 @@ import { getInsightOutput, getTraceSummary } from './trace-processing/parse.js';
 import { paginate } from './utils/pagination.js';
 export class McpResponse {
     #includePages = false;
+    #includeExtensionServiceWorkers = false;
     #snapshotParams;
     #attachedNetworkRequestId;
     #attachedNetworkRequestOptions;
@@ -27,6 +28,10 @@ export class McpResponse {
     #listExtensions;
     #devToolsData;
     #tabId;
+    #args;
+    constructor(args) {
+        this.#args = args;
+    }
     attachDevToolsData(data) {
         this.#devToolsData = data;
     }
@@ -35,6 +40,9 @@ export class McpResponse {
     }
     setIncludePages(value) {
         this.#includePages = value;
+        if (this.#args.categoryExtensions) {
+            this.#includeExtensionServiceWorkers = value;
+        }
     }
     includeSnapshot(params) {
         this.#snapshotParams = params ?? {
@@ -142,6 +150,9 @@ export class McpResponse {
         if (this.#includePages) {
             await context.createPagesSnapshot();
         }
+        if (this.#includeExtensionServiceWorkers) {
+            await context.createExtensionServiceWorkersSnapshot();
+        }
         let snapshot;
         if (this.#snapshotParams) {
             await context.createTextSnapshot(this.#snapshotParams.verbose, this.#devToolsData);
@@ -345,6 +356,22 @@ Call ${handleDialog.name} to handle it before continuing.`);
                 return entry;
             });
         }
+        if (this.#includeExtensionServiceWorkers) {
+            if (!context.getExtensionServiceWorkers().length) {
+                response.push(`## Extension Service Workers`);
+            }
+            for (const extensionServiceWorker of context.getExtensionServiceWorkers()) {
+                response.push(`${extensionServiceWorker.id}: ${extensionServiceWorker.url}`);
+            }
+            structuredContent.extensionServiceWorkers = context
+                .getExtensionServiceWorkers()
+                .map(extensionServiceWorker => {
+                return {
+                    id: extensionServiceWorker.id,
+                    url: extensionServiceWorker.url,
+                };
+            });
+        }
         if (this.#tabId) {
             structuredContent.tabId = this.#tabId;
         }

package/build/src/main.js

@@ -148,7 +148,9 @@ function registerTool(tool) {
             const context = await getContext();
             logger(`${tool.name} context: resolved`);
             await context.detectOpenDevToolsWindows();
-            const response = args.slim ? new SlimMcpResponse() : new McpResponse();
+            const response = args.slim
+                ? new SlimMcpResponse(args)
+                : new McpResponse(args);
             await tool.handler({
                 params,
             }, response, context);

package/build/src/tools/memory.js

@@ -16,8 +16,7 @@ export const takeMemorySnapshot = defineTool({
     schema: {
         filePath: zod
             .string()
-            .describe('A path to a .heapsnapshot file to save the heapsnapshot to.')
-            .endsWith('.heapsnapshot'),
+            .describe('A path to a .heapsnapshot file to save the heapsnapshot to.'),
     },
     handler: async (request, response, context) => {
         const page = context.getSelectedPage();

package/build/src/tools/pages.js

@@ -7,17 +7,19 @@ import { logger } from '../logger.js';
 import { zod } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { CLOSE_PAGE_ERROR, defineTool, timeoutSchema } from './ToolDefinition.js';
-export const listPages = defineTool({
-    name: 'list_pages',
-    description: `Get a list of pages open in the browser.`,
-    annotations: {
-        category: ToolCategory.NAVIGATION,
-        readOnlyHint: true,
-    },
-    schema: {},
-    handler: async (_request, response) => {
-        response.setIncludePages(true);
-    },
+export const listPages = defineTool(args => {
+    return {
+        name: 'list_pages',
+        description: `Get a list of pages ${args?.categoryExtensions ? 'including extension service workers' : ''} open in the browser.`,
+        annotations: {
+            category: ToolCategory.NAVIGATION,
+            readOnlyHint: true,
+        },
+        schema: {},
+        handler: async (_request, response) => {
+            response.setIncludePages(true);
+        },
+    };
 });
 export const selectPage = defineTool({
     name: 'select_page',
@@ -29,7 +31,7 @@ export const selectPage = defineTool({
     schema: {
         pageId: zod
             .number()
-            .describe(`The ID of the page to select. Call ${listPages.name} to get available pages.`),
+            .describe(`The ID of the page to select. Call ${listPages().name} to get available pages.`),
         bringToFront: zod
             .boolean()
             .optional()
@@ -318,7 +320,7 @@ export const getTabId = defineTool({
     schema: {
         pageId: zod
             .number()
-            .describe(`The ID of the page to get the tab ID for. Call ${listPages.name} to get available pages.`),
+            .describe(`The ID of the page to get the tab ID for. Call ${listPages().name} to get available pages.`),
     },
     handler: async (request, response, context) => {
         const page = context.getPageById(request.params.pageId);

package/build/src/tools/tools.js

@@ -36,7 +36,6 @@ export const createTools = (args) => {
     const tools = [];
     for (const tool of rawTools) {
         if (typeof tool === 'function') {
-            // @ts-expect-error none of the tools for now implement the function type tool has type "never"
             tools.push(tool(args));
         }
         else {

package/build/src/version.js

@@ -5,5 +5,5 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.18.0';
+export const VERSION = '0.18.1';
 // x-release-please-end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": "./build/src/index.js",