Skip to main content
Glama
codeiva4u

Brave Real Browser MCP Server

by codeiva4u

Brave Real Browser MCP Server

AI assistants के लिए powerful, anti-detection browser automation - Unified MCP+LSP+SSE ecosystem

License: MIT npm version

🚀 Quick Start

{ "mcpServers": { "brave-real-browser": { "command": "npx", "args": ["brave-real-browser-mcp-server@latest"], "env": { "HEADLESS": "false" } } } }

Option 2: (Local AI IDEs)

{ "mcpServers": { "brave-real-browser": { "command": "node", "args": [ "c:\\Users\\Admin\\Desktop\\Workspace-For-Brave-Real-browser-Mcp-Server\\Brave-Real-Browser-Mcp-Server\\dist\\index.js" ], "env": { "HEADLESS": "false" } } } }
{ "$schema": "https://opencode.ai/config.json", "mcp": { "brave-real-browser": { "type": "local", "command": ["npx", "-y", "brave-real-browser-mcp-server@latest"], "environment": { "HEADLESS": "false" }, "enabled": true } } }

Option 2: ( Locle for Opencode AI IDEs)

{ "$schema": "https://opencode.ai/config.json", "mcp": { "brave-real-browser": { "type": "local", "command": ["node", "c: path hare "], "environment": { "HEADLESS": "false" }, "enabled": true } } }

Option 2: Unified Server (Full Features)

1. MCP (Model Context Protocol) ✅

2. LSP (Language Server Protocol) ✅

3. SSE Real-time streaming updates during tool execution ✅

  1. MCP Protocol STDIO - Tools exposed to AI agents

  2. LSP Protocol - Code intelligence in IDEs

  3. SSE Streaming - Real-time progress updates

  4. Auto-sync - Browser state persistence

  5. Progress Notifications - Live feedback

  6. Session Management - Connection resilience

All three protocols (MCP, LSP, SSE) are now fully compatible and can work together seamlessly!

npm run dev

✨ Features

Feature

Description

28 MCP Tools

Complete browser automation toolkit

Unified Server

MCP + SSE + LSP in one command

Captcha Solving

reCAPTCHA, hCaptcha, Turnstile

Brave Browser

Auto-detection

TypeScript Analyzer

Full Compiler API integration

Real-time Streaming

SSE for live progress updates

Auto-Sync

SharedEventBus connects all protocols


🔄 brave-real-blocker Auto-Sync (GitHub Action)

Automatic filter updates every 6 hours:

  • Includes EasyList, EasyPrivacy

  • Extracts popup, redirect, scriptlet rules

  • Triggers version bump on filter updates

🆕 New in v2.28.1 - Advanced Enhancements

🌐 Advanced Navigation

Option

Description

blockResources

Block images, fonts, CSS for faster loading

customHeaders

Set custom HTTP headers

referrer

Custom referrer URL

waitForSelector

Wait for specific element after load

waitForContent

Wait for specific text content

scrollToBottom

Auto-scroll for lazy loading

randomDelay

Human-like delay (100-500ms)

bypassCSP

Bypass Content Security Policy

🚀 Parallel Scraping (js_scrape)

Option

Description

urls

Array of multiple URLs to scrape

concurrency

Max concurrent scrapes (1-10)

continueOnError

Continue even if some URLs fail

delayBetween

Delay between scrapes (ms)

Option

Description

followPagination

Auto-follow pagination links

maxPages

Maximum pages to scrape (1-20)

paginationSelector

Custom next page selector

delayBetweenPages

Delay between pages (ms)

🔌 API Interceptor (network_recorder)

Option

Description

interceptMode

record, intercept, or mock

blockPatterns

URL patterns to block

mockResponses

Fake responses for URLs

modifyHeaders

Modify request headers

capturePayloads

Capture POST/PUT bodies

🌐 Unified MCP+LSP+SSE Ecosystem

एक command से सब active:

npm run dev

Output:

