@mehmoodqureshi/chrome-mcp 0.9.0 → 0.9.1

package/README.md

@@ -126,8 +126,8 @@ npx -y @mehmoodqureshi/chrome-mcp --extension-path
 
 Then `chrome://extensions` → enable **Developer mode** → **Load unpacked** →
 pick `chrome-mcp-extension` in your home folder. After upgrading the package the
-server refreshes the files on its next boot; click **Reload** on
-`chrome://extensions` to pick them up. `CHROME_MCP_EXTENSION_DIR` moves the
+server refreshes the files on its next boot and the extension reloads itself
+within 30 seconds; nothing to click. `CHROME_MCP_EXTENSION_DIR` moves the
 folder somewhere else. (Working from a git clone instead? Run
 `npm install && npm run build:ext` first — `extension-dist/` is gitignored, and
 the server mirrors it to the same home folder.)
@@ -142,7 +142,7 @@ run? It re-checks every 30 seconds and pairs as soon as the file appears.
 **Where to see the badge:** it sits on the extension's icon in Chrome's
 toolbar, not on the `chrome://extensions` page. Chrome hides new extensions
 behind the puzzle-piece button at the right of the address bar, so click that,
-find **Chrome MCP Bridge**, and click the pin next to it once; the icon then
+find **MCP Extension for Chrome**, and click the pin next to it once; the icon then
 stays in the toolbar. Hover it for the status in words.
 
 | Badge | Meaning |

package/SETUP.md

@@ -47,8 +47,9 @@ It prints `~/chrome-mcp-extension` (on Windows `%USERPROFILE%\chrome-mcp-extensi
 Verify with `ls` (or `dir`) that the folder holds `manifest.json` and
 `background.js`. Record the path; the human needs it in step 4. The install is
 small and downloads no browser: the server drives the Chrome the human already
-has. The server refreshes this folder on every boot, so upgrades need no
-re-copy, only a Reload on `chrome://extensions`.
+has. The server refreshes this folder on every boot and the loaded extension
+reloads itself when the version changes, so upgrades need nothing from the
+human.
 
 ## Step 3 — Wire the server into this MCP client
 
@@ -107,7 +108,7 @@ You cannot do this step yourself. Give the human these exact instructions:
 2. Turn on **Developer mode** (top right).
 3. Click **Load unpacked** and choose the `chrome-mcp-extension` folder in
    their home directory (the path from step 2).
-4. Confirm an extension named **Chrome MCP Bridge** now appears in the list.
+4. Confirm an extension named **MCP Extension for Chrome** now appears in the list.
 
 Wait for the human to confirm before continuing.
 
@@ -137,7 +138,7 @@ new extensions behind the puzzle-piece button at the right of the address bar,
 so give them these exact steps:
 
 1. Click the puzzle-piece button at the right of the address bar.
-2. Find **Chrome MCP Bridge** in the list and click the pin icon next to it.
+2. Find **MCP Extension for Chrome** in the list and click the pin icon next to it.
    The extension icon now stays in the toolbar.
 3. Look at the small badge on that icon. Hovering it shows the status in words.
 
@@ -158,7 +159,7 @@ printing the token,
 node -e "console.log(require(require('os').homedir()+'/.chrome-mcp/handshake.json').port)"
 ```
 
-then have the human open **Details** on Chrome MCP Bridge, then **Extension
+then have the human open **Details** on MCP Extension for Chrome, then **Extension
 options**, enter that **Port**, open `~/.chrome-mcp/handshake.json` in a text
 editor and paste its `token` into the **Token** field, leave **Profile** as
 `default`, and click **Save**. The status line should read **connected** within

package/dist/src/cli.js

@@ -67,7 +67,7 @@ function installExtension() {
         (0, server_2.logErr)(`extension installed at ${r.dir} — chrome://extensions -> Load unpacked -> pick that folder`);
     }
     else if (r.copied.length > 0) {
-        (0, server_2.logErr)(`extension files updated at ${r.dir} — click Reload on chrome://extensions to pick up the new version`);
+        (0, server_2.logErr)(`extension files updated at ${r.dir} — a loaded extension reloads itself within 30 s`);
     }
     return r.dir;
 }

package/extension-dist/background.js

@@ -1609,6 +1609,21 @@
     await chrome.storage.local.set({ wsPort: bundled.wsPort, token: bundled.token, pairingSource: "auto" });
     return true;
   }
