brave-bridge
Allows AI agents to control a running Brave (or Chromium) browser through an extension and local bridge, enabling tab navigation, DOM inspection, clicking, form filling, screenshots, PDFs, device emulation, cookie/storage access, and console/network capture without relaunching the browser.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AniEvo Brave Bridge
Bahasa: Bahasa Indonesia | English
Kontrol browser Brave (atau Chromium apa pun) yang lagi jalan, tanpa perlu close atau relaunch pakai --remote-debugging-port. Sesi login, cookie, dan tab lu tetap utuh.
Dibuat buat AI coding agent (Antigravity, Claude Code, Gemini CLI, dll.) supaya bisa buka halaman, baca DOM, klik, isi form, screenshot, sampai capture console/network di browser asli lu, cukup lewat satu CLI.
π§© Extension MV3 + CLI Node.js tanpa dependency (Node β₯ 18)
π Cuma localhost, pakai token auth, dan Origin extension di-pin
ποΈ Tab buatan agent otomatis masuk tab group sendiri (mendukung isolasi tab group per sesi untuk multi-agent paralel), dan tab milik user dilindungi guard
π«₯ Nggak nyolong fokus: tab agent dibuka dan dikerjain di background (klik, isi form, input trusted, screenshot), jadi lu tetap stay di tab lu
π οΈ Mode CDP opsional via
chrome.debugger(tetap tanpa relaunch)π€ MCP server & Antigravity Plugin bawaan: 33 tool
browser_*+plugin.jsonsiap pasang di Antigravity / Claude Code / Gemini CLIποΈ Popup UI di toolbar Brave: lihat status koneksi live, daftar tab group agent aktif, dan tombol Close All Agent Tabs sekali klik
Arsitektur
flowchart LR
MCP["AI Agent (MCP Client)"] -- "stdio JSON-RPC<br/>(33 browser_* tools)" --> M["brave-bridge mcp"]
M -- "HTTP + X-Bridge-Token<br/>(auto-start serve)" --> S["brave-bridge.mjs serve<br/>127.0.0.1:8787"]
CLI["CLI / Shell Agent"] -- "HTTP + X-Bridge-Token" --> S
S -- "WebSocket /ws<br/>(Pinned chrome-extension://id)" --> E["Extension MV3<br/>service worker"]
E -- "chrome.tabs / scripting / debugger" --> B["Brave yang lagi jalan"]Extension nggak buka port. Dia yang konek keluar lewat WebSocket ke server lokal, jadi cukup di-load sekali dan Brave nggak perlu ditutup lagi.
Related MCP server: dev-browser-mcp
Instalasi
Via npm / npx (paling cepat)
npx anievo-brave-bridge extension-path # ekstrak extension ke ~/.brave-bridge/brave-extension
npx anievo-brave-bridge serve # jalankan server bridgeAtau via Git clone
git clone https://github.com/AniEvo-ID/anievo-brave-bridge.git ~/.brave-bridge
cd ~/.brave-bridgeJalankan server (yang pertama kali akan membuat
config.jsonberisi token rahasia):node brave-bridge.mjs serveLoad extension di Brave: buka
brave://extensionsβ nyalakan Developer mode β Load unpacked β pilih folderbrave-extension/.Badge extension berubah jadi ON (hijau). Cek koneksi:
curl -s http://127.0.0.1:8787/health # "ext": true node brave-bridge.mjs status(Opsional) jalan otomatis tiap login (Windows Startup, macOS
launchdLaunchAgent, Linuxsystemd --user):node brave-bridge.mjs install-autostart # hapus: uninstall-autostartLog server ditulis ke
server.log.
Waktu extension pertama kali konek, ID-nya otomatisdi-pin di config.json. Kalau lu pindah folder extension (ID-nya jadi beda), jalankan serve --reset-ext.
MCP Server (33 Tool browser_*) & Integrasi AI Agent
AniEvo Brave Bridge sudah membawa MCP Server stdio zero-dependency bawaan (33 tool browser_*) sehingga AI agent (Antigravity, Claude Code, Cursor, Windsurf, Cline, DeepSeek, Gemini CLI) bisa mengontrol Brave secara native tanpa lewat shell. Kalau server bridge lokal belum jalan, proses MCP otomatis menyalakannya di background.
π‘ Tips cepat: Klik icon AniEvo Brave Bridge di toolbar Brave β klik tombol Copy MCP Config (JSON), atau jalankan
node brave-bridge.mjs mcp-config.
1. Pasang via npx (Tanpa Clone Manual)
Tambahkan ke konfigurasi MCP client lu (mcp_config.json / claude_desktop_config.json / .cursor/mcp.json):
{
"mcpServers": {
"brave-bridge": {
"command": "npx",
"args": ["-y", "anievo-brave-bridge", "mcp"]
}
}
}2. Pasang dari Clone Lokal (~/.brave-bridge)
{
"mcpServers": {
"brave-bridge": {
"command": "node",
"args": ["C:\\Users\\<User>\\.brave-bridge\\brave-bridge.mjs", "mcp"]
}
}
}3. Shortcut per Platform AI Agent
Google Antigravity (Plugin All-in-One β MCP + Skill + Rules):
git clone https://github.com/AniEvo-ID/anievo-brave-bridge.git ~/.gemini/config/plugins/anievo-brave-bridgeClaude Code:
claude mcp add brave-bridge -- npx -y anievo-brave-bridge mcpCursor / Windsurf / Cline / Roo / DeepSeek Harness: tempel JSON
mcpServersdi atas ke pengaturan MCP.Gemini CLI: tempel blok
mcpServersdi atas ke~/.gemini/settings.json.
(Untuk multi-terminal / multi-agent paralel di mana tiap proses MCP butuh tab group terpisah otomatis, tambahkan "--auto-session" di akhir args).
Daftar Lengkap 33 Tool MCP
Grup | Tool MCP |
Tab & Sesi (6) |
|
Inspeksi DOM (6) |
|
Interaksi & JS (12) |
|
State & Emulasi (3) |
|
Visual & Debug (6) |
|
Alur standar agent: browser_open β browser_snapshot β interaksi pakai ref @N β browser_screenshot β browser_close_group.
Pemakaian CLI (Standalone / Fallback Non-MCP)
node brave-bridge.mjs <command> [args] [--flags]Alur kerja tipikal (agent)
node brave-bridge.mjs new https://example.com # tab baru -> group "Antigravity" (ungu)
node brave-bridge.mjs snapshot --tabId 123 # daftar elemen interaktif + ref @N
node brave-bridge.mjs fill @2 "halo@contoh.com" --tabId 123
node brave-bridge.mjs click @5 --tabId 123
node brave-bridge.mjs waitFor --text "Berhasil" --tabId 123
node brave-bridge.mjs shot --tabId 123
node brave-bridge.mjs close-group # tutup semua tab group "Antigravity"Daftar command
Kategori | Command |
Info |
|
Tab |
|
Baca |
|
Eval |
|
Interaksi |
|
Cookies/Storage |
|
Tunggu |
|
Screenshot, PDF & Emulasi |
|
Console/Network |
|
Maintenance & MCP |
|
Flag global: --tabId N, --session <id>, --timeout ms, --json, --frame N|all, --force, --no-group, --foreground, --activate, --all-sessions
Isolasi tab group per sesi (multi-agent paralel)
Kalau beberapa agent jalan barengan (mis. swarm / subagent / beberapa terminal), kasih ID sesi supaya close-group satu agent nggak ikut nutup tab agent lain:
# CLI (atau set env BRAVE_BRIDGE_SESSION=worker-1)
node brave-bridge.mjs new https://example.com --session worker-1 # -> group "Antigravity-worker-1"
node brave-bridge.mjs close-group --session worker-1 # cuma nutup group sesi worker-1
node brave-bridge.mjs close-group --all-sessions # bersihin semua group sesi sekaligusTiap sesi otomatis dapet warna tab group sendiri dan dilindungi cross-session guard (sesi
worker-1ditolak kalau nyoba ngubah tab milikworker-2).Di MCP: kirim parameter
session: "worker-1"dibrowser_open/browser_close_group, atau jalankannode mcp.mjs --auto-session(envBRAVE_BRIDGE_AUTO_SESSION=1) supaya tiap proses MCP punya ID sesi unik otomatis.
Kerja di background (fokus user aman)
Tab baru selalu dibuka di background dan semua command jalan tanpa ngaktifin tab itu. Ini termasuk input trusted --cdp dan screenshot, bahkan waktu window Brave lagi di-minimize. Jadi lu bisa tetap kerja di tab lu sendiri sementara agent jalan di tab group-nya.
Mau | Pakai |
Tab baru langsung aktif |
|
Aktifkan tab agent sebentar lalu balikin fokus (buat situs yang butuh tab kelihatan) |
|
Pindah ke tab secara permanen |
|
Halaman di tab background bisa kena throttling timer dari browser (setInterval jadi minimal sekitar 1 detik). waitFor tetap responsif karena pakai MutationObserver.
Selector
Bentuk | Contoh | Keterangan |
CSS |
| Otomatis cari juga ke dalam open shadow root |
Ref snapshot |
| Dari output |
Teks |
| Ambil elemen terkecil yang kelihatan, lalu naik ke elemen interaktif terdekat |
Shadow eksplisit |
| Tembus shadow DOM bertingkat |
Iframe |
| Lihat ID frame dengan |
Mode CDP (opsional)
Kalau ditambah --cdp (atau lewat capture, upload, shot --full, dan fallback eval di halaman yang CSP-nya ketat), extension nempel ke tab lewat chrome.debugger. Tetap tanpa relaunch. Yang jadi bisa:
Input trusted (
event.isTrusted === true):click --cdp,key --cdp,type --cdp. Jalan juga di tab background, karena debugger di-attach dulu sebelum koordinat dihitung dan pakai focus emulation.evalyang tembus CSP (Runtime.evaluate), termasuk top-levelawaitCapture console dan network, plus isi response (
net --body)Upload file ke
<input type="file">Screenshot full page
Selama debugger nempel, Brave nampilin bar"β¦ started debugging this browser". Bar ini otomatis hilang begitu perintahnya selesai, kecuali kalau lagi capture start (hilang setelah capture stop).
Keamanan
Bridge ini bisa ngejalanin JavaScript di tab mana pun, jadi pengamanannya dibikin ketat:
Lapisan | Perlindungan |
Jaringan | Server cuma listen di |
Auth CLI |
|
Website | Tanpa header CORS. Request yang bawa Origin |
Extension | WebSocket cuma nerima Origin |
Job | ID acak (UUID) + |
Tab user | Guard: aksi yang ngubah tab (klik, isi, navigasi, eval, β¦) ditolak kalau tab-nya di luar group default, kecuali pakai |
Jangan commit atau shareconfig.json, karena isinya token. File ini udah masuk .gitignore.
Konfigurasi (config.json)
{
"token": "β¦dibuat otomatisβ¦",
"defaultGroup": "Antigravity",
"defaultColor": "purple",
"guard": true,
"extId": "β¦di-pin otomatisβ¦"
}Environment variable: BRAVE_BRIDGE_PORT (default 8787), BRAVE_BRIDGE_TIMEOUT (default 45000 ms), BRAVE_CDP_ARTIFACTS (folder screenshot, default ~/.brave-cdp/artifacts).
Batasan
Nggak bisa inject ke halaman internal (
brave://,chrome://, Chrome Web Store).Shortcut native browser (mis.
Ctrl+T) nggak bisa dipicu, termasuk lewat--cdp.shotdi tab aktif pakaicaptureVisibleTab(tanpa debugger). Di tab background dan--fullpakai CDP, jadi bar "debugging" sempat muncul sebentar.--cdp clickbelum mendukung elemen di dalam iframe.Kalau DevTools lagi kebuka di tab yang sama, attach debugger bisa gagal.
Testing & CI
Test suite otomatis (node:test, tetap tanpa dependency eksternal) menguji batas keamanan server, alur E2E extension di Chromium terisolasi (--user-data-dir terpisah, tidak menyentuh profil browser utama), isolasi tab group per sesi, dan protokol MCP:
npm testSetiap push dan Pull Request otomatis diuji di GitHub Actions pada Ubuntu (Xvfb) dan Windows (--headless=new) menggunakan Chrome for Testing.
Lisensi
MIT Β© 2026 AniEvo-ID
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Cloud browsers for AI agents: saved logins, residential IPs, live human takeover, 57 browser tools.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to control a browser with 30 tools for navigation, interaction, extraction, and tab management, supporting human-like browser automation.368 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to control a persistent Chromium browser or attach to an existing Chrome with sandboxed JavaScript and structured tools for web interaction and automation.16MIT
- FlicenseBqualityBmaintenanceEnables AI agents to control existing Chrome and Firefox browser sessions locally, including tab management, navigation, form filling, screenshots, and persistent scripts, without remote relays or debugging ports.36-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser through tools for web automation tasks such as navigation, typing, clicking, and taking screenshots.Apache 2.0