mcp-registry/browser-control-mcp

    ==================
      
       /// MCP ///
      /// BRO ///
        
    ==================
        
    [server:online]
    [protocol:ready]

browser-control-mcp

by eyalzh

MCP server (Node/TypeScript) plus Firefox extension that lets AI agents manage browser tabs, history and read page content via a secure local channel.

89
20
Open Source
GitHubNPM

01

Open or close tabs

Open new browser tabs or close existing ones

02

Get the list of opened tabs

Retrieve a list of all currently open browser tabs

03

Create tab groups with name and color

Create new tab groups, specifying a group name and color

04

Reorder opened tabs

Change the order of existing open tabs

05

Read and search the browser's history

Access and search through the browser’s history entries

06

Read a webpage's text content and links (requires user consent)

Retrieve the textual content and hyperlinks from a webpage after the user grants permission

07

Find and highlight text in a browser tab (requires user consent)

Search for specified text within a tab and visually highlight the matches once the user consents

Installation

1. Prerequisites
• Node.js ≥18 and npm (or pnpm / yarn)
• Git
2. Clone the repository
git clone https://github.com/eyalzh/browser-control-mcp.git cd browser-control-mcp
3. Install dependencies
npm install # or: yarn install / pnpm i
4. Build the TypeScript sources (optional – if the repo ships JS this will be skipped)
npm run build
5. Configuration
• Copy .env.example to .env and adjust values.
# Example variables PORT=3000 # HTTP port to expose the MCP server ALLOWED_ORIGINS=* # CORS settings for the browser extension AUTH_TOKEN=<secret> # Shared token used by the extension/agents (if enabled)
6. Run the MCP server
npm start # usually alias for: node dist/index.js # or during development with hot-reload npm run dev
7. (Optional) Docker
docker build -t browser-control-mcp . docker run -p 3000:3000 -e PORT=3000 browser-control-mcp
8. Pair with the Browser Extension
• Install the companion extension (Chrome/Firefox AMO link in the browser-control-extension repo).
• In the extension’s options page, set the MCP server URL (e.g., http://localhost:3000) and the AUTH_TOKEN if required.

Documentation

License: MIT License
Updated 7/30/2025