chrome-devtools-mcp-for-extension 0.18.10 → 0.19.0

package/README.md

@@ -299,13 +299,17 @@ git push && git push --tags
 
 | Tool | Purpose | Example |
 |------|---------|---------|
-| `list_extensions` | View all extensions | "List my extensions" |
-| `reload_extension` | Hot-reload | "Reload my-extension" |
-| `inspect_service_worker` | Debug background | "Debug service worker" |
+| `open_extension_popup` | Select popup window | "Open my extension popup" |
+| `reload_iframe_extension` | Hot-reload via CDP | "Reload extension" |
+| `patch_iframe_popup` | Edit & reload | "Patch popup.html" |
 | `ask_chatgpt_web` | ChatGPT research | "Ask ChatGPT about..." |
 | `take_snapshot` | Page analysis | "Snapshot current page" |
 | `list_pages` | Browser tabs | "List open pages" |
 
+**Note:** Extension tools use CDP (Chrome DevTools Protocol) for reliable operation.
+Shadow DOM-based tools (`list_extensions`, `reload_extension`, etc.) were removed in v0.19.0
+due to Chrome security restrictions.
+
 **See also:** [Full Tool Documentation](docs/tools-reference.md)
 
 ---
@@ -315,7 +319,7 @@ git push && git push --tags
 ### Extension Not Loading
 
 ```
-"List extensions and show any errors"
+"Check extension popup for errors"
 ```
 
 **Common fixes:**

package/build/src/tools/extensions.js

@@ -8,444 +8,21 @@ import z from 'zod';
 import { ToolCategories } from './categories.js';
 import { defineTool } from './ToolDefinition.js';
 // ========================================
-// Essential User-Facing Tools (3 tools only)
+// Chrome Extension Development Tools
+// ========================================
+//
+// These tools use CDP (Chrome DevTools Protocol) and direct URL access
+// to interact with extensions. Tools that relied on chrome://extensions
+// Shadow DOM scraping have been removed as they are unreliable due to
+// Chrome's security restrictions.
+//
+// Working tools:
+// - openExtensionPopup: Uses page.goto('chrome-extension://ID/popup.html')
+// - closeExtensionPopup: URL validation only
+// - inspectIframePopup: CDP frame attachment
+// - patchIframePopup: File I/O + CDP reload
+// - reloadIframeExtension: CDP + chrome.runtime.reload()
 // ========================================