🦁 Brave Real Browser - Unified Server v2.28.1 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📡 HTTP Server: http://localhost:3000 🛠️ Available MCP Tools: 🚀 browser_init 🔴 browser_close 🌐 navigate 📄 get_content 🔍 find_element 🖱️ click ⌨️ type 🤖 solve_captcha 🎬 media_extractor ... and 24 more tools 🔗 SharedEventBus: Auto-syncing MCP ↔ LSP ↔ SSE 📋 Total: 28 MCP tools | TypeScript Analyzer Active ✅ Ready! All protocols unified and auto-synced.

All Endpoints:

Category

Endpoint

Purpose

MCP

POST /mcp

MCP over HTTP

MCP

GET /mcp/sse

SSE real-time streaming

MCP

POST /mcp/message

SSE message handler

LSP

POST /lsp/completion

Autocomplete

LSP

POST /lsp/hover

Hover documentation

LSP

POST /lsp/analyze

TypeScript analysis

LSP

POST /lsp/definition

Go to definition

LSP

POST /lsp/references

Find references

Other

GET /health

Health check

Other

GET /events

Event bus stats


🛡️ Ad Blocking & Stealth (brave-real-blocker)

Auto-enabled on all pages via ecosystem chain:

(With Chain): ──────────────── brave-real-browser-mcp-server ← Top Level This! └── brave-real-puppeteer-core ← Only this! └── brave-real-launcher └── brave-real-blocker ← Single instance, shared!

Core Features

Feature

Description

AdBlocking

Network-level ad/tracker blocking with uBlock Origin filters

Stealth

Native function masking (prompt, alert, confirm)

RedirectBlocking

Popup, window.open interception, tracking param removal

ScriptletInjection

Anti-adblock bypass with uBlock scriptlets

CosmeticFiltering

Element hiding with CSS injection

🛠️ All 28 MCP Tools

Browser Management

Tool

Description

browser_init

Initialize Brave browser with stealth

browser_close

Close browser instance

Navigation

Tool

Description

navigate

Navigate to URL with advanced options (resource blocking, custom headers, auto-scroll)

wait

Wait for conditions

Content

Tool

Description

get_content

Get page HTML/text

find_element

Find by selector/text/AI with batch mode

save_content_as_markdown

Save as markdown file

Interaction

Tool

Description

click

Click on element

type

Type text into input

press_key

Keyboard press

random_scroll

Natural scrolling

solve_captcha

Solve CAPTCHAs

Media & Streaming

Tool

Description

stream_extractor

Extract streams with multi-quality selector, VidSrc/Filemoon/StreamWish support

player_api_hook

Hook into JWPlayer, Video.js, HLS.js, Plyr, Vidstack, DASH.js

iframe_handler

Deep iframe scraping with video source extraction

Scraping

Tool

Description

js_scrape

JavaScript-rendered scraping with parallel URL support

link_harvester

Harvest links with auto-pagination

network_recorder

Record traffic with API interception

extract_json

Extract embedded JSON with AES decryption

search_regex

Regex search like regex101.com + inline flags (?i), (?m), (?s), (?u) support

Advanced

Tool

Description

scrape_meta_tags

Meta/OG tags

deep_analysis

Full page analysis with screenshot

redirect_tracer

Trace redirects

progress_tracker

Track progress

cookie_manager

Manage cookies

file_downloader

Download files

execute_js

Run custom JavaScript

form_automator

Auto-fill forms with human-like typing


📋 Commands

# Install npm install # Build npm run build # Development (Unified - Recommended!) npm run dev # MCP + SSE + LSP on port 3000 # Alternate modes npm run dev:stdio # STDIO only (for AI IDEs) npm run dev:sse # SSE standalone npm run dev:http # HTTP Stream standalone # Production npm start # Unified server npm run start:stdio # STDIO mode # Tests npm test npm run test:e2e

⚙️ Environment Variables

Variable

Default

Description

MCP_PORT

3000

Server port

MCP_HOST

localhost

Server host

DEBUG

false

Debug logging


🔧 Browser Options

{ "headless": false, "proxy": "http://proxy:8080" }

📋 Prerequisites

  • Node.js >= 18.0.0

  • Brave Browser (auto-detected)


🐛 Troubleshooting

Port in use

MCP_PORT=3001 npm run dev

📄 License

MIT License - see LICENSE


Made with ❤️ by codeiva4u

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/codeiva4u/Brave-Real-Browser-Mcp-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server