⚡ Stockbit Desktop Bridge, MCP Server & Custom Dashboard

Jembatan data real-time berbasis Chrome DevTools Protocol (CDP) untuk aplikasi Stockbit Desktop (Tauri v2 + WebView2) yang menghubungkan portofolio & data pasar IDX langsung ke AI Assistant (Claude, Cursor, Antigravity) via Model Context Protocol (MCP) dan antarmuka web dashboard kustom.

🌟 Fitur Utama

• 🧠 AI-Ready via MCP (Model Context Protocol): Hubungkan data portofolio, antrean order, dan analisis broker langsung ke AI Assistant untuk evaluasi portofolio, screening emiten, dan bandarmologi.

• 🔒 Zero-Credential Storage: Tidak pernah menyimpan password, PIN trading, atau token di file disk. Token sesi aktif dibaca secara aman langsung dari runtime WebView2 saat aplikasi berjalan.

• 📊 Real-Time Web Dashboard: Antarmuka visual modern bertema Fintech/Cyberpunk di http://localhost:3030 yang menampilkan ringkasan modal, floating P&L, holdings, orderbook 10-level, dan bandarmologi top broker.

• 🎯 Akses Lengkap ke Ekosistem Stockbit:

  • Carina API: Portofolio riil, kas RDN, riwayat & antrean order bursa, sub-account sekuritas.

  • Exodus API: Watchlist, orderbook kedalaman pasar, broker summary (akumulasi/distribusi), profil emiten, status sesi IDX.

• 🛡️ Aman & Read-Only: Hanya menyediakan akses pembacaan data. Tidak menyediakan fungsi eksekusi order beli/jual otomatis untuk menjamin keamanan dana Anda.

Related MCP server: TradingView MCP Jackson

🏗️ Arsitektur Sistem

graph LR
    subgraph "Stockbit Desktop App"
        SB["Stockbit.exe<br/>Port 9222 (CDP)"]
        WV["WebView2 Context<br/>http://tauri.localhost/"]
        SB --- WV
    end

    subgraph "Bridge Layer (Node.js)"
        BR["StockbitBridge<br/>(WebSocket CDP Client)"]
        WV <== "CDP In-Page Fetch" ==> BR
    end

    subgraph "Output Interfaces"
        MCP["MCP Server (stdio)<br/>npm run mcp"]
        REST["REST API & Dashboard (:3030)<br/>npm run dashboard"]
        BR --> MCP
        BR --> REST
    end

    subgraph "Clients"
        AI["AI Agents<br/>(Claude Desktop / Cursor / Antigravity)"]
        UI["Web Browser Trader<br/>(http://localhost:3030)"]
        MCP <== "JSON-RPC (stdio)" ==> AI
        REST <== "HTTP / REST" ==> UI
    end

Untuk detail teknis mendalam mengenai cara kerja CDP, bypass CORS, dan model keamanan dual-token, baca Dokumentasi Arsitektur.

🚀 Panduan Cepat (Quickstart)

1. Prasyarat

• Node.js 18+ terpasang di komputer.

• Stockbit Desktop v2.2.0+ sudah terpasang (Download Aplikasi Saham Stockbit Desktop App untuk Mac dan Windows).

• Terminal PowerShell / Command Prompt.

2. Instalasi Proyek (Otomatis)

# 1. Clone repository ini
git clone https://github.com/<username>/mcp-stockbit.git
cd mcp-stockbit

# 2. Install dependensi (skrip setup otomatis mendeteksi path lokal Anda)
npm install

(Saat npm install berjalan, hook setup.mjs akan otomatis mengonfigurasi seluruh file mcp_config.json dan mendeteksi instalasi Stockbit di komputer Anda).

3. Menjalankan Stockbit Desktop (Port 9222)

Aplikasi Stockbit Desktop harus berjalan dengan remote debugging port 9222:

• Cara Termudah (Sekali Klik): Cukup klik ganda file launch-stockbit.bat. Skrip akan otomatis mendeteksi lokasi Stockbit.exe dan menyalakannya dengan parameter debug.

