mcpbrowser 0.3.28 → 0.3.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpbrowser",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "mcpName": "io.github.cherchyk/mcpbrowser",
   "type": "module",
   "description": "MCP browser server - fetch web pages using real Chrome/Edge/Brave browser. Handles authentication, SSO, CAPTCHAs, and anti-bot protection. Browser automation for AI assistants.",

package/src/browsers/ChromiumBrowser.js

@@ -9,8 +9,9 @@ import puppeteer from 'puppeteer-core';
 import { existsSync } from "fs";
 import os from "os";
 import path from "path";
-import { spawn } from "child_process";
+import { spawn, execSync } from "child_process";
 import logger from '../core/logger.js';
+import { isWSL, wslToWindowsPath, windowsPathToWSL } from '../utils.js';
 
 /**
  * Base class for all Chromium-based browsers
@@ -49,6 +50,18 @@ export class ChromiumBrowser extends BaseBrowser {
     const platform = os.platform();
     const home = os.homedir();
     
+    // In WSL the browser is a Windows process, so the user-data-dir
+    // must reside on a Windows-accessible filesystem (e.g. /mnt/c/…).
+    if (isWSL()) {
+      const windowsLocalAppData = this._getWindowsLocalAppData();
+      if (windowsLocalAppData) {
+        // windowsLocalAppData is already a WSL path like /mnt/c/Users/.../AppData/Local
+        return path.join(windowsLocalAppData, `MCPBrowser/${this.config.userDataDirName}`);
+      }
+      // Fallback: predictable location on C: drive
+      return `/mnt/c/MCPBrowserData/${this.config.userDataDirName}`;
+    }
+    
     if (platform === "win32") {
       return path.join(home, `AppData/Local/MCPBrowser/${this.config.userDataDirName}`);
     } else if (platform === "darwin") {
@@ -74,6 +87,37 @@ export class ChromiumBrowser extends BaseBrowser {
     }
   }
 
+  /**
+   * Resolve the Windows %LOCALAPPDATA% directory as a WSL path.
+   * Cached per-process. Returns null on failure.
+   * @returns {string|null} WSL-style path (e.g. /mnt/c/Users/.../AppData/Local)
+   * @private
+   */
+  _getWindowsLocalAppData() {
+    // Use a class-level cache so we only shell out once
+    if (ChromiumBrowser._wslLocalAppData !== undefined) {
+      return ChromiumBrowser._wslLocalAppData;
+    }
+
+    try {
+      const raw = execSync('cmd.exe /c echo %LOCALAPPDATA%', {
+        encoding: 'utf8',
+        timeout: 5000,
+        stdio: ['pipe', 'pipe', 'pipe'],
+      }).trim();
+
+      if (raw && !raw.includes('%LOCALAPPDATA%')) {
+        ChromiumBrowser._wslLocalAppData = windowsPathToWSL(raw);
+        return ChromiumBrowser._wslLocalAppData;
+      }
+    } catch {
+      // cmd.exe not available or timed out
+    }
+
+    ChromiumBrowser._wslLocalAppData = null;
+    return null;
+  }
+
   /**
    * Find the browser executable path
    * @returns {string|undefined}
@@ -109,14 +153,24 @@ export class ChromiumBrowser extends BaseBrowser {
       }
 
       const userDataDir = this.getDefaultUserDataDir();
+
+      // When running inside WSL the browser executable is a Windows process.
+      // It does not understand WSL paths (/mnt/c/…), so convert to a native
+      // Windows path for the --user-data-dir argument.
+      const userDataDirArg = isWSL() ? wslToWindowsPath(userDataDir) : userDataDir;
+
       const args = [
         `--remote-debugging-port=${this.config.port}`,
-        `--user-data-dir=${userDataDir}`,
+        `--user-data-dir=${userDataDirArg}`,
         '--no-first-run',
         '--no-default-browser-check'
       ];
 
       logger.info(`Launching ${this.config.name} with remote debugging on port ${this.config.port}...`);
+      if (isWSL()) {
+        logger.info(`WSL detected – launching Windows browser at ${execPath}`);
+        logger.info(`  user-data-dir (Windows): ${userDataDirArg}`);
+      }
       
       const child = spawn(execPath, args, {
         detached: true,
@@ -181,3 +235,6 @@ export class ChromiumBrowser extends BaseBrowser {
     this.browser = null;
   }
 }
+
+// Static cache for WSL %LOCALAPPDATA% lookup (undefined = not yet resolved)
+ChromiumBrowser._wslLocalAppData = undefined;

package/src/browsers/brave.js

@@ -5,9 +5,11 @@
 
 import { ChromiumBrowser } from './ChromiumBrowser.js';
 import os from "os";
+import { isWSL } from '../utils.js';
 
 /**
  * Get platform-specific default paths where Brave browser is typically installed.
+ * When running under WSL, Windows-side paths (via /mnt/c/) are also included.
  * @returns {string[]} Array of possible Brave executable paths for the current platform
  */
 function getDefaultBravePaths() {
@@ -24,13 +26,21 @@ function getDefaultBravePaths() {
       "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
     ];
   } else {
-    return [
+    const paths = [
       "/usr/bin/brave",
       "/usr/bin/brave-browser",
       "/usr/bin/brave-browser-stable",
       "/opt/brave.com/brave/brave-browser",
       "/snap/bin/brave",
     ];
+    // In WSL, also look for Windows-side Brave via /mnt/c/
+    if (isWSL()) {
+      paths.push(
+        "/mnt/c/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe",
+        "/mnt/c/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe",
+      );
+    }
+    return paths;
   }
 }
 

