Skip to content

Releases: jackwener/BrowserMCP

BrowserMCP 0.0.34-embedded.1

Pre-release

Choose a tag to compare

@jackwener jackwener released this 20 Oct 17:52
  • Model host tabs independently of WebContents, with stable logical IDs, explicit active selection, metadata updates and lazy loading.
  • Expose typed host events and snapshots with public MCP session IDs; reserve ownership during loading and roll back or cancel failed/revoked claims.
  • Unify tab state across MCP and Chrome APIs, and default MCP version to the installed package version.
  • Migration: use registerPage handles and reported tabId values; tabId no longer equals webContents.id. Synchronize host selection with setActivePage(scope, handle).
  • Share runtime isolation, storage injection, package version resolution and release infrastructure with main.

Install with npm install @jackwener/browsermcp@0.0.34-embedded.1 and import @jackwener/browsermcp/embedded from the Electron main process. No setup or Chrome extension is required.

BrowserMCP 0.0.34-embedded.0

Pre-release

Choose a tag to compare

@jackwener jackwener released this 20 Oct 17:40
  • Add the embedded Electron SDK with host-owned storage, profiles and page lifecycle.
  • Support MCP sessions, adapter creation and updates, Chrome API compatibility and CDP in embedded Chromium.
  • Import @jackwener/browsermcp/embedded without CLI setup or a Chrome extension.

Install with npm install @jackwener/browsermcp@0.0.34-embedded.0 and import @jackwener/browsermcp/embedded from the Electron main process. No setup or Chrome extension is required.

BrowserMCP 0.0.33

Choose a tag to compare

@jackwener jackwener released this 19 Oct 21:53

BrowserMCP 0.0.33 makes browser observations and actions easier for agents to compose.

  • Reuse observed element refs across frames in observe, find, read, act, and expect.
  • Verify target values, checked/selected states, visibility, enabled state, and text with actual evidence.
  • Pass returned continuation arguments, popup entries, and download results directly into follow-up calls.
  • Discover changed WebMCP catalogs during observation; fetch full schemas only when needed.
  • Standardize BrowserMCP runtime paths and simplify configuration.

Upgrade

Install @jackwener/browsermcp@0.0.33, update BrowserMCP Connector to 0.0.25, run browsermcp setup, and restart your MCP client. Native Messaging now uses com.browsermcp.host and local configuration lives in ~/.browsermcp. Previous OpenCLI directories and client entries are not migrated automatically.

Manual Chrome extension installation

Download browsermcp-extension-manual-install-0.0.25.zip, extract it, open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if installed.

opencli-mcp 0.0.31

Choose a tag to compare

@github-actions github-actions released this 19 Oct 18:06
  • Probe browser health before creating MCP sessions. Automatically choose a responsive host when multiple instances share one browserId; preserve already connected sessions.
  • Diagnose each host independently and retire hosts whose extension stops responding. Bound shutdown and handle native pipe errors.
  • Move extension ping outside page/session initialization. Ship extension 0.0.23.

Upgrade note: reload the extension after upgrading npm to restart the native host with the new IPC handshake, then restart the MCP client.

  • Page observations across the main document and child frames under one output budget, with explicit cursors over an immutable capture. Remove recursive branch folding that could hide the same branch on every expansion.
  • Scope observations directly with existing locators or refs, and remove inert ARIA wrappers while preserving names, states, refs and explanatory text.
  • Describe observation continuation in the MCP tool itself; distinguish output pagination, frame capture coverage, long-text fragments and abbreviated metadata.

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.23.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.30

Choose a tag to compare

@github-actions github-actions released this 14 Oct 02:57
  • Replace the local HTTP bridge with MCP over Unix domain sockets / Windows named pipes; remove port, token, and remote MCP configuration.
  • Reuse initialized host connections, keep each client session isolated, and reconnect to the same browser profile. Report session loss explicitly and never replay interrupted operations.
  • Distinguish browser selection from connection failures and reclaim stale IPC endpoints after host crashes.
  • Preserve explicitly organized tab groups through session cleanup.
  • Remove unused dependencies and frame-session code; consolidate extension packaging.

Upgrade note: this release requires extension 0.0.22 alongside npm package 0.0.30. Update both, then reload the extension and restart your MCP client to switch from the old HTTP launcher to local IPC. Existing MCP stdio command configuration stays the same. Windows named pipes have not been verified on a Windows machine.

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.22.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.29

Choose a tag to compare

@github-actions github-actions released this 09 Oct 09:39
  • chore: prepare extension 0.0.21 release
  • test: trim suite to core integration coverage
  • fix: preserve input semantics and verify settled control values

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.21.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.28

Choose a tag to compare

@github-actions github-actions released this 08 Oct 10:31
  • fix: keep action targets out of page DOM and disable cursor by default

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.20.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.27

Choose a tag to compare

@github-actions github-actions released this 30 Sep 07:41
  • feat: add Gmail API write adapters

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.19.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.26

Choose a tag to compare

@github-actions github-actions released this 30 Sep 06:15
  • Unify element refs across ARIA, DOM, find and actions, with document/frame-scoped identity and actionable stale-ref errors.
  • Resolve ARIA refs through the producing engine; prevent unregistered refs and large-capture eviction, and correctly handle quoted snapshot names.
  • Clarify persistent REPL output directly in MCP guidance and diagnostics; preserve standard JavaScript semantics and bindings.
  • Keep native host and MCP launchers working across Node upgrades, with installation and startup diagnostics.
  • Read X search from observed UI evidence and improve Windows browser-connection recovery guidance.
  • Ship Chrome extension 0.0.19; update the extension to receive the browser-side ref fixes.

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.19.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.

opencli-mcp 0.0.25

Choose a tag to compare

@github-actions github-actions released this 28 Sep 11:44
  • Fix JavaScript execution on Node 26 while retaining Node 22+ support, using one V8 Inspector REPL implementation across Node 22, 24 and 26.
  • Preserve bindings after ordinary errors, correctly report falsy exceptions, and support redeclaring top-level bindings across calls.
  • Drain dispatched API work within the call timeout; handle unobserved RPC failures and prevent late callbacks from affecting later calls.
  • Validate persistent JavaScript execution through the native host and MCP, with Node 22/24/26 release checks.
  • Chrome extension remains at 0.0.18; this release changes the local host only.

Manual Chrome extension installation

Download opencli-mcp-extension-manual-install-0.0.18.zip, extract it, then open chrome://extensions, enable Developer mode, and choose Load unpacked on the extracted folder. Disable the Chrome Web Store copy first if it is installed.