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)
Option 2: (Local AI IDEs)
Option 1: NPX (Recommended for Opencode AI IDEs)
Option 2: ( Locle for Opencode AI IDEs)
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!
✨ 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:
Output:
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:
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
⚙️ Environment Variables
Variable | Default | Description |
|
| Server port |
|
| Server host |
|
| Debug logging |
🔧 Browser Options
📋 Prerequisites
Node.js >= 18.0.0
Brave Browser (auto-detected)
🐛 Troubleshooting
Port in use
📄 License
MIT License - see LICENSE
Made with ❤️ by codeiva4u