package/src/browsers/chrome.js

@@ -5,9 +5,11 @@
 
 import { ChromiumBrowser } from './ChromiumBrowser.js';
 import os from "os";
+import { isWSL } from '../utils.js';
 
 /**
  * Get platform-specific default paths where Chrome is typically installed.
+ * When running under WSL, Windows-side paths (via /mnt/c/) are also included.
  * @returns {string[]} Array of possible Chrome executable paths for the current platform
  */
 function getDefaultChromePaths() {
@@ -24,11 +26,19 @@ function getDefaultChromePaths() {
       "/Applications/Chromium.app/Contents/MacOS/Chromium",
     ];
   } else {
-    return [
+    const paths = [
       "/usr/bin/google-chrome",
       "/usr/bin/chromium-browser",
       "/usr/bin/chromium",
     ];
+    // In WSL, also look for Windows-side Chrome via /mnt/c/
+    if (isWSL()) {
+      paths.push(
+        "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe",
+        "/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe",
+      );
+    }
+    return paths;
   }
 }
 

package/src/browsers/edge.js

@@ -5,9 +5,11 @@
 
 import { ChromiumBrowser } from './ChromiumBrowser.js';
 import os from "os";
+import { isWSL } from '../utils.js';
 
 /**
  * Get platform-specific default paths where Edge browser is typically installed.
+ * When running under WSL, Windows-side paths (via /mnt/c/) are also included.
  * @returns {string[]} Array of possible Edge executable paths for the current platform
  */
 function getDefaultEdgePaths() {
@@ -23,13 +25,21 @@ function getDefaultEdgePaths() {
       "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
     ];
   } else {
-    return [
+    const paths = [
       "/usr/bin/microsoft-edge",
       "/usr/bin/microsoft-edge-stable",
       "/usr/bin/microsoft-edge-beta",
       "/usr/bin/microsoft-edge-dev",
       "/opt/microsoft/msedge/msedge",
     ];
+    // In WSL, also look for Windows-side Edge via /mnt/c/
+    if (isWSL()) {
+      paths.push(
+        "/mnt/c/Program Files/Microsoft/Edge/Application/msedge.exe",
+        "/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",
+      );
+    }
+    return paths;
   }
 }
 

package/src/utils.js

@@ -2,6 +2,65 @@
  * Utility functions for MCPBrowser
  */
 
+import { readFileSync } from 'fs';
+import os from 'os';
+
+// --- WSL Detection & Path Helpers ---
+
+let _isWSL = null;
+
+/**
+ * Detect if running inside Windows Subsystem for Linux (WSL).
+ * Result is cached after first call.
+ * @returns {boolean}
+ */
+export function isWSL() {
+  if (_isWSL === null) {
+    if (os.platform() !== 'linux') {
+      _isWSL = false;
+    } else {
+      try {
+        const version = readFileSync('/proc/version', 'utf8');
+        _isWSL = /microsoft|wsl/i.test(version);
+      } catch {
+        _isWSL = false;
+      }
+    }
+  }
+  return _isWSL;
+}
+
+/**
+ * Convert a WSL mount path to a Windows path.
+ * e.g. /mnt/c/Program Files/Google → C:\Program Files\Google
+ * Non-WSL paths are returned unchanged.
+ * @param {string} wslPath
+ * @returns {string}
+ */
+export function wslToWindowsPath(wslPath) {
+  const match = wslPath.match(/^\/mnt\/([a-zA-Z])\/(.*)/);
+  if (match) {
+    const drive = match[1].toUpperCase();
+    const rest = match[2].replace(/\//g, '\\');
+    return `${drive}:\\${rest}`;
+  }
+  return wslPath;
+}
+
+/**
+ * Convert a Windows path to a WSL mount path.
+ * e.g. C:\Users\foo → /mnt/c/Users/foo
+ * @param {string} windowsPath
+ * @returns {string}
+ */
+export function windowsPathToWSL(windowsPath) {
+  return windowsPath
+    .replace(/\\/g, '/')
+    .replace(/^([A-Za-z]):/, (_, d) => `/mnt/${d.toLowerCase()}`);
+}
+
+// --- General Utilities ---
+
 /**
  * Truncate a string to a maximum length, adding "... [truncated]" if truncated.
  * @param {string} str - The string to truncate