casework-browser-bridge
v0.1.0
Published
MCP server that drives the user's real Chrome via a companion MV3 extension — screenshot, extract, click, fill, scroll. Original CaseWork implementation, zero runtime dependencies.
Maintainers
Readme
casework-browser-bridge
An MCP server that lets CaseWork drive your real, logged-in Chrome — not a separate headless browser. It pairs with a small MV3 extension and exposes browser tools over the Model Context Protocol.
Original CaseWork implementation: pure Node built-ins, zero runtime
dependencies (hand-rolled WebSocket + MCP stdio), so it runs anywhere via
node server.js or npx.
How it works
Agent ⇄ (MCP stdio) ⇄ casework-browser-bridge ⇄ (ws://127.0.0.1:17370) ⇄ Chrome extension ⇄ your tabsTools
list_tabs · screenshot · navigate · extract_text · extract_table ·
click · fill · scroll
Use
- Run the server (CaseWork does this automatically; standalone:
npx -y casework-browser-bridgeornode server.js). - Load the extension once in Chrome:
chrome://extensions→ enable Developer mode → "Load unpacked" → select theextension/folder. - The extension connects to the bridge automatically; the agent's browser tools now act on your current tabs.
Config
CASEWORK_BRIDGE_PORT— WebSocket port (default17370). If you change it, updatePORTinextension/background.jsto match.
License
MIT