+  async function reloadIfFilesChanged() {
+    try {
+      const res = await fetch(chrome.runtime.getURL("manifest.json"), { cache: "no-store" });
+      if (!res.ok) return;
+      const onDisk = await res.json();
+      const loaded = chrome.runtime.getManifest().version;
+      if (typeof onDisk.version !== "string" || onDisk.version === loaded) return;
+      const { reloadedFor } = await chrome.storage.local.get("reloadedFor");
+      if (reloadedFor === onDisk.version) return;
+      await chrome.storage.local.set({ reloadedFor: onDisk.version });
+      console.info(`[chrome-mcp] extension files updated on disk (${loaded} -> ${onDisk.version}); reloading`);
+      chrome.runtime.reload();
+    } catch {
+    }
+  }
   async function getConfig() {
     const { wsPort, token, profile } = await chrome.storage.local.get(["wsPort", "token", "profile"]);
     if (typeof wsPort === "number" && wsPort > 0 && typeof token === "string" && token.length > 0) {
@@ -1618,10 +1633,10 @@
     return null;
   }
   var BADGE = {
-    connected: { text: "\u25CF", color: "#16a34a", title: "Chrome MCP \u2014 connected" },
-    connecting: { text: "\u2026", color: "#ca8a04", title: "Chrome MCP \u2014 connecting" },
-    unauthorized: { text: "!", color: "#dc2626", title: "Chrome MCP \u2014 rejected (bad/stale token; re-pair)" },
-    idle: { text: "\u25CB", color: "#6b7280", title: "Chrome MCP \u2014 not connected (open options to pair)" }
+    connected: { text: "\u25CF", color: "#16a34a", title: "MCP Extension for Chrome \u2014 connected" },
+    connecting: { text: "\u2026", color: "#ca8a04", title: "MCP Extension for Chrome \u2014 connecting" },
+    unauthorized: { text: "!", color: "#dc2626", title: "MCP Extension for Chrome \u2014 rejected (bad/stale token; re-pair)" },
+    idle: { text: "\u25CB", color: "#6b7280", title: "MCP Extension for Chrome \u2014 not connected (open options to pair)" }
   };
   function reflectBadge(state) {
     const b = BADGE[state] ?? BADGE.idle;
@@ -1644,6 +1659,7 @@
   }
   async function keepalivePulse() {
     await chrome.storage.local.get("connState");
+    await reloadIfFilesChanged();
     if (!ws.isConnected() && !await getConfig()) await adoptBundledPairing();
     await ensureConnected();
   }
@@ -1668,6 +1684,7 @@
   });
   async function bootstrap() {
     await chrome.alarms.create(KEEPALIVE_ALARM, { periodInMinutes: 0.5 });
+    await reloadIfFilesChanged();
     if (!await adoptBundledPairing()) await ensureConnected();
   }
   void bootstrap();

package/extension-dist/manifest.json

@@ -1,9 +1,16 @@
 {
   "manifest_version": 3,
-  "name": "Chrome MCP Bridge",
-  "version": "0.9.0",
+  "name": "MCP Extension for Chrome",
+  "version": "0.9.1",
   "description": "Lets a local chrome-mcp server drive this browser. Pair it with the server's handshake token.",
+  "homepage_url": "https://github.com/Mehmoodqureshi/chrome-mcp",
   "minimum_chrome_version": "116",
+  "icons": {
+    "16": "icon16.png",
+    "32": "icon32.png",
+    "48": "icon48.png",
+    "128": "icon128.png"
+  },
   "background": {
     "service_worker": "background.js"
   },
@@ -22,6 +29,12 @@
   ],
   "options_page": "options.html",
   "action": {
-    "default_title": "Chrome MCP — open options to pair"
+    "default_title": "MCP Extension for Chrome — open options to pair",
+    "default_icon": {
+      "16": "icon16.png",
+      "32": "icon32.png",
+      "48": "icon48.png",
+      "128": "icon128.png"
+    }
   }
 }

package/extension-dist/options.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8" />
-    <title>Chrome MCP — Pairing</title>
+    <title>MCP Extension for Chrome — Pairing</title>
     <style>
       body { font: 14px/1.5 system-ui, sans-serif; max-width: 32rem; margin: 2rem auto; padding: 0 1rem; }
       h1 { font-size: 1.2rem; }

package/extension-dist/options.js

@@ -17,7 +17,7 @@
       "connState",
       "pairingSource"
     ]);
-    sourceEl.textContent = pairingSource === "auto" ? "Paired automatically from the pairing.json the server wrote into this extension folder. Saving here overrides it." : pairingSource === "manual" ? "Paired by hand. Saved values take precedence over the bundled pairing.json." : "Not paired yet. If you loaded this extension from the chrome-mcp package folder, start the server once and it pairs itself; otherwise paste the values below.";
+    sourceEl.textContent = pairingSource === "auto" ? "Paired automatically from the pairing.json the server wrote into this extension folder. Saving here overrides it." : pairingSource === "manual" ? "Paired by hand. Saved values take precedence over the bundled pairing.json." : typeof wsPort === "number" && wsPort > 0 && connState !== "idle" ? "Paired with values saved by an earlier version. Saving here keeps them manual." : "Not paired yet. If you loaded this extension from the chrome-mcp package folder, start the server once and it pairs itself; otherwise paste the values below.";
     portEl.value = typeof wsPort === "number" && wsPort > 0 ? String(wsPort) : String(DEFAULT_WS_PORT);
     profileEl.value = typeof profile === "string" ? profile : "";
     render(typeof connState === "string" ? connState : "idle");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mehmoodqureshi/chrome-mcp",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Drive your real Chrome browser over MCP — real logins, real cookies. A stdio MCP server (CLI) plus an MV3 extension, driving Chrome via chrome.scripting/chrome.tabs. Multi-tab batch automation, accessibility snapshots, deny-all security by default.",
   "author": "Mehmood Ur Rehman Qureshi",
   "license": "MIT",
@@ -51,6 +51,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "build:ext": "node extension/scripts/build-ext.mjs",
+    "pack:ext": "npm run build:ext && rm -f chrome-mcp-extension-$npm_package_version.zip && cd extension-dist && zip -q -r ../chrome-mcp-extension-$npm_package_version.zip . -x pairing.json '.*' && cd .. && ls -la chrome-mcp-extension-$npm_package_version.zip",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:ext": "tsc -p tsconfig.ext.json",
     "clean": "rimraf dist extension-dist",