Provides comprehensive browser automation capabilities using Brave Browser, including automatic installation, navigation, content extraction, interaction simulation, video/media extraction, and network traffic monitoring with built-in ad-blocking and anti-detection features.
Provides anti-detection capabilities to bypass Cloudflare and other security systems during browser automation.
Comes pre-installed with uBlock Origin extension to provide built-in ad-blocking and tracker prevention during browser automation sessions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Brave Real Browser MCP Serverscrape the latest tech news from Hacker News and save it as markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Brave Real Browser MCP Server
AI assistants के लिए powerful, anti-detection browser automation - Unified MCP+LSP+SSE ecosystem
🚀 Quick Start
Option 1: NPX (Recommended for AI IDEs)
{
"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"
}
}
}
}Option 1: NPX (Recommended for Opencode AI IDEs)
{
"$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 ✅
✅ MCP Protocol STDIO - Tools exposed to AI agents
✅ LSP Protocol - Code intelligence in IDEs
✅ SSE Streaming - Real-time progress updates
✅ Auto-sync - Browser state persistence
✅ Progress Notifications - Live feedback
✅ 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 |
| Block images, fonts, CSS for faster loading |
| Set custom HTTP headers |
| Custom referrer URL |
| Wait for specific element after load |
| Wait for specific text content |
| Auto-scroll for lazy loading |
| Human-like delay (100-500ms) |
| Bypass Content Security Policy |
🚀 Parallel Scraping (js_scrape)
Option | Description |
| Array of multiple URLs to scrape |
| Max concurrent scrapes (1-10) |
| Continue even if some URLs fail |
| Delay between scrapes (ms) |
📄 Auto-Pagination (link_harvester)
Option | Description |
| Auto-follow pagination links |
| Maximum pages to scrape (1-20) |
| Custom next page selector |
| Delay between pages (ms) |
🔌 API Interceptor (network_recorder)
Option | Description |
|
|
| URL patterns to block |
| Fake responses for URLs |
| Modify request headers |
| Capture POST/PUT bodies |
🌐 Unified MCP+LSP+SSE Ecosystem
एक command से सब active:
npm run devOutput:
🦁 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 |
| MCP over HTTP |
MCP |
| SSE real-time streaming |
MCP |
| SSE message handler |
LSP |
| Autocomplete |
LSP |
| Hover documentation |
LSP |
| TypeScript analysis |
LSP |
| Go to definition |
LSP |
| Find references |
Other |
| Health check |
Other |
| 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 |
| Initialize Brave browser with stealth |
| Close browser instance |
Navigation
Tool | Description |
| Navigate to URL with advanced options (resource blocking, custom headers, auto-scroll) |
| Wait for conditions |
Content
Tool | Description |
| Get page HTML/text |
| Find by selector/text/AI with batch mode |
| Save as markdown file |
Interaction
Tool | Description |
| Click on element |
| Type text into input |
| Keyboard press |
| Natural scrolling |
| Solve CAPTCHAs |
Media & Streaming
Tool | Description |
| Extract streams with multi-quality selector, VidSrc/Filemoon/StreamWish support |
| Hook into JWPlayer, Video.js, HLS.js, Plyr, Vidstack, DASH.js |
| Deep iframe scraping with video source extraction |
Scraping
Tool | Description |
| JavaScript-rendered scraping with parallel URL support |
| Harvest links with auto-pagination |
| Record traffic with API interception |
| Extract embedded JSON with AES decryption |
| Regex search like regex101.com + inline flags |
Advanced
Tool | Description |
| Meta/OG tags |
| Full page analysis with screenshot |
| Trace redirects |
| Track progress |
| Manage cookies |
| Download files |
| Run custom JavaScript |
| 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 |
|
| Server port |
|
| Server host |
|
| 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