• Manual (PowerShell / CMD):

  & "C:\Program Files\Stockbit\Stockbit.exe" --remote-debugging-port=9222

• Login: Masuk ke akun Stockbit Anda seperti biasa.

4. Uji Koneksi Bridge

Pastikan komunikasi ke Stockbit Desktop berjalan mulus:

npm test

Jika sukses, terminal akan menampilkan nama pengguna Anda, saldo RDN, ringkasan modal, dan orderbook real-time.

5. Menjalankan Web Dashboard

• Klik ganda start-dashboard.bat (atau start-all.bat untuk menyalakan keduanya).

• Atau jalankan lewat terminal:

  npm run dashboard

Dashboard akan otomatis terbuka di browser Anda pada alamat: http://localhost:3030.

🤖 Menghubungkan ke AI Assistant (MCP)

Server MCP berjalan melalui transport stdio. Tambahkan konfigurasi berikut ke file konfigurasi AI Assistant favorit Anda:

A. Claude Desktop

Buka %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "stockbit": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-stockbit\\src\\mcpServer.mjs"
      ]
    }
  }
}

B. Antigravity IDE / Cursor

Gunakan file bawaan mcp_config.json atau tambahkan di konfigurasi MCP editor:

{
  "mcpServers": {
    "stockbit": {
      "command": "node",
      "args": ["C:/path/to/mcp-stockbit/src/mcpServer.mjs"]
    }
  }
}

Panduan integrasi lengkap beserta contoh-contoh prompt interaktif dapat dilihat di Panduan Integrasi MCP.

🛠️ Daftar Lengkap Tools MCP (45 Tools)

Aplikasi menyediakan 45 enterprise tools yang dikelompokkan ke dalam 10 modul:

1. Akun & Portofolio (Carina API)

2. Transaksi & Order Management (Carina API)

3. Market Depth & Tape Reading (Exodus API)

4. Bandarmologi & Broker Analytics (Exodus API)

5. Charting & Analisis Teknikal (Exodus API)

6. Fundamental, Rasio & Konsensus Analis (Exodus API)

7. Profil Korporat, Insiders & Corporate Actions (Exodus API)

8. Market Discovery, Screener & Community Stream (Exodus API)

9. Fundamental Deep Dive, Financials & Peer Comparison (Exodus API)

10. Alat Tambahan, Notifikasi & Obligasi (Exodus & Carina API)

🛡️ Keamanan & Analisis Risiko Pemblokiran Akun

Banyak pengguna menanyakan mengenai aspek keamanan dana serta apakah terdapat potensi akun diblokir (banned) oleh sekuritas/bursa. Berikut penjelasan teknis mendalam:

1. Keamanan Dana & Kredensial (100% Aman)

• 🔒 Read-Only by Design (Hanya Baca): Seluruh 45 tools MCP dan endpoint REST dirancang murni untuk membaca data riset pasar dan portofolio. Tidak ada satupun fitur atau fungsi untuk eksekusi order beli (BUY), jual (SELL), maupun penarikan dana (WITHDRAW). Sekalipun model AI mengalami hallucination, AI tidak memiliki kapabilitas maupun izin untuk memindahkan dana atau mengubah posisi trading Anda.

• 🔑 Zero-Credential Storage: Password, PIN trading bursa, dan token otentikasi tidak pernah disimpan di media penyimpanan disk (tidak ada file .env atau database kredensial). Sesi dibaca secara dinamis dari RAM/session window.localStorage WebView2 saat aplikasi Stockbit Desktop aktif, dan langsung hangus ketika aplikasi ditutup atau di-logout.

• 🌐 Loopback Isolation (Tersolasi Lokal): Port remote debugging 9222 dan Server REST 3030 hanya terikat (bind) pada antarmuka jaringan lokal perangkat Anda (127.0.0.1 / localhost). Pihak luar di internet tidak dapat mengakses data Anda tanpa adanya port forwarding manual.

2. Apakah Ada Potensi Akun Diblokir?

Risiko pemblokiran akun secara permanen sangat rendah, karena arsitektur jembatan ini tidak menggunakan mekanisme bot scraper tradisional (seperti cURL atau script HTTP mentah) yang rentan ditandai oleh sistem proteksi WAF/Cloudflare:

