browser-lens-mcp 2.3.0 → 3.0.0

package/README.md

@@ -180,6 +180,23 @@ claude mcp add browser-lens npx -y browser-lens-mcp@latest
 
 ### Step 2 — Connect your browser
 
+**Option A: Chrome Extension** (recommended — persists across page reloads)
+
+```bash
+# Find the extension folder
+ls node_modules/browser-lens-mcp/extension/
+```
+
+1. Open `chrome://extensions` in Chrome/Edge
+2. Enable **Developer Mode** (top right)
+3. Click **Load unpacked**
+4. Select `node_modules/browser-lens-mcp/extension/`
+5. Done — auto-connects on every page load, survives reload!
+
+Configure ports via the extension popup icon.
+
+**Option B: Bookmarklet** (zero install, one-time per page)
+
 1. Open **http://localhost:3202** (or your custom port)
 2. Drag the **bookmarklet** to your bookmarks bar
 3. Navigate to any web app → click the bookmarklet

package/dist/src/transport/connector-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector-script.d.ts","sourceRoot":"","sources":["../../../src/transport/connector-script.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqa3E"}
+{"version":3,"file":"connector-script.d.ts","sourceRoot":"","sources":["../../../src/transport/connector-script.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsa3E"}

package/dist/src/transport/connector-script.js

@@ -277,9 +277,10 @@ function _renderScreenshot(target,type,selector){
 function _loadH2C(){
   return new Promise(function(resolve){
     if(typeof html2canvas==='function'){resolve(true);return;}
-    log('Loading html2canvas via eval (CSP-safe)...');
+    log('Loading html2canvas via fetch+eval (CSP-safe)...');
     fetch(HTTP_URL.replace('/ingest','/html2canvas.js')).then(function(r){return r.text();}).then(function(code){
-      (0,eval)(code);
+      new Function(code).call(window);
+      if(typeof html2canvas!=='function'&&window.html2canvas)html2canvas=window.html2canvas;
       log('html2canvas loaded: '+(typeof html2canvas==='function'));
       resolve(typeof html2canvas==='function');
     }).catch(function(e){err('html2canvas load failed',e);resolve(false);});

package/dist/src/transport/connector-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-script.js","sourceRoot":"","sources":["../../../src/transport/connector-script.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAc;IACjE,OAAO;;;+BAGsB,MAAM;mCACF,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+ZtC,CAAC;AACN,CAAC"}
+{"version":3,"file":"connector-script.js","sourceRoot":"","sources":["../../../src/transport/connector-script.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,MAAc;IACjE,OAAO;;;+BAGsB,MAAM;mCACF,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgatC,CAAC;AACN,CAAC"}

package/dist/src/transport/http-receiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-receiver.d.ts","sourceRoot":"","sources":["../../../src/transport/http-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAkL9D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC,MAAM,CA+Fb"}
+{"version":3,"file":"http-receiver.d.ts","sourceRoot":"","sources":["../../../src/transport/http-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAkL9D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAC,MAAM,CA0Hb"}

package/dist/src/transport/http-receiver.js

@@ -191,6 +191,34 @@ export function createHttpReceiver(store, port, wsPort) {
             res.end(getConnectorScript(port, effectiveWsPort));
             return;
         }
+        if (req.method === "GET" && url.pathname === "/extension") {
+            const extDir = path.resolve(__dirname, "..", "..", "..", "extension");
+            try {
+                const files = ["manifest.json", "background.js", "content.js", "popup.html", "popup.js"];
+                const iconFiles = ["icons/icon16.png", "icons/icon48.png", "icons/icon128.png"];
+                const allFiles = [...files, ...iconFiles];
+                const fileData = {};
+                for (const f of allFiles) {
+                    const fp = path.join(extDir, f);
+                    if (fs.existsSync(fp))
+                        fileData[f] = fs.readFileSync(fp);
+                }
+                res.writeHead(200, {
+                    ...CORS_HEADERS,
+                    "Content-Type": "application/json",
+                });
+                res.end(JSON.stringify({
+                    message: "Browser Lens Chrome Extension",
+                    install: "1) Go to chrome://extensions  2) Enable Developer Mode  3) Click 'Load unpacked'  4) Select the extension/ folder from the npm package",
+                    npmPath: "node_modules/browser-lens-mcp/extension/",
+                    files: Object.keys(fileData),
+                }));
+            }
+            catch {
+                jsonResponse(res, 500, { error: "Extension files not found" });
+            }
+            return;
+        }
         if (req.method === "GET" && url.pathname === "/html2canvas.js") {
             res.writeHead(200, {
                 ...CORS_HEADERS,

package/dist/src/transport/http-receiver.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-receiver.js","sourceRoot":"","sources":["../../../src/transport/http-receiver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-receiver.js","sourceRoot":"","sources":["../../../src/transport/http-receiver.ts"],"names":[],"mappings":"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"}

package/extension/background.js

@@ -0,0 +1,18 @@
+const DEFAULTS = { enabled: true, httpPort: 3202, wsPort: 3203 };
+
+chrome.runtime.onInstalled.addListener(() => {
+  chrome.storage.local.get(DEFAULTS, (cfg) => {
+    chrome.storage.local.set(cfg);
+  });
+});
+
+chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => {
+  if (msg.type === "getConfig") {
+    chrome.storage.local.get(DEFAULTS, (cfg) => sendResponse(cfg));
+    return true;
+  }
+  if (msg.type === "setConfig") {
+    chrome.storage.local.set(msg.config, () => sendResponse({ ok: true }));
+    return true;
+  }
+});

package/extension/content.js

@@ -0,0 +1,38 @@
+(function () {
+  if (window.__MCP_BROWSER_LENS_EXT__) return;
+  window.__MCP_BROWSER_LENS_EXT__ = true;
+
+  function inject(cfg) {
+    if (!cfg.enabled) return;
+    var httpPort = cfg.httpPort || 3202;
+
+    fetch("http://localhost:" + httpPort + "/connector.js")
+      .then(function (r) {
+        if (!r.ok) throw new Error("HTTP " + r.status);
+        return r.text();
+      })
+      .then(function (code) {
+        try {
+          new Function(code).call(window);
+          console.log("[BrowserLens Extension] Injected on " + location.hostname);
+        } catch (e) {
+          console.error("[BrowserLens Extension] Inject failed:", e);
+        }
+      })
+      .catch(function () {
+        console.log("[BrowserLens Extension] MCP server not running on port " + httpPort);
+      });
+  }
+
+  if (typeof chrome !== "undefined" && chrome.runtime && chrome.runtime.sendMessage) {
+    chrome.runtime.sendMessage({ type: "getConfig" }, function (cfg) {
+      if (chrome.runtime.lastError) {
+        inject({ enabled: true, httpPort: 3202, wsPort: 3203 });
+        return;
+      }
+      inject(cfg || { enabled: true, httpPort: 3202, wsPort: 3203 });
+    });
+  } else {
+    inject({ enabled: true, httpPort: 3202, wsPort: 3203 });
+  }
+})();

package/extension/icons/icon128.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#0e1628"/><circle cx="16" cy="16" r="10" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.4"/><circle cx="16" cy="16" r="6" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.6"/><circle cx="16" cy="16" r="2.5" fill="#06b6d4"/><path d="M22 22l3 3" stroke="#06b6d4" stroke-width="2" stroke-linecap="round"/></svg>

package/extension/icons/icon16.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#0e1628"/><circle cx="16" cy="16" r="10" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.4"/><circle cx="16" cy="16" r="6" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.6"/><circle cx="16" cy="16" r="2.5" fill="#06b6d4"/><path d="M22 22l3 3" stroke="#06b6d4" stroke-width="2" stroke-linecap="round"/></svg>

package/extension/icons/icon48.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#0e1628"/><circle cx="16" cy="16" r="10" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.4"/><circle cx="16" cy="16" r="6" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.6"/><circle cx="16" cy="16" r="2.5" fill="#06b6d4"/><path d="M22 22l3 3" stroke="#06b6d4" stroke-width="2" stroke-linecap="round"/></svg>

package/extension/manifest.json

@@ -0,0 +1,31 @@
+{
+  "manifest_version": 3,
+  "name": "Browser Lens — MCP UI Inspector",
+  "version": "2.3.1",
+  "description": "Real-time DOM, CSS, layout inspection for your IDE's AI agent. Connects to Browser Lens MCP server.",
+  "permissions": ["storage", "activeTab"],
+  "host_permissions": ["<all_urls>"],
+  "action": {
+    "default_popup": "popup.html",
+    "default_icon": {
+      "16": "icons/icon16.png",
+      "48": "icons/icon48.png",
+      "128": "icons/icon128.png"
+    }
+  },
+  "icons": {
+    "16": "icons/icon16.png",
+    "48": "icons/icon48.png",
+    "128": "icons/icon128.png"
+  },
+  "background": {
+    "service_worker": "background.js"
+  },
+  "content_scripts": [
+    {
+      "matches": ["<all_urls>"],
+      "js": ["content.js"],
+      "run_at": "document_idle"
+    }
+  ]
+}

package/extension/popup.html

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{width:280px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;background:#09090b;color:#fafafa;padding:16px}
+.header{display:flex;align-items:center;gap:8px;margin-bottom:16px}
+.header svg{flex-shrink:0}
+.header h1{font-size:15px;font-weight:700;background:linear-gradient(135deg,#8b5cf6,#06b6d4);-webkit-background-clip:text;-webkit-text-fill-color:transparent}
+.status{padding:10px 12px;border-radius:8px;font-size:12px;margin-bottom:12px;display:flex;align-items:center;gap:8px}
+.status.on{background:#052e16;border:1px solid #14532d;color:#22c55e}
+.status.off{background:#1c1917;border:1px solid #44403c;color:#f59e0b}
+.dot{width:8px;height:8px;border-radius:50%;flex-shrink:0}
+.dot.on{background:#22c55e}
+.dot.off{background:#f59e0b}
+.field{margin-bottom:10px}
+.field label{display:block;font-size:11px;color:#71717a;margin-bottom:4px;text-transform:uppercase;letter-spacing:.05em}
+.field input{width:100%;padding:8px 10px;background:#18181b;border:1px solid #27272a;border-radius:6px;color:#fafafa;font-size:13px;font-family:monospace}
+.field input:focus{outline:none;border-color:#8b5cf6}
+.toggle{display:flex;align-items:center;justify-content:space-between;padding:10px 12px;background:#18181b;border:1px solid #27272a;border-radius:8px;margin-bottom:12px;cursor:pointer}
+.toggle span{font-size:13px;font-weight:500}
+.switch{width:36px;height:20px;border-radius:10px;background:#27272a;position:relative;transition:background .2s}
+.switch.on{background:#8b5cf6}
+.switch::after{content:'';position:absolute;width:16px;height:16px;border-radius:50%;background:#fafafa;top:2px;left:2px;transition:transform .2s}
+.switch.on::after{transform:translateX(16px)}
+.btn{width:100%;padding:8px;background:#8b5cf6;color:#fff;border:none;border-radius:6px;font-size:13px;font-weight:600;cursor:pointer;margin-top:4px}
+.btn:hover{background:#7c3aed}
+.footer{margin-top:12px;text-align:center;font-size:10px;color:#52525b}
+.footer a{color:#8b5cf6;text-decoration:none}
+</style>
+</head>
+<body>
+<div class="header">
+<svg width="20" height="20" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#0e1628"/><circle cx="16" cy="16" r="6" stroke="#8b5cf6" stroke-width="1.5" fill="none" opacity="0.6"/><circle cx="16" cy="16" r="2.5" fill="#06b6d4"/><path d="M22 22l3 3" stroke="#06b6d4" stroke-width="2" stroke-linecap="round"/></svg>
+<h1>Browser Lens</h1>
+</div>
+<div id="status" class="status off"><span class="dot off"></span>Checking...</div>
+<div class="toggle" id="toggleBtn">
+<span>Auto-inject on page load</span>
+<div id="switchEl" class="switch on"></div>
+</div>
+<div class="field">
+<label>HTTP Port</label>
+<input id="httpPort" type="number" value="3202">
+</div>
+<div class="field">
+<label>WebSocket Port</label>
+<input id="wsPort" type="number" value="3203">
+</div>
+<button class="btn" id="saveBtn">Save & Reconnect</button>
+<div class="footer">
+<a href="https://github.com/nano-step/mcp-browser-lens" target="_blank">GitHub</a> · <a href="https://www.npmjs.com/package/browser-lens-mcp" target="_blank">npm</a>
+</div>
+<script src="popup.js"></script>
+</body>
+</html>

package/extension/popup.js

@@ -0,0 +1,54 @@
+const statusEl = document.getElementById("status");
+const switchEl = document.getElementById("switchEl");
+const toggleBtn = document.getElementById("toggleBtn");
+const httpPortEl = document.getElementById("httpPort");
+const wsPortEl = document.getElementById("wsPort");
+const saveBtn = document.getElementById("saveBtn");
+
+let config = { enabled: true, httpPort: 3202, wsPort: 3203 };
+
+function updateUI() {
+  switchEl.className = "switch " + (config.enabled ? "on" : "");
+  httpPortEl.value = config.httpPort;
+  wsPortEl.value = config.wsPort;
+  checkStatus();
+}
+
+function checkStatus() {
+  fetch("http://localhost:" + config.httpPort + "/health")
+    .then((r) => r.json())
+    .then((d) => {
+      const connected = d.hasDom || d.elements > 0;
+      statusEl.className = "status " + (connected ? "on" : "off");
+      statusEl.innerHTML =
+        '<span class="dot ' + (connected ? "on" : "off") + '"></span>' +
+        (connected
+          ? "Connected — " + d.elements + " elements"
+          : "Server running, no browser data yet");
+    })
+    .catch(() => {
+      statusEl.className = "status off";
+      statusEl.innerHTML = '<span class="dot off"></span>MCP server not running on port ' + config.httpPort;
+    });
+}
+
+toggleBtn.addEventListener("click", () => {
+  config.enabled = !config.enabled;
+  chrome.runtime.sendMessage({ type: "setConfig", config }, updateUI);
+});
+
+saveBtn.addEventListener("click", () => {
+  config.httpPort = parseInt(httpPortEl.value) || 3202;
+  config.wsPort = parseInt(wsPortEl.value) || 3203;
+  chrome.runtime.sendMessage({ type: "setConfig", config }, () => {
+    chrome.tabs.query({ active: true, currentWindow: true }, (tabs) => {
+      if (tabs[0]) chrome.tabs.reload(tabs[0].id);
+    });
+    updateUI();
+  });
+});
+
+chrome.runtime.sendMessage({ type: "getConfig" }, (cfg) => {
+  if (cfg) config = cfg;
+  updateUI();
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-lens-mcp",
-  "version": "2.3.0",
+  "version": "3.0.0",
   "description": "MCP server that connects to your browser for real-time DOM, CSS, layout inspection, screenshot capture, and Figma design comparison — your IDE's AI agent sees exactly what users see",
   "type": "module",
   "main": "dist/src/index.js",
@@ -63,6 +63,7 @@
   },
   "files": [
     "dist",
+    "extension",
     "README.md",
     "LICENSE"
   ],