mcp-browser-bridge 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 adbarc92
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# Browser Bridge MCP
+
+[![npm version](https://img.shields.io/npm/v/mcp-browser-bridge.svg)](https://www.npmjs.com/package/mcp-browser-bridge)
+
+MCP server that bridges AI assistants to the browser via a WebSocket-connected extension.
+
+```
+AI Assistant ←(MCP stdio)→ mcp-browser-bridge ←(WebSocket :7483)→ Browser Extension ←(Chrome APIs)→ Browser
+```
+
+## Quick Start
+
+### 1. Install the extension
+
+Install from the Chrome Web Store (coming soon), or load manually:
+
+1. Download or clone this repo.
+2. Open `chrome://extensions`, enable **Developer mode**.
+3. Click **Load unpacked** and select the `extension/` folder.
+
+Works in Chrome, Brave, Edge, and other Chromium browsers.
+
+### 2. Add to your MCP config
+
+Add to your `.mcp.json` (or equivalent MCP client config):
+
+```json
+{
+  "mcpServers": {
+    "browser-bridge": {
+      "command": "npx",
+      "args": ["-y", "mcp-browser-bridge"],
+      "env": { "BRIDGE_WS_PORT": "7483" }
+    }
+  }
+}
+```
+
+### 3. Verify
+
+Start your MCP client. The extension popup should show a green "Connected" indicator. Use the `browser_status` tool to confirm the connection.
+
+## Available Tools
+
+All tools accept an optional `tabId` parameter. When omitted, they target the active tab.
+
+| Tool | Description |
+|------|-------------|
+| `browser_status` | Check if the extension is connected and get active tab info |
+| `browser_navigate` | Navigate a tab to a URL |
+| `browser_screenshot` | Capture a screenshot of the visible area of a tab |
+| `browser_evaluate` | Execute JavaScript in a tab and return the result |
+| `browser_click` | Click an element by CSS selector |
+| `browser_fill` | Fill a form field by CSS selector |
+| `browser_get_content` | Get the text or HTML of a page or element |
+| `browser_get_tabs` | List all open browser tabs |
+| `browser_get_console` | Get captured console log entries from a tab |
+| `browser_wait_for` | Wait for a CSS selector to appear on the page |
+| `browser_send_message` | Send a custom message to the extension |
+
+## Configuration
+
+The WebSocket port defaults to `7483`. To change it:
+
+- **Server side:** Set the `BRIDGE_WS_PORT` environment variable in your MCP config.
+- **Extension side:** Change the port in the extension popup and click Reconnect.
+
+## Compatibility
+
+Works with any Chromium-based browser: Chrome, Brave, Edge, Arc, Vivaldi, Opera.
+
+## Security
+
+- WebSocket binds to `127.0.0.1` only (no network exposure).
+- Connections restricted to `chrome-extension://` origins.
+- Single extension client at a time.
+
+## Troubleshooting
+
+**Extension shows "Disconnected"**
+Check that the MCP server is running and the port is free. Verify nothing else is using port 7483:
+```sh
+# macOS/Linux
+lsof -i :7483
+
+# Windows
+netstat -aon | findstr :7483
+```
+
+**Tools return "No extension connected"**
+Open the extension popup and click Reconnect. Ensure the popup shows a green "Connected" indicator.
+
+**Screenshots fail**
+The target tab must be visible and focused. Background or minimized tabs cannot be captured.
+
+**`browser_evaluate` returns unexpected results**
+Scripts run in the page's MAIN world. Results must be JSON-serializable. Promises return `{}` -- use synchronous expressions or structure async work to return a final value.
+
+## Development
+
+```bash
+git clone https://github.com/adbarc92/mcp-browser-bridge.git
+cd mcp-browser-bridge
+npm install
+npm run build
+```
+
+To load the extension locally:
+
+1. Open `chrome://extensions` and enable Developer mode.
+2. Click "Load unpacked" and select the `extension/` folder.
+
+The repo includes a `.mcp.json` configured for local development.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { BridgeWebSocketServer } from "./ws-server.js";
+import { createMcpServer } from "./mcp-server.js";
+import { METHODS } from "./protocol.js";
+import { logger } from "./utils/logger.js";
+async function main() {
+    const ws = new BridgeWebSocketServer();
+    const mcp = createMcpServer(ws);
+    // Log console events from the extension
+    ws.on(METHODS.EVENT_CONSOLE, (event) => {
+        logger.debug("Console event", event.params);
+    });
+    ws.on(METHODS.EVENT_TAB_UPDATED, (event) => {
+        logger.debug("Tab updated", event.params);
+    });
+    ws.on(METHODS.EVENT_TAB_REMOVED, (event) => {
+        logger.debug("Tab removed", event.params);
+    });
+    // Start WebSocket server first
+    ws.start();
+    // Connect MCP over stdio
+    const transport = new StdioServerTransport();
+    await mcp.connect(transport);
+    logger.info("MCP server connected via stdio");
+    // Graceful shutdown
+    const shutdown = () => {
+        logger.info("Shutting down...");
+        ws.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+    logger.error("Fatal error", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IAEhC,wCAAwC;IACxC,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;QACrC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE;QACzC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,EAAE;QACzC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAE9C,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BridgeWebSocketServer } from "./ws-server.js";
+export declare function createMcpServer(ws: BridgeWebSocketServer): McpServer;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAcvD,wBAAgB,eAAe,CAAC,EAAE,EAAE,qBAAqB,GAAG,SAAS,CA4NpE"}

package/dist/mcp-server.js

@@ -0,0 +1,175 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { METHODS, SCREENSHOT_TIMEOUT_MS } from "./protocol.js";
+function errorText(err) {
+    if (typeof err === "object" && err !== null && "message" in err) {
+        return err.message;
+    }
+    return String(err);
+}
+function textResult(text, isError = false) {
+    return { content: [{ type: "text", text }], isError };
+}
+export function createMcpServer(ws) {
+    const mcp = new McpServer({
+        name: "browser-bridge",
+        version: "1.1.0",
+    });
+    // 1. browser_status
+    mcp.tool("browser_status", "Check if the Chrome extension is connected and get active tab info", {}, async () => {
+        if (!ws.isConnected) {
+            return textResult(JSON.stringify({
+                connected: false,
+                message: "No Chrome extension connected. Load the extension and ensure it shows 'Connected'.",
+            }, null, 2));
+        }
+        try {
+            const result = await ws.send(METHODS.CONNECTION_STATUS);
+            return textResult(JSON.stringify({ connected: true, ...result }, null, 2));
+        }
+        catch (err) {
+            return textResult(`Connected but status check failed: ${errorText(err)}`, true);
+        }
+    });
+    // 2. browser_navigate
+    mcp.tool("browser_navigate", "Navigate a browser tab to the specified URL", {
+        url: z.string().describe("The URL to navigate to"),
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+    }, async ({ url, tabId }) => {
+        try {
+            const result = await ws.send(METHODS.NAVIGATE, { url, tabId });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Navigation failed: ${errorText(err)}`, true);
+        }
+    });
+    // 3. browser_screenshot
+    mcp.tool("browser_screenshot", "Capture a screenshot of the visible area of a browser tab", {
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+        format: z.enum(["png", "jpeg"]).optional().describe("Image format (default: png)"),
+        quality: z.number().min(0).max(100).optional().describe("JPEG quality (0-100, only for jpeg format)"),
+    }, async ({ tabId, format, quality }) => {
+        try {
+            const result = await ws.send(METHODS.SCREENSHOT, { tabId, format, quality }, SCREENSHOT_TIMEOUT_MS);
+            return {
+                content: [{
+                        type: "image",
+                        data: result.data,
+                        mimeType: result.mimeType,
+                    }],
+            };
+        }
+        catch (err) {
+            return textResult(`Screenshot failed: ${errorText(err)}`, true);
+        }
+    });
+    // 4. browser_evaluate
+    mcp.tool("browser_evaluate", "Execute JavaScript in the context of a browser tab and return the result", {
+        expression: z.string().describe("JavaScript expression to evaluate"),
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+    }, async ({ expression, tabId }) => {
+        try {
+            const result = await ws.send(METHODS.EVALUATE, { expression, tabId });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Evaluation failed: ${errorText(err)}`, true);
+        }
+    });
+    // 5. browser_click
+    mcp.tool("browser_click", "Click an element on the page identified by a CSS selector", {
+        selector: z.string().describe("CSS selector for the element to click"),
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+    }, async ({ selector, tabId }) => {
+        try {
+            const result = await ws.send(METHODS.CLICK, { selector, tabId });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Click failed: ${errorText(err)}`, true);
+        }
+    });
+    // 6. browser_fill
+    mcp.tool("browser_fill", "Fill a form field with the specified value", {
+        selector: z.string().describe("CSS selector for the input element"),
+        value: z.string().describe("Value to fill in"),
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+    }, async ({ selector, value, tabId }) => {
+        try {
+            const result = await ws.send(METHODS.FILL, { selector, value, tabId });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Fill failed: ${errorText(err)}`, true);
+        }
+    });
+    // 7. browser_get_content
+    mcp.tool("browser_get_content", "Get the HTML or text content of a page or specific element", {
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+        selector: z.string().optional().describe("CSS selector to get content of (defaults to body)"),
+        format: z.enum(["html", "text"]).optional().describe("Content format (default: text)"),
+    }, async ({ tabId, selector, format }) => {
+        try {
+            const result = await ws.send(METHODS.GET_CONTENT, { tabId, selector, format });
+            const content = result;
+            return textResult(`URL: ${content.url}\nTitle: ${content.title}\n\n${content.content}`);
+        }
+        catch (err) {
+            return textResult(`Get content failed: ${errorText(err)}`, true);
+        }
+    });
+    // 8. browser_get_tabs
+    mcp.tool("browser_get_tabs", "List all open browser tabs", {}, async () => {
+        try {
+            const result = await ws.send(METHODS.GET_TABS);
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Get tabs failed: ${errorText(err)}`, true);
+        }
+    });
+    // 9. browser_get_console
+    mcp.tool("browser_get_console", "Get captured console log entries from a tab", {
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+        clear: z.boolean().optional().describe("Clear logs after retrieval (default: false)"),
+    }, async ({ tabId, clear }) => {
+        try {
+            const result = await ws.send(METHODS.GET_CONSOLE, { tabId, clear });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Get console failed: ${errorText(err)}`, true);
+        }
+    });
+    // 10. browser_wait_for
+    mcp.tool("browser_wait_for", "Wait for an element matching a CSS selector to appear on the page", {
+        selector: z.string().describe("CSS selector to wait for"),
+        tabId: z.number().optional().describe("Tab ID (defaults to active tab)"),
+        timeout: z.number().optional().describe("Timeout in milliseconds (default: 30000)"),
+    }, async ({ selector, tabId, timeout }) => {
+        const waitTimeout = timeout || 30000;
+        try {
+            const result = await ws.send(METHODS.WAIT_FOR, { selector, tabId, timeout: waitTimeout }, waitTimeout + 5000);
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Wait failed: ${errorText(err)}`, true);
+        }
+    });
+    // 11. browser_send_message
+    mcp.tool("browser_send_message", "Send a custom message to the Chrome extension for extensibility", {
+        type: z.string().describe("Custom message type"),
+        data: z.record(z.unknown()).optional().describe("Optional data payload"),
+    }, async ({ type, data }) => {
+        try {
+            const result = await ws.send(METHODS.CUSTOM_MESSAGE, { type, data });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return textResult(`Send message failed: ${errorText(err)}`, true);
+        }
+    });
+    return mcp;
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,56 @@
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+export interface JsonRpcEvent {
+    jsonrpc: "2.0";
+    id: null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcResponse | JsonRpcEvent;
+export declare const ErrorCodes: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly TIMEOUT: -32000;
+    readonly NOT_CONNECTED: -32001;
+    readonly ELEMENT_NOT_FOUND: -32002;
+    readonly EXECUTION_ERROR: -32003;
+};
+export declare const METHODS: {
+    readonly NAVIGATE: "browser.navigate";
+    readonly SCREENSHOT: "browser.screenshot";
+    readonly EVALUATE: "browser.evaluate";
+    readonly CLICK: "browser.click";
+    readonly FILL: "browser.fill";
+    readonly GET_CONTENT: "browser.getContent";
+    readonly GET_TABS: "browser.getTabs";
+    readonly GET_CONSOLE: "browser.getConsole";
+    readonly WAIT_FOR: "browser.waitFor";
+    readonly CONNECTION_STATUS: "connection.status";
+    readonly CUSTOM_MESSAGE: "browser.sendMessage";
+    readonly EVENT_CONSOLE: "event.console";
+    readonly EVENT_TAB_UPDATED: "event.tabUpdated";
+    readonly EVENT_TAB_REMOVED: "event.tabRemoved";
+};
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const SCREENSHOT_TIMEOUT_MS = 60000;
+export declare const KEEPALIVE_INTERVAL_MS = 20000;
+export declare const WS_PORT: number;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,eAAe,GAAG,YAAY,CAAC;AAE7E,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;CAkBV,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,OAAO,QAAqD,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,34 @@
+export const ErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    TIMEOUT: -32000,
+    NOT_CONNECTED: -32001,
+    ELEMENT_NOT_FOUND: -32002,
+    EXECUTION_ERROR: -32003,
+};
+export const METHODS = {
+    // Server -> Extension requests
+    NAVIGATE: "browser.navigate",
+    SCREENSHOT: "browser.screenshot",
+    EVALUATE: "browser.evaluate",
+    CLICK: "browser.click",
+    FILL: "browser.fill",
+    GET_CONTENT: "browser.getContent",
+    GET_TABS: "browser.getTabs",
+    GET_CONSOLE: "browser.getConsole",
+    WAIT_FOR: "browser.waitFor",
+    CONNECTION_STATUS: "connection.status",
+    CUSTOM_MESSAGE: "browser.sendMessage",
+    // Extension -> Server events
+    EVENT_CONSOLE: "event.console",
+    EVENT_TAB_UPDATED: "event.tabUpdated",
+    EVENT_TAB_REMOVED: "event.tabRemoved",
+};
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const SCREENSHOT_TIMEOUT_MS = 60_000;
+export const KEEPALIVE_INTERVAL_MS = 20_000;
+export const WS_PORT = parseInt(process.env.BRIDGE_WS_PORT || "7483", 10);
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,OAAO,EAAE,CAAC,KAAK;IACf,aAAa,EAAE,CAAC,KAAK;IACrB,iBAAiB,EAAE,CAAC,KAAK;IACzB,eAAe,EAAE,CAAC,KAAK;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,+BAA+B;IAC/B,QAAQ,EAAE,kBAAkB;IAC5B,UAAU,EAAE,oBAAoB;IAChC,QAAQ,EAAE,kBAAkB;IAC5B,KAAK,EAAE,eAAe;IACtB,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,iBAAiB;IAC3B,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,iBAAiB;IAC3B,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,qBAAqB;IAErC,6BAA6B;IAC7B,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,kBAAkB;IACrC,iBAAiB,EAAE,kBAAkB;CAC7B,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug: (msg: string, data?: unknown) => void;
+    info: (msg: string, data?: unknown) => void;
+    warn: (msg: string, data?: unknown) => void;
+    error: (msg: string, data?: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,MAAM;iBACJ,MAAM,SAAS,OAAO;gBACvB,MAAM,SAAS,OAAO;gBACtB,MAAM,SAAS,OAAO;iBACrB,MAAM,SAAS,OAAO;CACpC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,27 @@
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const minLevel = process.env.BRIDGE_LOG_LEVEL || "info";
+function shouldLog(level) {
+    return LEVEL_ORDER[level] >= LEVEL_ORDER[minLevel];
+}
+function log(level, message, data) {
+    if (!shouldLog(level))
+        return;
+    const timestamp = new Date().toISOString();
+    const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+    const line = data !== undefined
+        ? `${prefix} ${message} ${JSON.stringify(data)}`
+        : `${prefix} ${message}`;
+    process.stderr.write(line + "\n");
+}
+export const logger = {
+    debug: (msg, data) => log("debug", msg, data),
+    info: (msg, data) => log("info", msg, data),
+    warn: (msg, data) => log("warn", msg, data),
+    error: (msg, data) => log("error", msg, data),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,QAAQ,GAAc,OAAO,CAAC,GAAG,CAAC,gBAA6B,IAAI,MAAM,CAAC;AAEhF,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;IAC3D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS;QAC7B,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAChD,CAAC,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;IAC/D,IAAI,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;CAChE,CAAC"}

package/dist/utils/pending-requests.d.ts

@@ -0,0 +1,13 @@
+import { type JsonRpcRequest, type JsonRpcError } from "../protocol.js";
+export declare class PendingRequests {
+    private pending;
+    create(method: string, params?: Record<string, unknown>, timeoutMs?: number): {
+        request: JsonRpcRequest;
+        promise: Promise<unknown>;
+    };
+    resolve(id: string, result: unknown): boolean;
+    reject(id: string, error: JsonRpcError): boolean;
+    rejectAll(error: JsonRpcError): void;
+    get size(): number;
+}
+//# sourceMappingURL=pending-requests.d.ts.map

package/dist/utils/pending-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-requests.d.ts","sourceRoot":"","sources":["../../src/utils/pending-requests.ts"],"names":[],"mappings":"AACA,OAAO,EAAkC,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUxG,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqC;IAEpD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,SAAqB,GAAG;QACxF,OAAO,EAAE,cAAc,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;KAC3B;IAyBD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAU7C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO;IAUhD,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IASpC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/utils/pending-requests.js

@@ -0,0 +1,59 @@
+import { v4 as uuidv4 } from "uuid";
+import { ErrorCodes, DEFAULT_TIMEOUT_MS } from "../protocol.js";
+import { logger } from "./logger.js";
+export class PendingRequests {
+    pending = new Map();
+    create(method, params, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        const id = uuidv4();
+        const request = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            ...(params && { params }),
+        };
+        const promise = new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                logger.warn(`Request timed out: ${method} (${id})`);
+                reject({
+                    code: ErrorCodes.TIMEOUT,
+                    message: `Request timed out after ${timeoutMs}ms`,
+                });
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer, method });
+        });
+        return { request, promise };
+    }
+    resolve(id, result) {
+        const pending = this.pending.get(id);
+        if (!pending)
+            return false;
+        clearTimeout(pending.timer);
+        this.pending.delete(id);
+        logger.debug(`Request resolved: ${pending.method} (${id})`);
+        pending.resolve(result);
+        return true;
+    }
+    reject(id, error) {
+        const pending = this.pending.get(id);
+        if (!pending)
+            return false;
+        clearTimeout(pending.timer);
+        this.pending.delete(id);
+        logger.debug(`Request rejected: ${pending.method} (${id})`);
+        pending.reject(error);
+        return true;
+    }
+    rejectAll(error) {
+        for (const [id, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            logger.debug(`Rejecting pending request: ${pending.method} (${id})`);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    get size() {
+        return this.pending.size;
+    }
+}
+//# sourceMappingURL=pending-requests.js.map

package/dist/utils/pending-requests.js.map

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

package/dist/ws-server.d.ts

@@ -0,0 +1,19 @@
+import { type JsonRpcEvent } from "./protocol.js";
+type EventHandler = (event: JsonRpcEvent) => void;
+export declare class BridgeWebSocketServer {
+    private wss;
+    private client;
+    private pendingRequests;
+    private keepaliveTimer;
+    private eventHandlers;
+    get isConnected(): boolean;
+    start(): void;
+    stop(): void;
+    send(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    on(event: string, handler: EventHandler): void;
+    private handleMessage;
+    private startKeepalive;
+    private stopKeepalive;
+}
+export {};
+//# sourceMappingURL=ws-server.d.ts.map

package/dist/ws-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-server.d.ts","sourceRoot":"","sources":["../src/ws-server.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAIvB,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAElD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,aAAa,CAAqC;IAE1D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,KAAK,IAAI,IAAI;IAkEb,IAAI,IAAI,IAAI;IAgBN,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAM9C,OAAO,CAAC,aAAa;IA4CrB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;CAMtB"}

package/dist/ws-server.js

@@ -0,0 +1,160 @@
+import { WebSocketServer, WebSocket } from "ws";
+import { ErrorCodes, KEEPALIVE_INTERVAL_MS, WS_PORT, } from "./protocol.js";
+import { PendingRequests } from "./utils/pending-requests.js";
+import { logger } from "./utils/logger.js";
+export class BridgeWebSocketServer {
+    wss = null;
+    client = null;
+    pendingRequests = new PendingRequests();
+    keepaliveTimer = null;
+    eventHandlers = new Map();
+    get isConnected() {
+        return this.client !== null && this.client.readyState === WebSocket.OPEN;
+    }
+    start() {
+        this.wss = new WebSocketServer({
+            host: "127.0.0.1",
+            port: WS_PORT,
+            verifyClient: (info) => {
+                const origin = info.origin || info.req.headers.origin || "";
+                // Allow any Chromium-based browser extension (Chrome, Brave, Edge, Arc, Vivaldi, etc.)
+                // Localhost-only binding (127.0.0.1) provides the primary security boundary.
+                const allowed = origin === "" ||
+                    origin.endsWith("-extension://") ||
+                    origin.startsWith("chrome-extension://");
+                if (!allowed) {
+                    logger.warn(`Rejected connection from origin: ${origin}`);
+                    return false;
+                }
+                logger.info(`Accepted connection from origin: ${origin || "(empty)"}`);
+                return true;
+            },
+        });
+        this.wss.on("listening", () => {
+            logger.info(`WebSocket server listening on 127.0.0.1:${WS_PORT}`);
+        });
+        this.wss.on("connection", (ws, req) => {
+            const origin = req.headers.origin || "unknown";
+            logger.info(`Extension connected from ${origin}`);
+            // Single client - close existing connection cleanly before reassigning
+            if (this.client && this.client.readyState === WebSocket.OPEN) {
+                logger.info("Replacing existing client connection");
+                const oldClient = this.client;
+                this.client = null; // Detach first so the old close handler is a no-op
+                oldClient.close(1000, "Replaced by new connection");
+            }
+            this.client = ws;
+            this.startKeepalive();
+            ws.on("message", (data) => {
+                this.handleMessage(data.toString());
+            });
+            ws.on("close", (code, reason) => {
+                logger.info(`Extension disconnected: ${code} ${reason.toString()}`);
+                if (this.client === ws) {
+                    this.client = null;
+                    this.stopKeepalive();
+                    this.pendingRequests.rejectAll({
+                        code: ErrorCodes.NOT_CONNECTED,
+                        message: "Extension disconnected",
+                    });
+                }
+            });
+            ws.on("error", (err) => {
+                logger.error("WebSocket client error", err.message);
+            });
+        });
+        this.wss.on("error", (err) => {
+            logger.error("WebSocket server error", err.message);
+        });
+    }
+    stop() {
+        this.stopKeepalive();
+        if (this.client) {
+            this.client.close(1000, "Server shutting down");
+            this.client = null;
+        }
+        this.pendingRequests.rejectAll({
+            code: ErrorCodes.INTERNAL_ERROR,
+            message: "Server shutting down",
+        });
+        if (this.wss) {
+            this.wss.close();
+            this.wss = null;
+        }
+    }
+    async send(method, params, timeoutMs) {
+        if (!this.isConnected) {
+            throw {
+                code: ErrorCodes.NOT_CONNECTED,
+                message: "No Chrome extension connected. Please open the extension and check the connection.",
+            };
+        }
+        const { request, promise } = this.pendingRequests.create(method, params, timeoutMs);
+        logger.debug(`Sending request: ${method}`, request);
+        this.client.send(JSON.stringify(request));
+        return promise;
+    }
+    on(event, handler) {
+        const handlers = this.eventHandlers.get(event) || [];
+        handlers.push(handler);
+        this.eventHandlers.set(event, handlers);
+    }
+    handleMessage(raw) {
+        // Handle keepalive
+        if (raw === "pong") {
+            logger.debug("Received pong");
+            return;
+        }
+        let message;
+        try {
+            message = JSON.parse(raw);
+        }
+        catch {
+            logger.warn("Failed to parse message", raw);
+            return;
+        }
+        // Response to a pending request
+        if ("id" in message && message.id !== null && ("result" in message || "error" in message)) {
+            const response = message;
+            if (response.error) {
+                this.pendingRequests.reject(response.id, response.error);
+            }
+            else {
+                this.pendingRequests.resolve(response.id, response.result);
+            }
+            return;
+        }
+        // Unsolicited event from extension
+        if ("method" in message && ("id" in message ? message.id === null : true)) {
+            const event = message;
+            logger.debug(`Received event: ${event.method}`);
+            const handlers = this.eventHandlers.get(event.method) || [];
+            for (const handler of handlers) {
+                try {
+                    handler(event);
+                }
+                catch (err) {
+                    logger.error(`Event handler error for ${event.method}`, err);
+                }
+            }
+            return;
+        }
+        logger.warn("Unhandled message", message);
+    }
+    startKeepalive() {
+        this.stopKeepalive();
+        this.keepaliveTimer = setInterval(() => {
+            if (this.isConnected) {
+                this.client.send("ping");
+                logger.debug("Sent ping");
+            }
+        }, KEEPALIVE_INTERVAL_MS);
+    }
+    stopKeepalive() {
+        if (this.keepaliveTimer) {
+            clearInterval(this.keepaliveTimer);
+            this.keepaliveTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=ws-server.js.map

package/dist/ws-server.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "mcp-browser-bridge",
+  "version": "1.1.0",
+  "description": "MCP server that bridges AI assistants to the browser via a WebSocket-connected extension",
+  "type": "module",
+  "bin": {
+    "mcp-browser-bridge": "./dist/index.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "browser",
+    "chrome",
+    "automation",
+    "testing",
+    "screenshot",
+    "websocket",
+    "model-context-protocol"
+  ],
+  "author": "adbarc92",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adbarc92/mcp-browser-bridge.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.18.0",
+    "typescript": "^5.7.3"
+  }
+}