chrome-devtools-mcp-for-extension 0.6.2 → 0.6.4

package/build/src/browser.js

@@ -4,7 +4,6 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import fs from 'node:fs';
-import { promises as fsPromises } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import puppeteer from 'puppeteer-core';
@@ -43,6 +42,33 @@ async function ensureBrowserConnected(browserURL) {
     });
     return browser;
 }
+/**
+ * Get the last used Chrome profile directory name from Local State
+ */
+function getLastUsedProfile(userDataDir) {
+    const localStatePath = path.join(userDataDir, 'Local State');
+    try {
+        const localStateContent = fs.readFileSync(localStatePath, 'utf8');
+        const localState = JSON.parse(localStateContent);
+        return localState?.profile?.last_used || 'Default';
+    }
+    catch (error) {
+        console.warn(`Could not read Local State: ${error instanceof Error ? error.message : String(error)}`);
+        return 'Default';
+    }
+}
+/**
+ * Check if Chrome profile is already in use (locked)
+ * Throws an error if the profile is locked
+ */
+function assertProfileNotInUse(userDataDir) {
+    const lockFiles = ['SingletonLock', 'SingletonCookie', 'SingletonSocket'];
+    const hasLock = lockFiles.some(lockFile => fs.existsSync(path.join(userDataDir, lockFile)));
+    if (hasLock) {
+        throw new Error(`Chrome is already using this profile: ${userDataDir}\n` +
+            `Please close Chrome and try again.`);
+    }
+}
 function scanExtensionsDirectory(extensionsDir) {
     const extensionPaths = [];
     try {
@@ -234,6 +260,7 @@ export async function launch(options) {
         : 'chrome-profile';
     let userDataDir = options.userDataDir;
     let usingSystemProfile = false;
+    let profileDirectory = 'Default';
     if (!isolated && !userDataDir) {
         // Try to use system Chrome profile directly
         const systemProfile = detectSystemChromeProfile(channel) || detectAnySystemChromeProfile();
@@ -241,9 +268,13 @@ export async function launch(options) {
             // Use system profile directly for better user experience
             userDataDir = systemProfile.path;
             usingSystemProfile = true;
+            // Check if profile is already in use
+            assertProfileNotInUse(userDataDir);
+            // Detect last used profile directory
+            profileDirectory = getLastUsedProfile(userDataDir);
             console.error(`✅ Using system Chrome profile: ${systemProfile.channel}`);
             console.error(`   Path: ${userDataDir}`);
-            console.error(`   ⚠️  Note: Close regular Chrome if you encounter issues`);
+            console.error(`   Profile Directory: ${profileDirectory}`);
         }
         else {
             // Fallback to isolated profile if no system Chrome found
@@ -256,7 +287,7 @@ export async function launch(options) {
     }
     const args = [
         '--hide-crash-restore-bubble',
-        '--profile-directory=Default', // Ensure we use the Default profile
+        `--profile-directory=${profileDirectory}`,
     ];
     if (customDevTools) {
         args.push(`--custom-devtools-frontend=file://${customDevTools}`);
@@ -333,6 +364,7 @@ export async function launch(options) {
     console.error(`  Channel: ${puppeterChannel || 'default'}`);
     console.error(`  Executable: ${executablePath || 'auto-detected'}`);
     console.error(`  User Data Dir: ${userDataDir || 'temporary'}`);
+    console.error(`  Profile Directory: ${profileDirectory}`);
     console.error(`  Profile Type: ${usingSystemProfile ? 'System Profile (auto-detected)' : 'Custom Profile'}`);
     console.error(`  Headless: ${headless}`);
     console.error(`  Args: ${JSON.stringify(args, null, 2)}`);
@@ -349,6 +381,11 @@ export async function launch(options) {
             args,
             ignoreDefaultArgs: ['--disable-extensions', '--enable-automation'],
         });
+        // Log actual spawn args for debugging
+        const spawnArgs = browser.process()?.spawnargs;
+        if (spawnArgs) {
+            console.error(`Actual spawn args: ${spawnArgs.join(' ')}`);
+        }
         if (options.logFile) {
             // FIXME: we are probably subscribing too late to catch startup logs. We
             // should expose the process earlier or expose the getRecentLogs() getter.
@@ -424,55 +461,17 @@ export async function launch(options) {
         return browser;
     }
     catch (error) {
-        // When system profile is already in use, create a minimal copy for automation
-        if (usingSystemProfile &&
-            (error.message.includes('The browser is already running') ||
-                error.message.includes('Target closed') ||
-                error.message.includes('Connection closed'))) {
-            console.error(`⚠️  Chrome is already running with system profile.`);
-            console.error(`📋 Creating a temporary copy of system profile for automation...`);
-            // Create a temporary copy of the system profile
-            const tempProfileDir = path.join(os.tmpdir(), `chrome-mcp-${Date.now()}`);
-            try {
-                // Copy only essential data (bookmarks, extensions) without locking files
-                await fsPromises.mkdir(tempProfileDir, { recursive: true });
-                // Copy bookmarks if they exist
-                const bookmarksPath = path.join(userDataDir, 'Default', 'Bookmarks');
-                try {
-                    await fsPromises.access(bookmarksPath);
-                    const bookmarksDestDir = path.join(tempProfileDir, 'Default');
-                    await fsPromises.mkdir(bookmarksDestDir, { recursive: true });
-                    await fsPromises.copyFile(bookmarksPath, path.join(bookmarksDestDir, 'Bookmarks'));
-                    console.error(`✅ Bookmarks copied from system profile`);
-                }
-                catch {
-                    // Bookmarks don't exist or can't be accessed, skip
-                }
-                // Retry with the temporary profile by recursively calling launch
-                console.error(`🔄 Retrying with temporary profile copy...`);
-                const retryOptions = { ...options };
-                retryOptions.userDataDir = tempProfileDir;
-                return launch(retryOptions);
-            }
-            catch (copyError) {
-                console.error(`❌ Failed to create temporary profile copy: ${copyError}`);
-                // Fall through to regular error handling
-            }
-        }
-        // For non-system profiles, maintain the blocking behavior
-        if (!usingSystemProfile &&
-            userDataDir &&
-            (error.message.includes('The browser is already running') ||
-                error.message.includes('Target closed') ||
-                error.message.includes('Connection closed'))) {
-            throw new Error(`The browser is already running for custom profile: ${userDataDir}. Use --isolated to run multiple browser instances.`, {
-                cause: error,
-            });
-        }
-        // If system profile failed for other reasons, suggest fallback options
+        // Fail fast with clear error message - no silent fallback
+        console.error(`❌ Failed to launch Chrome`);
+        console.error(`   User Data Dir: ${userDataDir}`);
+        console.error(`   Profile Directory: ${profileDirectory}`);
+        console.error(`   Error: ${error instanceof Error ? error.message : String(error)}`);
         if (usingSystemProfile) {
-            console.error(`❌ Failed to launch Chrome with system profile: ${userDataDir}`);
-            console.error(`💡 Suggestion: Try with --isolated flag for temporary profile, or --userDataDir to specify custom location`);
+            console.error('');
+            console.error('💡 Troubleshooting:');
+            console.error('   1. Close all Chrome windows and try again');
+            console.error('   2. Use --isolated flag to use temporary profile');
+            console.error('   3. Use --userDataDir to specify custom profile location');
         }
         throw error;
     }

package/build/src/tools/bookmarks.js

@@ -110,63 +110,40 @@ function loadChromeBookmarks() {
     }
 }
 /**
- * Get all bookmarks: merged Chrome bookmarks with default fallback
+ * Get all bookmarks: returns only default development bookmarks for privacy
+ * User's personal Chrome bookmarks are not loaded to protect privacy
  */
 function getBookmarks() {
-    const defaultBookmarks = getDefaultBookmarks();
-    const chromeBookmarks = loadChromeBookmarks();
-    // Merge bookmarks: Chrome bookmarks take precedence, but defaults are always included
-    return {
-        ...defaultBookmarks,
-        ...chromeBookmarks
-    };
+    return getDefaultBookmarks();
 }
 export const listBookmarks = defineTool({
     name: 'list_bookmarks',
-    description: `List all available bookmarks including both Chrome bookmarks from the user's profile and default development bookmarks. Automatically loads bookmarks from Chrome's bookmark file and merges them with predefined development URLs.`,
+    description: `List all available bookmarks. Returns hardcoded development bookmarks only. User's personal Chrome bookmarks are not loaded to protect privacy.`,
     annotations: {
         category: ToolCategories.NAVIGATION_AUTOMATION,
         readOnlyHint: true,
     },
     schema: {},
     handler: async (_request, response, _context) => {
-        const defaultBookmarks = getDefaultBookmarks();
-        const chromeBookmarks = loadChromeBookmarks();
         const allBookmarks = getBookmarks();
         const bookmarkNames = Object.keys(allBookmarks);
         if (bookmarkNames.length === 0) {
             response.appendResponseLine('No bookmarks configured.');
-            response.appendResponseLine('');
-            response.appendResponseLine('💡 **Tip:** Chrome bookmarks could not be loaded. Check if Chrome is installed and has bookmarks.');
             return;
         }
-        response.appendResponseLine('📚 **Available Bookmarks:**');
-        response.appendResponseLine('');
-        // Show loading status
-        const chromeBookmarkCount = Object.keys(chromeBookmarks).length;
-        const defaultBookmarkCount = Object.keys(defaultBookmarks).length;
-        if (chromeBookmarkCount > 0) {
-            response.appendResponseLine(`✅ Loaded ${chromeBookmarkCount} bookmarks from Chrome profile${chromeBookmarkCount >= 100 ? ' (limited to 100)' : ''}`);
-            response.appendResponseLine(`📋 ${defaultBookmarkCount} default development bookmarks included`);
-        }
-        else {
-            response.appendResponseLine(`⚠️  Could not load Chrome bookmarks, using ${defaultBookmarkCount} default bookmarks`);
-        }
+        response.appendResponseLine('📚 **Available Development Bookmarks:**');
         response.appendResponseLine('');
         bookmarkNames.forEach(name => {
             const url = allBookmarks[name];
-            const source = chromeBookmarks[name] ? '🌐' : '🔧';
-            response.appendResponseLine(`${source} **${name}**: ${url}`);
+            response.appendResponseLine(`🔧 **${name}**: ${url}`);
         });
         response.appendResponseLine('');
-        response.appendResponseLine('**Legend:** 🌐 = Chrome bookmark, 🔧 = Default bookmark');
-        response.appendResponseLine('');
         response.appendResponseLine(`Use \`navigate_bookmark name="<bookmark_name>"\` to navigate to any of these URLs.`);
     },
 });
 export const navigateBookmark = defineTool({
     name: 'navigate_bookmark',
-    description: `Navigate to a bookmark URL from Chrome bookmarks or default development bookmarks. Automatically includes bookmarks from the user's Chrome profile merged with predefined development resources.`,
+    description: `Navigate to a bookmark URL from default development bookmarks. User's personal Chrome bookmarks are not loaded to protect privacy.`,
     annotations: {
         category: ToolCategories.NAVIGATION_AUTOMATION,
         readOnlyHint: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp-for-extension",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "MCP server for Chrome extension development with Web Store automation. Fork of chrome-devtools-mcp with extension-specific tools.",
   "type": "module",
   "bin": "./build/src/index.js",

package/build/src/tools/webstore-auto-screenshot.js

@@ -1,159 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fs from 'node:fs';
-import path from 'node:path';
-import z from 'zod';
-import { ToolCategories } from './categories.js';
-import { defineTool } from './ToolDefinition.js';
-// Tool for generating extension screenshots automatically
-export const generateExtensionScreenshots = defineTool({
-    name: 'generate_extension_screenshots',
-    description: `Automatically generate screenshots for Chrome Web Store submission`,
-    annotations: {
-        category: ToolCategories.EXTENSION_DEVELOPMENT,
-        readOnlyHint: false,
-    },
-    schema: {
-        extensionPath: z.string().describe('Path to the extension directory'),
-        extensionId: z.string().optional().describe('Extension ID if already installed'),
-    },
-    handler: async (request, response, context) => {
-        const { extensionPath, extensionId } = request.params;
-        const screenshotsDir = path.join(path.dirname(extensionPath), 'screenshots');
-        // Create screenshots directory
-        if (!fs.existsSync(screenshotsDir)) {
-            fs.mkdirSync(screenshotsDir, { recursive: true });
-        }
-        const page = context.getSelectedPage();
-        response.appendResponseLine('📸 **Generating Extension Screenshots**');
-        response.appendResponseLine('='.repeat(40));
-        response.appendResponseLine('');
-        try {
-            // Set viewport to Chrome Web Store recommended size
-            await page.setViewport({ width: 1280, height: 800 });
-            // Screenshot 1: Extension in action on a popular website
-            response.appendResponseLine('1️⃣ Taking screenshot of extension in action...');
-            // Navigate to a demo page
-            await page.goto('https://www.example.com', { waitUntil: 'networkidle0' });
-            // If extension has a popup, try to capture it
-            if (extensionId) {
-                // Open extension popup if possible
-                const extensionUrl = `chrome-extension://${extensionId}/popup.html`;
-                // Try to open popup in new tab for screenshot
-                const popupPage = await page.browser().newPage();
-                await popupPage.setViewport({ width: 1280, height: 800 });
-                try {
-                    await popupPage.goto(extensionUrl, { waitUntil: 'networkidle0' });
-                    // Take screenshot of popup
-                    const popupScreenshot = await popupPage.screenshot({
-                        type: 'png',
-                        fullPage: false,
-                    });
-                    const popupPath = path.join(screenshotsDir, 'screenshot-1-popup.png');
-                    fs.writeFileSync(popupPath, popupScreenshot);
-                    response.appendResponseLine(`✅ Popup screenshot saved: ${popupPath}`);
-                    await popupPage.close();
-                }
-                catch (error) {
-                    response.appendResponseLine(`⚠️ Could not capture popup: ${error}`);
-                }
-            }
-            // Screenshot 2: Extension toolbar icon
-            response.appendResponseLine('2️⃣ Taking screenshot with extension icon visible...');
-            // Navigate to chrome://extensions to show the extension
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            await new Promise(resolve => setTimeout(resolve, 1000));
-            const extensionsScreenshot = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const extensionsPath = path.join(screenshotsDir, 'screenshot-2-extensions.png');
-            fs.writeFileSync(extensionsPath, extensionsScreenshot);
-            response.appendResponseLine(`✅ Extensions page screenshot saved: ${extensionsPath}`);
-            // Screenshot 3: Options page (if exists)
-            response.appendResponseLine('3️⃣ Taking screenshot of options page...');
-            if (extensionId) {
-                const optionsUrl = `chrome-extension://${extensionId}/options.html`;
-                try {
-                    await page.goto(optionsUrl, { waitUntil: 'networkidle0' });
-                    const optionsScreenshot = await page.screenshot({
-                        type: 'png',
-                        fullPage: false,
-                    });
-                    const optionsPath = path.join(screenshotsDir, 'screenshot-3-options.png');
-                    fs.writeFileSync(optionsPath, optionsScreenshot);
-                    response.appendResponseLine(`✅ Options page screenshot saved: ${optionsPath}`);
-                }
-                catch (error) {
-                    response.appendResponseLine(`⚠️ No options page found`);
-                }
-            }
-            // Screenshot 4: Extension working on a real website
-            response.appendResponseLine('4️⃣ Taking screenshot on a real website...');
-            // Navigate to a website where the extension might be useful
-            await page.goto('https://www.google.com', { waitUntil: 'networkidle0' });
-            await new Promise(resolve => setTimeout(resolve, 2000));
-            const websiteScreenshot = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const websitePath = path.join(screenshotsDir, 'screenshot-4-website.png');
-            fs.writeFileSync(websitePath, websiteScreenshot);
-            response.appendResponseLine(`✅ Website screenshot saved: ${websitePath}`);
-            // Generate promotional images (smaller versions)
-            response.appendResponseLine('');
-            response.appendResponseLine('5️⃣ Generating promotional images...');
-            // Small promo tile: 440x280
-            await page.setViewport({ width: 440, height: 280 });
-            await page.goto('chrome://extensions/', { waitUntil: 'networkidle0' });
-            const smallPromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const smallPromoPath = path.join(screenshotsDir, 'promo-small-440x280.png');
-            fs.writeFileSync(smallPromoPath, smallPromo);
-            response.appendResponseLine(`✅ Small promo tile saved: ${smallPromoPath}`);
-            // Large promo tile: 920x680
-            await page.setViewport({ width: 920, height: 680 });
-            const largePromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const largePromoPath = path.join(screenshotsDir, 'promo-large-920x680.png');
-            fs.writeFileSync(largePromoPath, largePromo);
-            response.appendResponseLine(`✅ Large promo tile saved: ${largePromoPath}`);
-            // Marquee promo: 1400x560
-            await page.setViewport({ width: 1400, height: 560 });
-            const marqueePromo = await page.screenshot({
-                type: 'png',
-                fullPage: false,
-            });
-            const marqueePromoPath = path.join(screenshotsDir, 'promo-marquee-1400x560.png');
-            fs.writeFileSync(marqueePromoPath, marqueePromo);
-            response.appendResponseLine(`✅ Marquee promo saved: ${marqueePromoPath}`);
-            response.appendResponseLine('');
-            response.appendResponseLine('='.repeat(40));
-            response.appendResponseLine('✅ **Screenshots Generated Successfully!**');
-            response.appendResponseLine('');
-            response.appendResponseLine(`📁 Screenshots saved in: ${screenshotsDir}`);
-            response.appendResponseLine('');
-            response.appendResponseLine('**Chrome Web Store Requirements:**');
-            response.appendResponseLine('• Screenshots: 1280x800 or 640x400 (PNG or JPG)');
-            response.appendResponseLine('• Small promo tile: 440x280');
-            response.appendResponseLine('• Large promo tile: 920x680');
-            response.appendResponseLine('• Marquee promo: 1400x560');
-            response.appendResponseLine('');
-            response.appendResponseLine('💡 **Tip:** Edit these screenshots to highlight your extension features!');
-        }
-        catch (error) {
-            response.appendResponseLine(`❌ Error generating screenshots: ${error}`);
-        }
-        finally {
-            // Reset viewport
-            await page.setViewport({ width: 1280, height: 800 });
-        }
-    },
-});