mcp-web

MCP server web automation untuk Termux — buka web, klik, isi formulir, telusuri DOM, dan debug langsung dari AI. Murni Node.js, dibangun dari nol, tanpa Chromium, tanpa root, tanpa proot, tanpa aplikasi desktop.

Apa ini?

mcp-web adalah server Model Context Protocol yang memberikan kemampuan web automation kepada AI (misal. opencode). Server ini dibuat murni dari nol: protokol JSON-RPC/MCP, transport stdio dan HTTP/SSE, hingga engine halaman — semuanya kode sendiri, dengan satu-satunya dependensi runtime linkedom (parser DOM ringan, murni JavaScript).

Semua berjalan di terminal Termux biasa. Tidak ada browser engine yang berat, tidak perlu akses root, tidak perlu proot/container, tidak perlu X11/desktop.

Related MCP server: termux-puppeteer-mcp

Fitur

• Dua mode transport:

  • stdio — untuk opencode lokal di Termux (default).

  • serve — mode remote HTTP + SSE; bisa dipakai dari perangkat lain di jaringan.

• 14 tools MCP untuk web automation & debugging:

• State per sesi: cookie store, history, network log, console log — konsisten antar panggilan tool.

• Aman: navigate hanya http/https, js_eval berjalan di vm terisolasi dengan timeout, ukuran halaman dibatasi (5 MB) anti boros memori.

• Offline testable: seluruh test memakai server HTTP lokal, tanpa jaringan eksternal.

Instalasi

Persyaratan: Node.js ≥ 20 di Termux (pkg install nodejs) dan npm.

cd ~
git clone https://github.com/nemoobc/mcp-web.git
cd mcp-web
npm install

Tanpa root, tanpa proot, tanpa Chromium — cukup Node.js standar.

Cara pakai

1. Mode lokal (stdio) untuk opencode

Tambahkan MCP server di ~/.config/opencode/opencode.json:

{
  "mcp": {
    "mcp-web": {
      "type": "stdio",
      "command": "node",
      "args": ["/data/data/com.termux/files/home/mcp-web/bin/mcp-web.js", "stdio"]
    }
  }
}

2. Mode remote (HTTP + SSE) dari perangkat lain

Di Termux:

node bin/mcp-web.js serve --port 3827

Di perangkat lain (mis. PC/laptop), daftarkan URL remote di opencode:

{
  "mcp": {
    "mcp-web": {
      "type": "remote",
      "url": "http://IP_TERMUX:3827/sse"
    }
  }
}

Cek kesehatan server: curl http://localhost:3827/health → {"ok":true,...}.

Contoh alur

navigate  → https://example.com
query     → a, button, input
click     → a                       (ikuti link)
get_content → text                  (baca isi halaman target)
history   → back
submit    → #search                 (form GET diikuti)
network_logs →                      (debug request/response)

Batasan (dijelaskan dengan jujur)

Karena berjalan tanpa Chromium, mcp-web tidak melakukan rendering visual piksel, eksekusi JavaScript halaman penuh, atau layout CSS. Yang disediakan adalah:

• DOM asli hasil parsing HTML (parsing cepat & ringan).

• Navigasi, klik, isi form, dan traversal DOM.

• Eksekusi JavaScript melalui sandbox vm yang aman (ekspresi, bukan renderer).

• Snapshot struktural (teks / HTML / metadata) — bukan gambar bitmap.

Untuk halaman yang sangat bergantung pada rendering penuh (SPA kompleks, canvas, WebGL), gunakan solusi browser sungguhan bila tersedia. mcp-web unggul untuk: riset isi web, pengujian struktur halaman, scraping, dan debugging HTTP/DOM dari terminal.

Struktur proyek

mcp-web/
├── bin/mcp-web.js        # entry CLI (stdio / serve)
├── src/
│   ├── protocol.js       # protokol JSON-RPC 2.0 + MCP (murni)
│   ├── stdio.js          # transport stdio
│   ├── http.js           # transport HTTP + SSE (remote)
│   ├── browser.js        # engine halaman (fetch + DOM model)
│   └── tools.js          # registrasi 14 tool MCP
└── tests/                # test otomatis (node --test, offline)

Pengembangan

npm test        # jalankan seluruh test (30 test, offline)
npm start       # jalankan server remote di port 3827

Lisensi

MIT © 2026 Nemo.

Dibuat dengan karya sendiri, dari nol. Created by Nemo.