MCP Browser Tool

Alat browser otomatis berbasis Playwright untuk AI Agent yang memungkinkan agent melakukan pencarian web, navigasi, scraping, dan otomatisasi halaman melalui protokol Model Context Protocol (MCP).

Fitur

• Pencarian Web - Cari informasi dari berbagai mesin pencari (DuckDuckGo, Bing, Brave, Mojeek)

• Navigasi Halaman - Buka URL, scroll, back/forward, refresh halaman

• Scraping Konten - Ambil teks, HTML, screenshot, tabel, dan JSON-LD dari halaman

• Interaksi Halaman - Klik elemen, ketik teks, tekan tombol keyboard, upload file

• Manajemen Tab - Buka, tutup, dan pindah antar tab browser (maks. 8 tab)

• Session Management - Simpan dan muat session browser (termasuk cookies & localStorage)

• Anti Deteksi - Stealth mode untuk menghindari deteksi bot

• Network Monitoring - Tangkap dan filter request/response API

Related MCP server: Rod MCP Server

Cara Penggunaan

Prasyarat

• Node.js 18+

• Playwright browser binaries (install dengan npx playwright install chromium)

Instalasi

npm install
npx playwright install chromium
npm run build

Menjalankan

npm start

Atau untuk development:

npm run dev

Konfigurasi MCP

Tambahkan ke konfigurasi MCP client (seperti Claude Desktop, Zed, Nalar, dll.):

{
  "mcpServers": {
    "browser-tool": {
      "command": "node",
      "args": ["/path/to/mcp-browser-tool/dist/index.js"]
    }
  }
}

Opsi CLI

Contoh dengan direktori kustom:

{
  "mcpServers": {
    "browser-tool": {
      "command": "node",
      "args": [
        "/path/to/mcp-browser-tool/dist/index.js",
        "--sessions-dir", "/path/ke/sessions",
        "--downloads-dir", "/path/ke/downloads"
      ]
    }
  }
}

Catatan: Secara default, direktori sessions/ dan downloads/ dibuat di dalam folder mcp-browser-tool itu sendiri — bukan di current working directory (CWD) proses. Ini mencegah polusi direktori di project lain saat MCP server dijalankan.

Lisensi

MIT