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

mcp

by BrowserMCP

Browser MCP – a Model Context Provider (MCP) server + Chrome extension enabling local, private AI-driven browser automation.

3.4k

228

Open Source

Installation

Prerequisites:

1. Node.js ≥ 18 and npm (or pnpm/yarn)

2. Google Chrome / Chromium installed locally (the server launches a real browser instance)

3. (Optional) Docker if you prefer containerised deployment

Clone & install:

# HTTPS
git clone https://github.com/BrowserMCP/mcp.git
cd mcp

# Install TypeScript source dependencies
npm install    # or: pnpm i / yarn

Configuration:

1. Copy the sample environment file and adjust

cp .env.example .env

2. Edit the new `.env` file – common keys:

PORT=3020 # HTTP port to expose the MCP server

BROWSER_EXECUTABLE="/path/to/chrome" # optional custom Chrome binary

AUTH_TOKEN="<strong-random-string>" # shared secret for API calls

Build (production):

npm run build # transpiles TypeScript → dist/

Run the MCP server:

# Development – hot-reload	npm run dev
# Production            	npm start

Docker quick-start:

docker build -t browser-mcp .
docker run -p 3020:3020 -e AUTH_TOKEN="<token>" browser-mcp

The server will now listen on http://localhost:3020 . Use the AUTH_TOKEN in the `Authorization: Bearer` header when making requests.

License: Apache License 2.0

Updated 7/30/2025