Browser MCP Server

Browser MCP

A Model Context Protocol (MCP) server for browser automation using Puppeteer. This enables AI assistants like Claude, GPT, and other LLM-powered tools to navigate web pages, take screenshots, click elements, fill forms, and interact with web content.

Features

• Navigation: Navigate to URLs, go back/forward, reload pages
• Screenshots: Capture full-page or viewport screenshots
• Interaction: Click, type, hover, scroll, select dropdown options
• Content Extraction: Get page content, titles, and links
• JavaScript Execution: Run custom scripts in the browser context
• Wait Conditions: Wait for elements or timeouts

Installation

Prerequisites

• Node.js 18+ (LTS recommended)
• npm, pnpm, or bun

Install via npx (Recommended)

You can run the server directly without installation:

npx github:blink-new/browser-mcp

Install Globally

npm install -g github:blink-new/browser-mcp

Install from Source

git clone https://github.com/blink-new/browser-mcp.git
cd browser-mcp
npm install
npm run build

Setup Instructions

Ubuntu / Debian Linux

1. Install Node.js 18+:

   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

2. Install Chromium dependencies:

   sudo apt-get install -y \
     libnss3 \
     libatk1.0-0 \
     libatk-bridge2.0-0 \
     libcups2 \
     libdrm2 \
     libxkbcommon0 \
     libxcomposite1 \
     libxdamage1 \
     libxfixes3 \
     libxrandr2 \
     libgbm1 \
     libasound2 \
     libpango-1.0-0 \
     libcairo2 \
     libatspi2.0-0
   

3. Configure your MCP client (see Configuration section below)

macOS

1. Install Node.js 18+ (using Homebrew):

   brew install node
   

   Or using nvm:

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
   nvm install 20
   nvm use 20
   

2. Configure your MCP client (see Configuration section below)

Windows

1. Install Node.js 18+:

   • Download and install from nodejs.org
   • Or use winget: winget install OpenJS.NodeJS.LTS

2. Configure your MCP client (see Configuration section below)

Configuration

OpenCode

Add to your ~/.config/opencode/opencode.json:

{
  "mcp": {
    "browser": {
      "type": "local",
      "command": ["npx", "-y", "github:blink-new/browser-mcp"],
      "enabled": true
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "github:blink-new/browser-mcp"]
    }
  }
}

Cursor / VS Code with MCP Extension

Add to your MCP configuration:

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "github:blink-new/browser-mcp"]
    }
  }
}

With Environment Variables

For headless servers or containers:

{
  "mcp": {
    "browser": {
      "type": "local",
      "command": ["npx", "-y", "github:blink-new/browser-mcp"],
      "environment": {
        "BROWSER_MCP_NO_SANDBOX": "true",
        "BROWSER_MCP_HEADLESS": "true"
      },
      "enabled": true
    }
  }
}

Environment Variables

Available Tools

Navigation

Screenshots & Content

Interaction

Utilities

Examples

Navigate and Screenshot

User: Go to example.com and take a screenshot
AI: [Uses browser_navigate with url="https://example.com"]
A