-export const listExtensions = defineTool({
-    name: 'list_extensions',
-    description: `List all installed Chrome extensions with their status, version, and ability to reload or debug them.`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: true,
-    },
-    schema: {},
-    handler: async (_request, response, context) => {
-        const page = context.getSelectedPage();
-        await context.waitForEventsAfterAction(async () => {
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const extensions = await page.evaluate(() => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                const results = [];
-                Array.from(extensionCards).forEach(card => {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() ||
-                            'Unknown';
-                        const description = shadowRoot.querySelector('#description')?.textContent?.trim() ||
-                            '';
-                        const version = shadowRoot.querySelector('#version')?.textContent?.trim() || '';
-                        let enableToggle = shadowRoot.querySelector('#enable-toggle');
-                        if (!enableToggle) {
-                            enableToggle = shadowRoot.querySelector('cr-toggle');
-                        }
-                        const enabled = enableToggle?.getAttribute('checked') === '';
-                        const id = card.getAttribute('id') || 'unknown';
-                        const errorsBadge = shadowRoot.querySelector('#errors-button .badge');
-                        const hasErrors = errorsBadge ? parseInt(errorsBadge.textContent?.trim() || '0') > 0 : false;
-                        results.push({
-                            id,
-                            name,
-                            enabled,
-                            version,
-                            description,
-                            hasErrors,
-                        });
-                    }
-                });
-                return results;
-            });
-            if (!extensions) {
-                response.appendResponseLine('❌ Failed to query extensions page');
-                return;
-            }
-            response.appendResponseLine('Installed Chrome Extensions:');
-            response.appendResponseLine('');
-            if (extensions.length === 0) {
-                response.appendResponseLine('No extensions found.');
-            }
-            else {
-                extensions.forEach((ext, index) => {
-                    response.appendResponseLine(`${index + 1}. **${ext.name}** v${ext.version}`);
-                    response.appendResponseLine(`   ID: ${ext.id}`);
-                    response.appendResponseLine(`   Status: ${ext.enabled ? '✅ Enabled' : '❌ Disabled'}${ext.hasErrors ? ' ⚠️ Has errors' : ''}`);
-                    if (ext.description) {
-                        response.appendResponseLine(`   ${ext.description}`);
-                    }
-                    response.appendResponseLine('');
-                });
-                response.appendResponseLine('💡 Use `reload_extension` to reload or `inspect_service_worker` to debug');
-            }
-        });
-    },
-});
-export const getExtensionInfo = defineTool({
-    name: 'get_extension_info',
-    description: `Get detailed information about a specific Chrome extension including its current state, version, and any errors.`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: true,
-    },
-    schema: {
-        extensionName: z
-            .string()
-            .describe('The name or partial name of the extension to get info about'),
-    },
-    handler: async (request, response, context) => {
-        const page = context.getSelectedPage();
-        const { extensionName } = request.params;
-        await context.waitForEventsAfterAction(async () => {
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const extensionInfo = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            const description = shadowRoot.querySelector('#description')?.textContent?.trim() ||
-                                '';
-                            const version = shadowRoot.querySelector('#version')?.textContent?.trim() || '';
-                            let enableToggle = shadowRoot.querySelector('#enable-toggle');
-                            if (!enableToggle) {
-                                enableToggle = shadowRoot.querySelector('cr-toggle');
-                            }
-                            const enabled = enableToggle?.getAttribute('checked') === '';
-                            const id = card.getAttribute('id') || 'unknown';
-                            const errorsBadge = shadowRoot.querySelector('#errors-button .badge');
-                            const hasErrors = errorsBadge
-                                ? parseInt(errorsBadge.textContent?.trim() || '0') > 0
-                                : false;
-                            // Get error details if available
-                            const errors = [];
-                            if (hasErrors) {
-                                const errorsButton = shadowRoot.querySelector('#errors-button');
-                                if (errorsButton) {
-                                    // Try to get error text from the errors section
-                                    const errorsList = shadowRoot.querySelectorAll('.error-list .error-message');
-                                    errorsList.forEach(err => {
-                                        const errorText = err.textContent?.trim();
-                                        if (errorText) {
-                                            errors.push(errorText);
-                                        }
-                                    });
-                                }
-                            }
-                            // Check if this is a development extension
-                            const detailsView = shadowRoot.querySelector('extensions-detail-view');
-                            const isDevelopment = detailsView ?
-                                detailsView.shadowRoot?.querySelector('#load-path')?.textContent?.trim() : undefined;
-                            return {
-                                found: true,
-                                id,
-                                name,
-                                version,
-                                description,
-                                enabled,
-                                hasErrors,
-                                errors,
-                                path: isDevelopment || 'Not a development extension',
-                            };
-                        }
-                    }
-                }
-                return { found: false };
-            }, extensionName);
-            if (!extensionInfo) {
-                response.appendResponseLine('❌ Failed to query extensions page');
-                return;
-            }
-            if (extensionInfo.found) {
-                response.appendResponseLine(`## Extension: ${extensionInfo.name}`);
-                response.appendResponseLine('');
-                response.appendResponseLine(`**ID:** ${extensionInfo.id}`);
-                response.appendResponseLine(`**Version:** ${extensionInfo.version}`);
-                response.appendResponseLine(`**Status:** ${extensionInfo.enabled ? '✅ Enabled' : '❌ Disabled'}`);
-                if (extensionInfo.description) {
-                    response.appendResponseLine(`**Description:** ${extensionInfo.description}`);
-                }
-                if (extensionInfo.path !== 'Not a development extension') {
-                    response.appendResponseLine(`**Path:** ${extensionInfo.path}`);
-                }
-                response.appendResponseLine('');
-                if (extensionInfo.hasErrors) {
-                    response.appendResponseLine('⚠️ **Errors:**');
-                    if (extensionInfo.errors.length > 0) {
-                        extensionInfo.errors.forEach(err => {
-                            response.appendResponseLine(`  - ${err}`);
-                        });
-                    }
-                    else {
-                        response.appendResponseLine('  Extension has errors (details not available)');
-                    }
-                }
-                else {
-                    response.appendResponseLine('✅ No errors detected');
-                }
-            }
-            else {
-                response.appendResponseLine(`❌ Extension not found: "${extensionName}"`);
-                response.appendResponseLine('');
-                response.appendResponseLine('💡 Use `list_extensions` to see all installed extensions');
-            }
-        });
-    },
-});
-export const reloadExtension = defineTool({
-    name: 'reload_extension',
-    description: `Reload a Chrome extension to apply changes during development. Checks extension state before and after reload.`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionName: z
-            .string()
-            .describe('The name or partial name of the extension to reload'),
-    },
-    handler: async (request, response, context) => {
-        const page = context.getSelectedPage();
-        const { extensionName } = request.params;
-        await context.waitForEventsAfterAction(async () => {
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            // Get extension info before reload
-            const beforeState = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            const version = shadowRoot.querySelector('#version')?.textContent?.trim() || '';
-                            let enableToggle = shadowRoot.querySelector('#enable-toggle');
-                            if (!enableToggle) {
-                                enableToggle = shadowRoot.querySelector('cr-toggle');
-                            }
-                            const enabled = enableToggle?.getAttribute('checked') === '';
-                            const id = card.getAttribute('id') || 'unknown';
-                            return {
-                                found: true,
-                                id,
-                                name,
-                                version,
-                                enabled,
-                            };
-                        }
-                    }
-                }
-                return { found: false };
-            }, extensionName);
-            if (!beforeState) {
-                response.appendResponseLine('❌ Failed to query extensions page');
-                return;
-            }
-            if (!beforeState.found) {
-                response.appendResponseLine(`❌ Extension not found: "${extensionName}"`);
-                return;
-            }
-            if (!beforeState.enabled) {
-                response.appendResponseLine(`⚠️ Warning: Extension "${beforeState.name}" is currently disabled`);
-            }
-            response.appendResponseLine(`🔄 Reloading: ${beforeState.name} v${beforeState.version}`);
-            // Perform reload
-            const reloadResult = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            // Try multiple selectors for reload button (dev-reload-button in developer mode)
-                            let reloadButton = shadowRoot.querySelector('#dev-reload-button');
-                            if (!reloadButton) {
-                                reloadButton = shadowRoot.querySelector('#reload-button');
-                            }
-                            if (!reloadButton) {
-                                // Try finding by aria-label (supports both English and Japanese)
-                                reloadButton = shadowRoot.querySelector('[aria-label*="再読み込み"]');
-                            }
-                            if (!reloadButton) {
-                                reloadButton = shadowRoot.querySelector('[aria-label*="Reload"]');
-                            }
-                            if (reloadButton && !reloadButton.hasAttribute('hidden')) {
-                                reloadButton.click();
-                                return { success: true };
-                            }
-                            else {
-                                return {
-                                    success: false,
-                                    reason: 'Reload button not available (extension not in developer mode or button hidden)',
-                                };
-                            }
-                        }
-                    }
-                }
-                return { success: false, reason: 'Extension not found' };
-            }, extensionName);
-            if (!reloadResult) {
-                response.appendResponseLine('❌ Failed to execute reload');
-                return;
-            }
-            if (!reloadResult.success) {
-                response.appendResponseLine(`❌ Failed: ${reloadResult.reason}`);
-                return;
-            }
-            // Wait for reload to complete
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            // Check for errors after reload
-            const afterState = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            const version = shadowRoot.querySelector('#version')?.textContent?.trim() || '';
-                            const errorsBadge = shadowRoot.querySelector('#errors-button .badge');
-                            const hasErrors = errorsBadge
-                                ? parseInt(errorsBadge.textContent?.trim() || '0') > 0
-                                : false;
-                            return {
-                                found: true,
-                                version,
-                                hasErrors,
-                            };
-                        }
-                    }
-                }
-                return { found: false, hasErrors: false };
-            }, extensionName);
-            if (!afterState) {
-                response.appendResponseLine('⚠️ Warning: Could not verify reload status');
-                return;
-            }
-            response.appendResponseLine('');
-            if (afterState.hasErrors) {
-                response.appendResponseLine(`⚠️ Extension reloaded but has errors (v${afterState.version})`);
-                response.appendResponseLine('💡 Use `get_extension_info` to see error details');
-            }
-            else {
-                response.appendResponseLine(`✅ Successfully reloaded: ${beforeState.name} v${afterState.version}`);
-            }
-        });
-    },
-});
-export const toggleExtensionState = defineTool({
-    name: 'toggle_extension_state',
-    description: `Safely enable or disable a Chrome extension. Always checks current state before toggling to prevent accidental changes.`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionName: z
-            .string()
-            .describe('The name or partial name of the extension'),
-        state: z
-            .enum(['enable', 'disable'])
-            .describe('Desired state: "enable" or "disable"'),
-    },
-    handler: async (request, response, context) => {
-        const page = context.getSelectedPage();
-        const { extensionName, state } = request.params;
-        const desiredEnabled = state === 'enable';
-        await context.waitForEventsAfterAction(async () => {
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const result = await page.evaluate((searchName, targetEnabled) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            // Try both selectors: #enable-toggle (older Chrome) and cr-toggle (newer Chrome)
-                            let enableToggle = shadowRoot.querySelector('#enable-toggle');
-                            if (!enableToggle) {
-                                enableToggle = shadowRoot.querySelector('cr-toggle');
-                            }
-                            const currentEnabled = enableToggle?.getAttribute('checked') === '';
-                            // Check if already in desired state
-                            if (currentEnabled === targetEnabled) {
-                                return {
-                                    success: true,
-                                    alreadyInState: true,
-                                    extensionName: name,
-                                    currentState: currentEnabled,
-                                };
-                            }
-                            // Toggle the state
-                            if (enableToggle) {
-                                enableToggle.click();
-                                return {
-                                    success: true,
-                                    alreadyInState: false,
-                                    extensionName: name,
-                                    previousState: currentEnabled,
-                                    newState: targetEnabled,
-                                };
-                            }
-                            else {
-                                return {
-                                    success: false,
-                                    reason: 'Enable/disable toggle not found (tried #enable-toggle and cr-toggle)',
-                                };
-                            }
-                        }
-                    }
-                }
-                return { success: false, reason: 'Extension not found' };
-            }, extensionName, desiredEnabled);
-            if (!result) {
-                response.appendResponseLine('❌ Failed to query extensions page');
-                return;
-            }
-            if (!result.success) {
-                response.appendResponseLine(`❌ Failed: ${result.reason}`);
-                return;
-            }
-            if (result.alreadyInState) {
-                response.appendResponseLine(`ℹ️ Extension "${result.extensionName}" is already ${result.currentState ? 'enabled' : 'disabled'}`);
-            }
-            else {
-                response.appendResponseLine(`✅ ${result.extensionName}: ${result.previousState ? 'Enabled' : 'Disabled'} → ${result.newState ? 'Enabled' : 'Disabled'}`);
-            }
-        });
-    },
-});
 export const openExtensionPopup = defineTool({
     name: 'open_extension_popup',
     description: `Select an already-opened Chrome extension popup window for testing. If no extension name is provided, it will automatically detect and select the currently active popup window. If an extension name is provided, it will search for that specific extension's popup. After selection, you can use take_snapshot, click, evaluate_script, etc. on the popup.`,
@@ -518,100 +95,38 @@ export const openExtensionPopup = defineTool({
                 response.appendResponseLine('💡 Please manually click the extension icon to open the popup first.');
                 return;
             }
-            // First, get extension ID
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const extensionInfo = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            const id = card.getAttribute('id') || '';
-                            return { found: true, id, name };
-                        }
-                    }
-                }
-                return { found: false };
-            }, extensionName);
-            if (!extensionInfo) {
-                response.appendResponseLine('❌ Failed to query extensions page');
-                return;
-            }
-            if (!extensionInfo.found) {
-                response.appendResponseLine(`❌ Extension not found: "${extensionName}"`);
-                return;
-            }
-            response.appendResponseLine(`🔍 Found extension: ${extensionInfo.name} (${extensionInfo.id})`);
-            try {
-                const browser = page.browser();
-                if (!browser) {
-                    response.appendResponseLine('❌ Failed to get browser instance.');
+            // If extensionName is provided, search for popup containing that name in URL
+            // This uses URL-based detection, not chrome://extensions Shadow DOM
+            response.appendResponseLine(`🔍 Searching for popup matching: "${extensionName}"`);
+            const pages = await browser.pages();
+            for (let i = 0; i < pages.length; i++) {
+                const p = pages[i];
+                const url = p.url();
+                if (url.startsWith('chrome-extension://') &&
+                    url.toLowerCase().includes(extensionName.toLowerCase())) {
+                    context.setSelectedPageIdx(i);
+                    response.appendResponseLine('✅ Found and selected matching popup window');
+                    response.appendResponseLine(`📄 Popup URL: ${url}`);
+                    response.appendResponseLine('');
+                    response.appendResponseLine('💡 You can now use take_snapshot, click, evaluate_script, etc. on the popup');
                     return;
                 }
-                response.appendResponseLine('🔧 Looking for open popup window...');
-                // Get all pages
-                const pages = await browser.pages();
-                // Find popup page by URL (contains extension ID)
-                let popupPage = null;
-                let popupIndex = -1;
-                for (let i = 0; i < pages.length; i++) {
-                    const p = pages[i];
-                    const url = p.url();
-                    if (url && url.includes(extensionInfo.id)) {
-                        popupPage = p;
-                        popupIndex = i;
-                        break;
-                    }
-                }
-                if (!popupPage) {
-                    // Check for iframe-embedded popup with this extension ID
-                    response.appendResponseLine('🔧 Checking for iframe-embedded popup...');
-                    // Go back to the original page to check for iframes
-                    await page.goBack();
-                    const iframePopups = await page.evaluate((extId) => {
-                        return Array.from(document.querySelectorAll('iframe'))
-                            .filter((iframe) => iframe.src.includes(extId))
-                            .map((iframe) => ({
-                            src: iframe.src,
-                            id: iframe.id,
-                            className: iframe.className,
-                        }));
-                    }, extensionInfo.id);
-                    if (iframePopups.length > 0) {
-                        response.appendResponseLine('');
-                        response.appendResponseLine(`✅ Extension popup found (embedded as iframe): ${extensionInfo.name}`);
-                        response.appendResponseLine(`📄 Popup URL: ${iframePopups[0].src}`);
-                        response.appendResponseLine('');
-                        response.appendResponseLine('💡 This popup is embedded in the current page as an iframe.');
-                        response.appendResponseLine('   You can interact with it using regular page tools:');
-                        response.appendResponseLine('   - take_snapshot (includes iframe content)');
-                        response.appendResponseLine('   - click on elements');
-                        response.appendResponseLine('   - fill forms');
-                        response.appendResponseLine('   - evaluate_script');
-                        return;
-                    }
-                    response.appendResponseLine('❌ Popup window not found.');
-                    response.appendResponseLine('💡 Please manually click the extension icon to open the popup first.');
+            }
+            // Check for any extension popup if exact match not found
+            for (let i = 0; i < pages.length; i++) {
+                const p = pages[i];
+                const url = p.url();
+                if (url.startsWith('chrome-extension://')) {
+                    context.setSelectedPageIdx(i);
+                    response.appendResponseLine(`⚠️ No popup matching "${extensionName}" found, but found another extension popup`);
+                    response.appendResponseLine(`📄 Popup URL: ${url}`);
+                    response.appendResponseLine('');
+                    response.appendResponseLine('💡 You can now use take_snapshot, click, evaluate_script, etc. on the popup');
                     return;
                 }
-                // Select the popup page
-                context.setSelectedPageIdx(popupIndex);
-                response.appendResponseLine('');
-                response.appendResponseLine(`✅ Popup window selected: ${extensionInfo.name}`);
-                response.appendResponseLine(`📄 Popup URL: ${popupPage.url()}`);
-                response.appendResponseLine('');
-                response.appendResponseLine('💡 You can now use take_snapshot, click, evaluate_script, etc. on the popup');
-            }
-            catch (error) {
-                response.appendResponseLine(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
             }
+            response.appendResponseLine(`❌ No extension popup found matching: "${extensionName}"`);
+            response.appendResponseLine('💡 Please manually click the extension icon to open the popup first.');
         });
     },
 });