• In-Page Context Evaluation: Setiap permintaan data dieksekusi via window.fetch() langsung dari dalam konteks WebView2 resmi aplikasi Stockbit Desktop.

• Identik dengan Penggunaan Normal: Header HTTP, TLS Fingerprint, Origin (http://tauri.localhost), Cookie sesi, dan IP Address adalah 100% sama persis dengan traffic yang dihasilkan saat pengguna sedang mengklik menu atau melihat chart di aplikasi Stockbit Desktop secara manual.

3. Matriks Risiko & Mitigasi

4. Panduan Penggunaan Terbaik (Best Practices)

1. On-Demand Requests: Panggil tools MCP saat Anda sedang berdiskusi atau meminta evaluasi dari AI Agent (Claude, Cursor, Antigravity).

2. Gunakan Delay pada Polling: Jika mengembangkan script otomatisasi pemantau harga, berikan interval wajar (minimal 3–5 detik, jangan per milidetik).

3. Login Resmi: Selalu jalankan Stockbit Desktop resmi dan lakukan login manual sebelum menghubungkan server MCP.

📁 Struktur Direktori Proyek

mcp-stockbit/
├── README.md                 # Dokumentasi utama proyek
├── package.json              # Definisi dependensi & script Node.js
├── start-all.bat             # Launcher sekali-klik untuk Stockbit & Dashboard
├── start-dashboard.bat       # Launcher sekali-klik untuk Web Dashboard
├── kill-port.bat             # Utility pembebas port 3030 otomatis
├── mcp_config.json           # Template konfigurasi MCP server
├── test_all_endpoints.mjs    # Automated test suite (56 verification checks)
├── docs/                     # Dokumentasi teknis mendalam
│   ├── MCP_REFERENCE.md      # Referensi lengkap 45 tools MCP & payload JSON
│   ├── ARCHITECTURE.md       # Arsitektur sistem, WebView2, CDP & dual-token
│   ├── API_CATALOG.md        # Katalog lengkap endpoint Carina & Exodus
│   ├── MCP_SETUP.md          # Panduan integrasi Claude, Cursor, Antigravity
│   └── DEVELOPMENT.md        # Panduan pengembangan
├── src/                      # Kode sumber inti
│   ├── stockbitBridge.mjs     # CDP Client WebSocket & API Handler (45+ methods)
│   ├── mcpServer.mjs          # Server MCP (stdio transport, 45 tools)
│   └── server.mjs             # HTTP REST API & Dashboard Server (auto-port kill)
└── dashboard/                 # Frontend Web UI

📚 Indeks Dokumentasi

1. 🤖 Referensi Lengkap MCP Tools (docs/MCP_REFERENCE.md) — Skema JSON payload setiap tool, parameter, dan panduan untuk AI / App Developer.

2. 🏛️ Arsitektur Sistem (docs/ARCHITECTURE.md) — Cara kerja CDP bridge, bypass CORS, zero-credential storage, dan dual-token model (at & ats).

3. 📖 Katalog API Lengkap (docs/API_CATALOG.md) — Daftar lengkap endpoint Carina & Exodus, header standar, parameter, dan contoh response JSON.

4. 🤖 Panduan Setup MCP (docs/MCP_SETUP.md) — Langkah menghubungkan ke Claude Desktop, Cursor, Antigravity, serta prompt rekomendasi.

5. 💻 Panduan Pengembangan (docs/DEVELOPMENT.md) — Panduan bagi developer yang ingin menambah tool MCP baru atau endpoint dashboard.

⚖️ Lisensi & Penafian (Disclaimer)

Proyek ini dibuat untuk tujuan edukasi, riset interoperabilitas data pribadi, dan eksplorasi kecerdasan buatan. Seluruh merek dagang dan hak cipta aplikasi Stockbit dimiliki oleh PT Stockbit Sekuritas Digital / Stockbit. Pengguna bertanggung jawab penuh atas penggunaan kredensial dan akun masing-masing.