vscode-browser MCP
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.
vscode-browser MCP
MCP server untuk mengendalikan browser dari AI agent. Menyediakan dua mode:
Playwright headless (
playwright-core) — cepat dan ringan, cocok untuk otomasi umum.Integrated Browser VS Code — memakai mesin browser bawaan VS Code sehingga lebih tahan terhadap proteksi anti-bot (mis. Cloudflare).
Halaman juga dapat ditampilkan sebagai live screencast di tab VS Code melalui extension pendukung.
Dibangun di atas
@modelcontextprotocol/sdk,playwright-core, danws.
Daftar Tool
Tool browser Playwright (headless)
Tool | Fungsi |
| Buka URL dan (opsional) tampilkan viewer di tab VS Code |
| Tampilkan ulang viewer untuk halaman aktif |
| Ambil accessibility snapshot (teks) untuk memilih selector |
| Klik elemen via selector Playwright |
| Isi field input (opsional tekan Enter) |
| Tekan tombol keyboard |
| Jalankan ekspresi JavaScript di halaman |
| Ambil pesan console/error |
| Kelola daftar tab |
| Ubah viewport (uji responsif) |
| Reload / kembali |
| Simpan screenshot ke file |
| Status bridge screencast & panel |
| Tutup browser & panel |
Tool Integrated Browser VS Code
Tool | Fungsi |
| Buka halaman di Integrated Browser, kembalikan |
| Baca snapshot ARIA halaman aktif |
| Klik elemen memakai |
| Ketik teks / tekan tombol pada elemen |
| Navigasi, |
| Daftar halaman yang dibagikan |
| Screenshot halaman Integrated Browser |
| Jalankan potongan kode Playwright pada halaman |
| Status page yang dikendalikan |
Related MCP server: Cloudflare Playwright MCP
Arsitektur singkat
AI Agent (Cline/Roo/klien MCP)
│ stdio (MCP)
▼
src/server.js ──► src/tools.js
│ │
│ ├─► src/browser.js (Playwright headless: msedge/chrome)
│ ├─► src/viewer.js (panel live, HTTP ke extension port 47823)
│ └─► src/integrated.js (Integrated Browser via extension port 47823)
│
└─► src/bridge.js (WebSocket screencast, :47824, token)Penting: fitur Integrated Browser dan live viewer bergantung pada extension VS Code
FMK VSCode Browser yang menyediakan HTTP API lokal di 127.0.0.1:47823. Extension ini
merupakan komponen terpisah dan tidak termasuk dalam repo ini. Tanpa extension tersebut,
semua tool Playwright tetap berfungsi, tetapi tool browser_integrated_* akan gagal
(fetch failed).
Prasyarat
Node.js 18+
Google Chrome atau Microsoft Edge terpasang.
playwright-coretidak membundel browser; ia memakai channelmsedgelaluchrome. Jika tidak ada, setBROWSER_EXECUTABLE.(Opsional) Extension FMK VSCode Browser untuk fitur tab VS Code.
Instalasi
npm installJalankan server:
npm startServer berkomunikasi lewat stdio (standar MCP), dan membuka bridge WebSocket di
ws://127.0.0.1:47824/view untuk screencast.
Konfigurasi Environment
Variabel | Default | Keterangan |
| (kosong) | Path Chrome/Edge lain. Kosong = pakai channel |
|
|
|
|
| Port WebSocket viewer bridge |
| (acak) | Token akses bridge |
|
| Port HTTP API extension VS Code |
|
|
|
| (kosong) | Page ID Integrated Browser awal |
Lihat .env.example untuk contoh. Jangan commit file .env berisi rahasia.
Menambahkan ke klien MCP (contoh Cline/Roo)
Tambahkan entri berikut ke konfigurasi MCP klien Anda (sesuaikan path clone):
{
"mcpServers": {
"vscode-browser": {
"command": "node",
"args": ["/path/ke/mcp-vscode-browser/src/server.js"],
"env": {
"HEADLESS": "0"
}
}
}
}Gunakan
HEADLESS=0bila banyak situs menolak akses headless.
Menjalankan extension VS Code (opsional)
Untuk mengaktifkan Integrated Browser & live viewer:
Pasang extension FMK VSCode Browser (
fmkelana.fmk-vscode-browser) di VS Code.Reload window VS Code (
Developer: Reload Window) agar server di port47823aktif.Verifikasi:
curl http://127.0.0.1:47823/statusharus mengembalikan{"ok":true,...}.
Struktur Proyek
.
├─ src/
│ ├─ server.js # entry point MCP (stdio + bridge)
│ ├─ tools.js # registrasi semua tool MCP
│ ├─ browser.js # Playwright headless (navigate/click/screenshot/…)
│ ├─ bridge.js # WebSocket screencast viewer
│ ├─ viewer.js # klien HTTP ke extension (panel live)
│ ├─ integrated.js # klien Integrated Browser (extension :47823)
│ ├─ selftest.js # uji cepat browser
│ ├─ mcptest.js # uji end-to-end via MCP client
│ └─ bridgetest.js # uji bridge WebSocket
├─ .env.example
├─ .gitignore
├─ package.json
└─ README.mdTesting
npm run selftest # uji navigate, snapshot, evaluate, console
npm run test:mcp # uji end-to-end lewat MCP client
npm run test:bridge # uji WebSocket bridgeSkrip test memakai URL default https://fmkelana.fmk; ubah lewat env SELFTEST_URL
mis. SELFTEST_URL=https://example.com npm run selftest.
Troubleshooting
fetch failedpadabrowser_integrated_*/browser_show_panel→ extension belum aktif. Reload window VS Code lalu pastikan port47823listen.Cloudflare "Just a moment…" / status 403 → headless mudah terdeteksi. Jalankan dengan
HEADLESS=0dan/atau gunakan Integrated Browser.Situs anti-bot ketat (mis. Shopee) menampilkan halaman verifikasi → umumnya butuh sesi login dan reputasi IP bersih; otomasi anonim akan ditolak oleh server.
Gagal meluncurkan browser headless→ Chrome/Edge tidak terpasang. SetBROWSER_EXECUTABLEke path browser.
Keamanan
Bridge hanya bind ke
127.0.0.1dan memakai token acak per sesi.Jangan commit file berisi rahasia (
.env, backup konfigurasi MCP pribadi). Aturan ini sudah ditangani oleh.gitignore.
Lisensi
MIT
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.
A real browser for your agent: screenshots, page checks, Markdown and PDFs.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser for web automation tasks like navigation, typing, clicking, and taking screenshots.Apache 2.0
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser for web automation tasks such as navigation, typing, clicking, and taking screenshots.Apache 2.0
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to control a browser through a set of tools, allowing them to perform web automation tasks like navigation, typing, clicking, and taking screenshots.Apache 2.0
- 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