@@ -640,78 +155,6 @@ export const closeExtensionPopup = defineTool({
         }
     },
 });
-export const inspectServiceWorker = defineTool({
-    name: 'inspect_service_worker',
-    description: `Open DevTools for an extension's service worker to debug background scripts.`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionName: z
-            .string()
-            .describe('The name or partial name of the extension to debug'),
-    },
-    handler: async (request, response, context) => {
-        const page = context.getSelectedPage();
-        const { extensionName } = request.params;
-        await context.waitForEventsAfterAction(async () => {
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const inspectResult = await page.evaluate((searchName) => {
-                const manager = document.querySelector('extensions-manager');
-                if (!manager?.shadowRoot)
-                    return null;
-                const itemList = manager.shadowRoot.querySelector('extensions-item-list');
-                if (!itemList?.shadowRoot)
-                    return null;
-                const extensionCards = itemList.shadowRoot.querySelectorAll('extensions-item');
-                for (const card of Array.from(extensionCards)) {
-                    const shadowRoot = card.shadowRoot;
-                    if (shadowRoot) {
-                        const name = shadowRoot.querySelector('#name')?.textContent?.trim() || '';
-                        if (name.toLowerCase().includes(searchName.toLowerCase())) {
-                            // Look for service worker link
-                            const serviceWorkerLink = shadowRoot.querySelector('a[href*="service_worker"]');
-                            if (serviceWorkerLink) {
-                                serviceWorkerLink.click();
-                                return {
-                                    success: true,
-                                    extensionName: name,
-                                    type: 'service_worker',
-                                };
-                            }
-                            // Look for background page link
-                            const backgroundLink = shadowRoot.querySelector('a[href*="background"]');
-                            if (backgroundLink) {
-                                backgroundLink.click();
-                                return {
-                                    success: true,
-                                    extensionName: name,
-                                    type: 'background_page',
-                                };
-                            }
-                            return {
-                                success: false,
-                                reason: 'No service worker or background page found',
-                            };
-                        }
-                    }
-                }
-                return { success: false, reason: 'Extension not found' };
-            }, extensionName);
-            if (!inspectResult) {
-                response.appendResponseLine('❌ Failed to find extension');
-                return;
-            }
-            if (inspectResult.success) {
-                response.appendResponseLine(`✅ Opened DevTools for ${inspectResult.type} of: ${inspectResult.extensionName}`);
-            }
-            else {
-                response.appendResponseLine(`❌ Failed: ${inspectResult.reason}`);
-            }
-        });
-    },
-});
 // Import iframe popup tools
 import * as iframePopupTools from './iframe-popup-tools.js';
 export const inspectIframePopup = defineTool({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp-for-extension",
-  "version": "0.18.10",
+  "version": "0.19.0",
   "description": "MCP server for Chrome extension development with Web Store automation. Fork of chrome-devtools-mcp with extension-specific tools.",
   "type": "module",
   "bin": "./scripts/cli.mjs",