mcp-browser-extension 0.9.25 → 0.9.26

package/dist/src/bridge/evict.js

@@ -1,10 +1,10 @@
 "use strict";
 /**
- * src/bridge/evict.ts — take a pinned port back from a stale chrome-mcp.
+ * src/bridge/evict.ts — take a pinned port back from a stale mcp-browser-extension.
  *
- * A second session normally JOINS the chrome-mcp holding the port as a peer
+ * A second session normally JOINS the mcp-browser-extension holding the port as a peer
  * (see ./peer) and nobody is stopped. This is the fallback for when joining
- * fails: an older chrome-mcp that can't share the port, or a hung one. It will
+ * fails: an older mcp-browser-extension that can't share the port, or a hung one. It will
  * never release the port on its own, so rather than fail with EADDRINUSE and
  * make the user kill it by hand, we do that for them.
  *
@@ -13,13 +13,13 @@
  *   - the handshake names that port (so it describes *this* listener), and
  *   - the pid is not us, and
  *   - the pid is alive, and
- *   - its command line mentions chrome-mcp.
+ *   - its command line mentions mcp-browser-extension.
  * If any check fails we leave the process alone and let the caller surface the
  * plain-English port-busy error instead. Refusing to evict is always safe; a
  * wrong kill is not.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.looksLikeChromeMcp = looksLikeChromeMcp;
+exports.looksLikeMcpBrowserExtension = looksLikeMcpBrowserExtension;
 exports.evictPortOwner = evictPortOwner;
 const node_child_process_1 = require("node:child_process");
 const auth_1 = require("./auth");
@@ -42,7 +42,7 @@ function isAlive(pid) {
  * Full command line of `pid`, or null if it can't be read.
  *
  * Windows needs PowerShell/CIM: `tasklist` reports only the image name
- * ("node.exe"), which can't distinguish chrome-mcp from any other Node process
+ * ("node.exe"), which can't distinguish mcp-browser-extension from any other Node process
  * — far too weak a signal to kill on.
  */
 function commandLine(pid) {
@@ -68,12 +68,12 @@ function commandLine(pid) {
         return null;
     }
 }
-/** Does this command line belong to a chrome-mcp server? */
-function looksLikeChromeMcp(cmdline) {
-    return /chrome-mcp/i.test(cmdline);
+/** Does this command line belong to a mcp-browser-extension server? */
+function looksLikeMcpBrowserExtension(cmdline) {
+    return /(?:mcp-browser-extension|chrome-mcp)/i.test(cmdline);
 }
 /**
- * Try to free `port` by terminating the chrome-mcp that owns it.
+ * Try to free `port` by terminating the mcp-browser-extension that owns it.
  * Returns true only if an owner was found, killed, and confirmed gone.
  */
 async function evictPortOwner(dataDir, port, log, deps = {}) {
@@ -100,12 +100,12 @@ async function evictPortOwner(dataDir, port, log, deps = {}) {
     if (!alive(pid))
         return false;
     const cmdline = cmdOf(pid);
-    if (!cmdline || !looksLikeChromeMcp(cmdline)) {
-        log(`port ${port} is held by pid ${pid}, which does not look like chrome-mcp — ` +
+    if (!cmdline || !looksLikeMcpBrowserExtension(cmdline)) {
+        log(`port ${port} is held by pid ${pid}, which does not look like mcp-browser-extension — ` +
             `leaving it alone. Stop it yourself, or use a different --port.`);
         return false;
     }
-    log(`port ${port} is held by chrome-mcp pid ${pid} (another session) — taking the port over`);
+    log(`port ${port} is held by mcp-browser-extension pid ${pid} (another session) — taking the port over`);
     try {
         kill(pid, 'SIGTERM');
     }

package/dist/src/bridge/peer.d.ts

@@ -1,10 +1,10 @@
 /**
- * src/bridge/peer.ts — let several chrome-mcp servers share one Chrome.
+ * src/bridge/peer.ts — let several mcp-browser-extension servers share one Chrome.
  *
- * Every MCP host session (each Claude terminal/tab) spawns its own chrome-mcp,
+ * Every MCP host session (each Claude terminal/tab) spawns its own mcp-browser-extension,
  * but a browser's extension dials exactly one port. So the first server to bind
  * the port is the HUB: it owns the extension connections. A later server that
- * finds the port held by a live chrome-mcp joins it as a PEER over the same
+ * finds the port held by a live mcp-browser-extension joins it as a PEER over the same
  * port and relays its commands through the hub, instead of killing it. If the
  * hub exits, its peers race to bind the port; the winner becomes the new hub
  * (with the same token, so the extension re-pairs on its own) and the rest join
@@ -93,7 +93,7 @@ export declare class HubLink {
     private constructor();
     /**
      * Join the hub on `port` with `token`. Resolves null when nothing answers as a
-     * chrome-mcp hub in time: a wrong token, an older server that doesn't speak
+     * mcp-browser-extension hub in time: a wrong token, an older server that doesn't speak
      * the peer protocol (it ignores the frame and times us out), or no listener.
      */
     static join(host: string, port: number, token: string, onClose: () => void, onGrant?: (host: string, allow: boolean) => void): Promise<HubLink | null>;

package/dist/src/bridge/peer.js

@@ -1,11 +1,11 @@
 "use strict";
 /**
- * src/bridge/peer.ts — let several chrome-mcp servers share one Chrome.
+ * src/bridge/peer.ts — let several mcp-browser-extension servers share one Chrome.
  *
- * Every MCP host session (each Claude terminal/tab) spawns its own chrome-mcp,
+ * Every MCP host session (each Claude terminal/tab) spawns its own mcp-browser-extension,
  * but a browser's extension dials exactly one port. So the first server to bind
  * the port is the HUB: it owns the extension connections. A later server that
- * finds the port held by a live chrome-mcp joins it as a PEER over the same
+ * finds the port held by a live mcp-browser-extension joins it as a PEER over the same
  * port and relays its commands through the hub, instead of killing it. If the
  * hub exits, its peers race to bind the port; the winner becomes the new hub
  * (with the same token, so the extension re-pairs on its own) and the rest join
@@ -64,7 +64,7 @@ class HubLink {
     }
     /**
      * Join the hub on `port` with `token`. Resolves null when nothing answers as a
-     * chrome-mcp hub in time: a wrong token, an older server that doesn't speak
+     * mcp-browser-extension hub in time: a wrong token, an older server that doesn't speak
      * the peer protocol (it ignores the frame and times us out), or no listener.
      */
     static join(host, port, token, onClose, onGrant) {

package/dist/src/bridge/server.d.ts

@@ -10,7 +10,7 @@
  *   3. On success, send `welcome` and file the connection under its profile
  *      (superseding only that profile's prior one — a security-relevant
  *      displacement event).
- * Other chrome-mcp servers (one per Claude session) may join the same port as
+ * Other mcp-browser-extension servers (one per Claude session) may join the same port as
  * peers with `peer_hello` and relay their commands through us; see ./peer.
  */
 import { type WireEvent, type WireMethod, type WirePolicy } from '../../shared/protocol';
@@ -65,7 +65,7 @@ export interface BridgeOptions {
     host?: string;
     heartbeatMs?: number;
     /** Data dir holding the handshake. Enables reclaiming a pinned port from a
-     *  stale chrome-mcp (see ./evict). Omit to disable eviction entirely. */
+     *  stale mcp-browser-extension (see ./evict). Omit to disable eviction entirely. */
     dataDir?: string;
     /** Diagnostics — MUST never receive the token (a test asserts this). */
     onLog?: (message: string) => void;
@@ -74,7 +74,7 @@ export interface BridgeOptions {
     /**
      * Called whenever this server takes a role on the port: 'hub' when it binds
      * it (publish the handshake + pairing files then), 'peer' when it joins the
-     * chrome-mcp already holding it. Fires again after a failover.
+     * mcp-browser-extension already holding it. Fires again after a failover.
      */
     onRole?: (role: BridgeRole, info: {
         port: number;
@@ -103,7 +103,7 @@ export declare class BridgeServer {
     private token;
     /** Peer role: the link to the hub that owns the browsers. */
     private hub;
-    /** Hub role: the other chrome-mcp servers relaying through us. */
+    /** Hub role: the other mcp-browser-extension servers relaying through us. */
     private readonly peers;
     private stopped;
     /** The last extension hello this hub turned away, for telling a stale token
@@ -133,12 +133,12 @@ export declare class BridgeServer {
     get role(): BridgeRole | null;
     /**
      * Bind and start listening, or — when a pinned port is held by another live
-     * chrome-mcp — join it as a peer. Returns the port (useful with port 0).
+     * mcp-browser-extension — join it as a peer. Returns the port (useful with port 0).
      */
     start(): Promise<number>;
     private claim;
     /**
-     * Join the chrome-mcp holding `port` as a peer. Tries the token in the
+     * Join the mcp-browser-extension holding `port` as a peer. Tries the token in the
      * handshake it published first (sessions without --persist-token each mint
      * their own), then ours.
      */

package/dist/src/bridge/server.js

@@ -11,7 +11,7 @@
  *   3. On success, send `welcome` and file the connection under its profile
  *      (superseding only that profile's prior one — a security-relevant
  *      displacement event).
- * Other chrome-mcp servers (one per Claude session) may join the same port as
+ * Other mcp-browser-extension servers (one per Claude session) may join the same port as
  * peers with `peer_hello` and relay their commands through us; see ./peer.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -105,7 +105,7 @@ class BridgeServer {
     token;
     /** Peer role: the link to the hub that owns the browsers. */
     hub = null;
-    /** Hub role: the other chrome-mcp servers relaying through us. */
+    /** Hub role: the other mcp-browser-extension servers relaying through us. */
     peers = new Set();
     stopped = false;
     /** The last extension hello this hub turned away, for telling a stale token
@@ -171,7 +171,7 @@ class BridgeServer {
     }
     /**
      * Bind and start listening, or — when a pinned port is held by another live
-     * chrome-mcp — join it as a peer. Returns the port (useful with port 0).
+     * mcp-browser-extension — join it as a peer. Returns the port (useful with port 0).
      */
     async start() {
         if (this.wss || this.hub)
@@ -205,16 +205,16 @@ class BridgeServer {
                 const inUse = err?.code === 'EADDRINUSE';
                 if (!inUse || port === 0)
                     throw inUse ? new Error(portBusyMessage(host, port)) : err;
-                // Another Claude session's chrome-mcp owns the port: share it rather
+                // Another Claude session's mcp-browser-extension owns the port: share it rather
                 // than kill it, so every session keeps working at once.
                 if (!triedJoin) {
                     triedJoin = true;
                     if (await this.joinHub(host, port))
                         return this.boundPort;
                 }
-                // Still busy after a failed join: an older chrome-mcp that can't share,
+                // Still busy after a failed join: an older mcp-browser-extension that can't share,
                 // or a hung one. It will never release the port on its own, so take it
-                // over (once). Only a verified chrome-mcp is ever killed; anything else
+                // over (once). Only a verified mcp-browser-extension is ever killed; anything else
                 // falls through to the wait-and-retry below.
                 if (!evicted && this.opts.dataDir) {
                     evicted = true;
@@ -231,7 +231,7 @@ class BridgeServer {
         }
     }
     /**
-     * Join the chrome-mcp holding `port` as a peer. Tries the token in the
+     * Join the mcp-browser-extension holding `port` as a peer. Tries the token in the
      * handshake it published first (sessions without --persist-token each mint
      * their own), then ours.
      */
@@ -252,7 +252,7 @@ class BridgeServer {
             this.hub = link;
             this.token = token;
             this.boundPort = port;
-            this.log(`port ${host}:${port} is held by chrome-mcp pid ${link.hubPid || '?'} — sharing its browsers as a peer`);
+            this.log(`port ${host}:${port} is held by mcp-browser-extension pid ${link.hubPid || '?'} — sharing its browsers as a peer`);
             this.opts.onRole?.('peer', { port, token, hubPid: link.hubPid });
             return true;
         }
@@ -275,7 +275,7 @@ class BridgeServer {
         this.hub = null;
         if (this.stopped)
             return;
-        this.log('the chrome-mcp sharing its browsers with us went away — taking over the port');
+        this.log('the mcp-browser-extension sharing its browsers with us went away — taking over the port');
         void this.failover();
     }
     async failover() {
@@ -565,7 +565,7 @@ class BridgeServer {
                 return;
             }
             if (frame.type === 'peer_hello') {
-                // Another chrome-mcp (a second Claude session) joining to share our browsers.
+                // Another mcp-browser-extension (a second Claude session) joining to share our browsers.
                 const peer = frame;
                 clearTimeout(helloTimer);
                 if (peer.v !== protocol_1.PROTOCOL_VERSION)
@@ -632,7 +632,7 @@ class BridgeServer {
     /** Hub side: serve a joined peer's relayed commands against our browsers. */
     acceptPeer(ws, pid) {
         this.peers.add(ws);
-        this.log(`chrome-mcp pid ${pid ?? '?'} joined as a peer (${this.peers.size} sharing these browsers)`);
+        this.log(`mcp-browser-extension pid ${pid ?? '?'} joined as a peer (${this.peers.size} sharing these browsers)`);
         this.sendPeer(ws, { type: 'peer_welcome', hubPid: process.pid });
         this.sendPeer(ws, { type: 'peer_state', profiles: this.pairedProfiles() });
         ws.on('message', (raw) => this.handlePeerFrame(ws, raw.toString()));

package/dist/src/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * src/cli.ts — `npx chrome-mcp` entrypoint.
+ * src/cli.ts — `npx mcp-browser-extension` entrypoint.
  *
  * Boot order: resolve config → ensure data dir → generate a per-boot token →
  * start the loopback bridge → write the 0600 handshake → configure the manager

package/dist/src/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * src/cli.ts — `npx chrome-mcp` entrypoint.
+ * src/cli.ts — `npx mcp-browser-extension` entrypoint.
  *
  * Boot order: resolve config → ensure data dir → generate a per-boot token →
  * start the loopback bridge → write the 0600 handshake → configure the manager
@@ -10,6 +10,7 @@
  * prints the handshake path (for manual pairing), never serving MCP.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const compat_1 = require("./compat");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const config_1 = require("./config");
@@ -79,7 +80,7 @@ function bundledExtensionVersion() {
 }
 /**
  * Mirror the bundled extension into the visible install folder
- * (`~/chrome-mcp-extension`) and report where Chrome should load it from. On a
+ * (`~/mcp-browser-extension`) and report where Chrome should load it from. On a
  * read-only home the bundled folder is returned instead; both are loadable.
  */
 function installExtension() {
@@ -122,11 +123,11 @@ function flag(args, name) {
 function hasFlag(args, name) {
     return args.includes(name);
 }
-const TASKS_HELP = `chrome-mcp tasks — inspect and prune per-profile task workspaces.
+const TASKS_HELP = `mcp-browser-extension tasks — inspect and prune per-profile task workspaces.
 
 Usage:
-  chrome-mcp tasks list [--json] [--data-dir <path>]
-  chrome-mcp tasks gc   [--older-than <days>] [--keep <n>] [--profile <name>]
+  mcp-browser-extension tasks list [--json] [--data-dir <path>]
+  mcp-browser-extension tasks gc   [--older-than <days>] [--keep <n>] [--profile <name>]
                         [--dry-run] [--data-dir <path>]
 
 gc removes a task only when it is NOT among the newest --keep AND is older than
@@ -143,7 +144,7 @@ function runTasksCommand(argv) {
     const sub = args[0];
     const dataDirFlag = flag(args, '--data-dir');
     if (dataDirFlag)
-        process.env.CHROME_MCP_DATA = dataDirFlag;
+        process.env.MCP_BROWSER_EXTENSION_DATA = dataDirFlag;
     const dataDir = (0, config_1.resolveDataDir)();
     if (sub === 'list') {
         const tasks = (0, tasks_1.listTasks)(dataDir);
@@ -238,7 +239,7 @@ async function main() {
         process.stdout.write(`${installExtension()}\n`);
         return;
     }
-    // Before anything binds the port: if npm has a newer chrome-mcp, run that
+    // Before anything binds the port: if npm has a newer mcp-browser-extension, run that
     // instead (stdio passes straight through), so no install stays on an old copy.
     const handedOff = await (0, auto_update_1.maybeHandOff)({
         current: version(),
@@ -275,7 +276,7 @@ async function main() {
             if (role === 'hub')
                 publishPairing(info.port, info.token);
             else {
-                (0, server_2.logErr)(`sharing the browsers of the chrome-mcp already on port ${info.port} (pid ${info.hubPid || '?'}) — several sessions can drive Chrome at once`);
+                (0, server_2.logErr)(`sharing the browsers of the mcp-browser-extension already on port ${info.port} (pid ${info.hubPid || '?'}) — several sessions can drive Chrome at once`);
                 // Refresh the unpacked extension folder from this session too: the hub
                 // may be an old process from a window left open for days, and it would
                 // keep the folder on its old files. The mirror never downgrades.
@@ -293,11 +294,11 @@ async function main() {
         // Drop the same port + token into the bundled extension folder so a Load
         // unpacked from there pairs itself. Best-effort: a read-only install just
         // falls back to the Options-page paste. Never take over a pairing file that
-        // a different, still-running chrome-mcp published (a second server with its
+        // a different, still-running mcp-browser-extension published (a second server with its
         // own data dir or port would otherwise re-point the user's extension).
         const extDir = installExtension();
         if (await (0, auth_1.bundledPairingHeldByOther)(extDir, port)) {
-            (0, server_2.logErr)(`auto-pairing file at ${extDir} belongs to another running chrome-mcp — left as is; pair this server from the extension Options page if you want it`);
+            (0, server_2.logErr)(`auto-pairing file at ${extDir} belongs to another running mcp-browser-extension — left as is; pair this server from the extension Options page if you want it`);
             return;
         }
         const bundled = (0, auth_1.writeBundledPairing)(extDir, { port, token: pairToken });
@@ -349,8 +350,8 @@ async function main() {
         policy: cfg.policy,
     })}`);
     const handshakePath = (0, datadir_1.handshakePath)(dataDir);
-    if (process.env.CHROME_MCP_TOKEN) {
-        (0, server_2.logErr)('token: pinned from CHROME_MCP_TOKEN (stable; pair once, never again).');
+    if ((0, compat_1.runtimeEnv)('TOKEN')) {
+        (0, server_2.logErr)('token: pinned from MCP_BROWSER_EXTENSION_TOKEN (stable; pair once, never again).');
     }
     else if (cfg.persistToken) {
         (0, server_2.logErr)('token: persisted across restarts (--persist-token; pair once, never again).');

package/dist/src/compat.d.ts

@@ -0,0 +1,4 @@
+/** New configuration names take precedence; existing installations still work. */
+export declare function runtimeEnv(key: string, env?: NodeJS.ProcessEnv): string | undefined;
+/** Expose the new path without moving files that a running browser still uses. */
+export declare function renamedDirectory(home: string, name: string, legacyName: string): string;

package/dist/src/compat.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeEnv = runtimeEnv;
+exports.renamedDirectory = renamedDirectory;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** New configuration names take precedence; existing installations still work. */
+function runtimeEnv(key, env = process.env) {
+    return env[`MCP_BROWSER_EXTENSION_${key}`] ?? env[`CHROME_MCP_${key}`];
+}
+/** Expose the new path without moving files that a running browser still uses. */
+function renamedDirectory(home, name, legacyName) {
+    const current = (0, node_path_1.join)(home, name);
+    const legacy = (0, node_path_1.join)(home, legacyName);
+    if ((0, node_fs_1.existsSync)(current) || !(0, node_fs_1.existsSync)(legacy))
+        return current;
+    try {
+        if (!(0, node_fs_1.statSync)(legacy).isDirectory())
+            return current;
+        (0, node_fs_1.symlinkSync)(legacy, current, process.platform === 'win32' ? 'junction' : 'dir');
+        return current;
+    }
+    catch {
+        // Another process may have created the alias, or the home may be read-only.
+        return (0, node_fs_1.existsSync)(current) ? current : legacy;
+    }
+}
+//# sourceMappingURL=compat.js.map

package/dist/src/config.d.ts

@@ -41,7 +41,7 @@ export interface CliConfig {
     /** `--no-site-grants`: the allowlist is exactly what the flags say; the
      *  extension's Options page cannot add sites at runtime. */
     noSiteGrants: boolean;
-    /** `--no-auto-update`: run this copy even when npm has a newer chrome-mcp. */
+    /** `--no-auto-update`: run this copy even when npm has a newer mcp-browser-extension. */
     noAutoUpdate: boolean;
     /** `--no-native-host`: don't register the one-click pairing helper with Chrome. */
     noNativeHost: boolean;
@@ -63,7 +63,7 @@ export interface CliConfig {
     showVersion: boolean;
     logLevel: LogLevel;
 }
-/** Resolve the data dir: `$CHROME_MCP_DATA` or `~/.chrome-mcp`. */
+/** Resolve the data dir: `$MCP_BROWSER_EXTENSION_DATA` or `~/.mcp-browser-extension`. */
 export declare function resolveDataDir(): string;
 /**
  * Reduce an arbitrary label to a single safe path segment: no separators, no
@@ -71,9 +71,9 @@ export declare function resolveDataDir(): string;
  * the data dir, so they must never escape it.
  */
 export declare function sanitizeName(name: string, kind: 'profile' | 'task'): string;
-/** Active profile: `$CHROME_MCP_PROFILE` (set by `--profile`) or "default". */
+/** Active profile: `$MCP_BROWSER_EXTENSION_PROFILE` (set by `--profile`) or "default". */
 export declare function resolveProfile(): string;
-/** Active task: `$CHROME_MCP_TASK` (set by `--task`) or "default". */
+/** Active task: `$MCP_BROWSER_EXTENSION_TASK` (set by `--task`) or "default". */
 export declare function resolveTask(): string;
 /** `profiles/<profile>/` — holds the Chrome user-data dir and this profile's tasks. */
 export declare function resolveProfileDir(dataDir: string, profile: string): string;

package/dist/src/config.js

@@ -21,11 +21,12 @@ const node_path_1 = require("node:path");
 const node_fs_1 = require("node:fs");
 const protocol_1 = require("../shared/protocol");
 const policy_1 = require("./security/policy");
+const compat_1 = require("./compat");
 /** Local port for `--http` (one above the bridge's). */
 exports.DEFAULT_HTTP_PORT = 38018;
-/** Resolve the data dir: `$CHROME_MCP_DATA` or `~/.chrome-mcp`. */
+/** Resolve the data dir: `$MCP_BROWSER_EXTENSION_DATA` or `~/.mcp-browser-extension`. */
 function resolveDataDir() {
-    return process.env.CHROME_MCP_DATA ?? (0, node_path_1.join)((0, node_os_1.homedir)(), '.chrome-mcp');
+    return (0, compat_1.runtimeEnv)('DATA') ?? (0, compat_1.renamedDirectory)((0, node_os_1.homedir)(), '.mcp-browser-extension', '.chrome-mcp');
 }
 const DEFAULT_PROFILE = 'default';
 const DEFAULT_TASK = 'default';
@@ -41,13 +42,13 @@ function sanitizeName(name, kind) {
     }
     return clean;
 }
-/** Active profile: `$CHROME_MCP_PROFILE` (set by `--profile`) or "default". */
+/** Active profile: `$MCP_BROWSER_EXTENSION_PROFILE` (set by `--profile`) or "default". */
 function resolveProfile() {
-    return sanitizeName(process.env.CHROME_MCP_PROFILE ?? DEFAULT_PROFILE, 'profile');
+    return sanitizeName((0, compat_1.runtimeEnv)('PROFILE') ?? DEFAULT_PROFILE, 'profile');
 }
-/** Active task: `$CHROME_MCP_TASK` (set by `--task`) or "default". */
+/** Active task: `$MCP_BROWSER_EXTENSION_TASK` (set by `--task`) or "default". */
 function resolveTask() {
-    return sanitizeName(process.env.CHROME_MCP_TASK ?? DEFAULT_TASK, 'task');
+    return sanitizeName((0, compat_1.runtimeEnv)('TASK') ?? DEFAULT_TASK, 'task');
 }
 /** `profiles/<profile>/` — holds the Chrome user-data dir and this profile's tasks. */
 function resolveProfileDir(dataDir, profile) {
@@ -71,7 +72,7 @@ function readPolicyFile(path) {
  * read triggered by `--policy <path>`.
  */
 function parseArgs(argv) {
-    let wsPort = envInt('CHROME_MCP_WS_PORT') ?? protocol_1.DEFAULT_WS_PORT;
+    let wsPort = envInt('MCP_BROWSER_EXTENSION_WS_PORT') ?? protocol_1.DEFAULT_WS_PORT;
     // Extension-only by default: never launch/attach a Chromium of our own unless
     // the operator explicitly opts in with --cdp-fallback (or --prefer cdp / --cdp-endpoint).
     let cdpFallback = false;
@@ -85,7 +86,7 @@ function parseArgs(argv) {
     let noAutoUpdate = false;
     let noNativeHost = false;
     let http = false;
-    let httpPort = envInt('CHROME_MCP_HTTP_PORT') ?? exports.DEFAULT_HTTP_PORT;
+    let httpPort = envInt('MCP_BROWSER_EXTENSION_HTTP_PORT') ?? exports.DEFAULT_HTTP_PORT;
     let tunnel = false;
     let rotateRemoteKey = false;
     let showHelp = false;
@@ -117,13 +118,13 @@ function parseArgs(argv) {
                 wsPort = requireInt(argv[++i], '--port');
                 break;
             case '--data-dir':
-                process.env.CHROME_MCP_DATA = requireValue(argv[++i], '--data-dir');
+                process.env.MCP_BROWSER_EXTENSION_DATA = requireValue(argv[++i], '--data-dir');
                 break;
             case '--profile':
-                process.env.CHROME_MCP_PROFILE = requireValue(argv[++i], '--profile');
+                process.env.MCP_BROWSER_EXTENSION_PROFILE = requireValue(argv[++i], '--profile');
                 break;
             case '--task':
-                process.env.CHROME_MCP_TASK = requireValue(argv[++i], '--task');
+                process.env.MCP_BROWSER_EXTENSION_TASK = requireValue(argv[++i], '--task');
                 break;
             case '--policy':
                 policyFile = readPolicyFile(requireValue(argv[++i], '--policy'));
@@ -288,7 +289,7 @@ function parseArgs(argv) {
 // Small parsing helpers
 // ---------------------------------------------------------------------------
 function envInt(name) {
-    const raw = process.env[name];
+    const raw = (0, compat_1.runtimeEnv)(name.replace(/^MCP_BROWSER_EXTENSION_/, ''));
     if (raw === undefined)
         return undefined;
     const n = Number.parseInt(raw, 10);
@@ -325,17 +326,17 @@ function requireLogLevel(value) {
     throw new Error('--log-level must be "silent", "info", or "debug"');
 }
 /** Help text for `--help`. */
-exports.HELP_TEXT = `chrome-mcp — the MCP Browser Extension server: drive your real Chrome over MCP.
+exports.HELP_TEXT = `mcp-browser-extension — the MCP Browser Extension server: drive your real Chrome over MCP.
 
-Usage: chrome-mcp [options]
-       chrome-mcp extension doctor [--json] [--user-data-dir <browser directory>]
-       chrome-mcp extension repair [--apply] [--user-data-dir <browser directory>]
-       chrome-mcp tasks list [--json]
-       chrome-mcp tasks gc   [--older-than <days>] [--keep <n>] [--profile <name>] [--dry-run]
+Usage: mcp-browser-extension [options]
+       mcp-browser-extension extension doctor [--json] [--user-data-dir <browser directory>]
+       mcp-browser-extension extension repair [--apply] [--user-data-dir <browser directory>]
+       mcp-browser-extension tasks list [--json]
+       mcp-browser-extension tasks gc   [--older-than <days>] [--keep <n>] [--profile <name>] [--dry-run]
 
 Connection:
   --port <n>             WebSocket bridge port (default ${protocol_1.DEFAULT_WS_PORT}; 0 = ephemeral)
-  --data-dir <path>      Override the data dir (default ~/.chrome-mcp)
+  --data-dir <path>      Override the data dir (default ~/.mcp-browser-extension)
   --profile <name>       Default browser profile / identity (default "default").
                          Artifacts live under profiles/<name>/. At runtime, switch
                          with the profile_use tool. Several browsers can pair to the
@@ -347,31 +348,31 @@ Connection:
                          land in profiles/<profile>/tasks/<task>/.
   --print-pairing        Write the handshake, print its path, and keep the bridge
                          up until Ctrl-C (manual pairing; never serves MCP)
-  --extension-path       Install the extension to ~/chrome-mcp-extension (or
-                         CHROME_MCP_EXTENSION_DIR) and print that path — the folder
+  --extension-path       Install the extension to ~/mcp-browser-extension (or
+                         MCP_BROWSER_EXTENSION_EXTENSION_DIR) and print that path — the folder
                          to pick in chrome://extensions -> Load unpacked. The server
                          also refreshes it on every boot.
   --persist-token        Reuse a stable on-disk token across restarts so the
                          extension never has to re-pair (default: fresh per boot).
-                         CHROME_MCP_TOKEN env, if set, pins the token explicitly.
+                         MCP_BROWSER_EXTENSION_TOKEN env, if set, pins the token explicitly.
   --no-native-host       Don't register the helper behind the extension's one-click
                          Connect button (pairing is then by pasting port and token)
   --http                 Serve MCP over HTTP on 127.0.0.1 instead of stdio, so a
                          client elsewhere can connect. Runs until Ctrl-C. Every
                          request needs the remote key (kept in <data-dir>/remote-key):
                          in the path, /mcp/<key>, or as Authorization: Bearer <key>.
-  --http-port <n>        Port for --http (default 38018; env CHROME_MCP_HTTP_PORT)
+  --http-port <n>        Port for --http (default 38018; env MCP_BROWSER_EXTENSION_HTTP_PORT)
   --tunnel               --http plus a Cloudflare quick tunnel, and print a public
                          connector URL for claude.ai, ChatGPT or any MCP client.
                          Needs cloudflared. The URL changes on every start.
   --rotate-remote-key    Make a new remote key: every remote client is cut off and
                          needs the new URL.
-  --no-auto-update       Run this copy even when a newer chrome-mcp is published.
+  --no-auto-update       Run this copy even when a newer mcp-browser-extension is published.
                          By default an installed copy (npx or global) checks npm at
                          startup and hands off to the latest release, so you never
-                         run a stale version. Same as CHROME_MCP_AUTO_UPDATE=0.
+                         run a stale version. Same as MCP_BROWSER_EXTENSION_AUTO_UPDATE=0.
   --no-telemetry         Send no anonymous usage statistics. Same as
-                         CHROME_MCP_TELEMETRY=0 or DO_NOT_TRACK=1. Only counts are
+                         MCP_BROWSER_EXTENSION_TELEMETRY=0 or DO_NOT_TRACK=1. Only counts are
                          ever sent (version, OS, tool calls, error codes) — never
                          URLs, page content or arguments.
 

package/dist/src/extension-command.js

@@ -4,10 +4,10 @@ exports.runExtensionCommand = runExtensionCommand;
 const node_path_1 = require("node:path");
 const config_1 = require("./config");
 const extension_repair_1 = require("./extension-repair");
-const HELP = `chrome-mcp extension — diagnose an extension missing after a browser restart.
+const HELP = `mcp-browser-extension extension — diagnose an extension missing after a browser restart.
 
-  chrome-mcp extension doctor [--json] [--user-data-dir <browser directory>]
-  chrome-mcp extension repair [--apply] [--json] [--user-data-dir <browser directory>]
+  mcp-browser-extension extension doctor [--json] [--user-data-dir <browser directory>]
+  mcp-browser-extension extension repair [--apply] [--json] [--user-data-dir <browser directory>]
                              [--data-dir <backup parent>]
 
 doctor is read-only and reports the actual Store/unpacked registration.

package/dist/src/extension-install.d.ts

@@ -6,23 +6,23 @@
  * folders deep under `npm root -g`, and an npx run hides it in a cache. So on
  * every boot (and on `--extension-path`) the server mirrors the bundled
  * `extension-dist/` into a plain, visible folder directly under the home
- * directory — `~/chrome-mcp-extension` — and that is the folder the docs, the
+ * directory — `~/mcp-browser-extension` — and that is the folder the docs, the
  * pairing file, and `--extension-path` all point at.
  *
  * The copy is a one-way mirror of top-level regular files, written only when
  * content differs, so an unchanged boot touches nothing. It never deletes: the
  * target may hold `pairing.json` (ours) and, if the operator pointed
- * CHROME_MCP_EXTENSION_DIR somewhere of their own, files that are not ours to
+ * MCP_BROWSER_EXTENSION_EXTENSION_DIR somewhere of their own, files that are not ours to
  * remove. It never throws — a read-only home just falls back to the bundled
  * folder, which still works for Load unpacked.
  */
 /** Folder name under the home directory. */
-export declare const EXTENSION_DIR_NAME = "chrome-mcp-extension";
+export declare const EXTENSION_DIR_NAME = "mcp-browser-extension";
 /** The auto-pairing file the server writes; never copied, never overwritten by the mirror. */
 export declare const PAIRING_FILE = "pairing.json";
 /** `dist/src/extension-install.js` -> `<pkg>/extension-dist`, which the tarball ships. */
 export declare function bundledExtensionDir(): string;
-/** Where the extension is mirrored for Load unpacked. `CHROME_MCP_EXTENSION_DIR` overrides. */
+/** Where the extension is mirrored for Load unpacked. `MCP_BROWSER_EXTENSION_EXTENSION_DIR` overrides. */
 export declare function extensionInstallDir(): string;
 export interface SyncResult {
     /** The folder that now holds the extension (the target on success, the source on failure). */