Browserbase

Server MCP Browserbase

Diarsipkan

Repositori ini diarsipkan dan tidak lagi dipelihara.

Awalnya diterbitkan sebagai implementasi referensi dan dipertahankan untuk tujuan historis. Ini tidak boleh ditafsirkan sebagai representasi dari layanan atau implementasi produksi Browserbase saat ini.

Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan integrasi mulus antara aplikasi LLM dan sumber data serta alat eksternal. Baik Anda membangun IDE bertenaga AI, meningkatkan antarmuka obrolan, atau membuat alur kerja AI kustom, MCP menyediakan cara standar untuk menghubungkan LLM dengan konteks yang mereka butuhkan.

Server ini menyediakan kemampuan otomatisasi peramban cloud menggunakan Browserbase dan Stagehand. Ini memungkinkan LLM untuk berinteraksi dengan halaman web, mengekstrak informasi, dan melakukan tindakan otomatis.

Ini adalah versi yang dapat di-host sendiri dari server MCP yang dihosting Browserbase dengan alat dan fungsionalitas yang sama. Kami merekomendasikan menggunakan versi yang dihosting untuk pengaturan termudah.

Alat

Server ini menyediakan 6 alat yang cocok dengan server MCP Browserbase yang dihosting:

Alat	Deskripsi	Masukan
start	Membuat atau menggunakan kembali sesi Browserbase	(tidak ada)
end	Menutup sesi Browserbase saat ini	(tidak ada)
navigate	Menavigasi ke URL	{ url: string }
act	Melakukan tindakan pada halaman	{ action: string }
observe	Mengamati elemen yang dapat ditindaklanjuti pada halaman	{ instruction: string }
extract	Mengekstrak data dari halaman	{ instruction?: string }

Cara Pengaturan

Kami saat ini mendukung 2 transport untuk server MCP kami, STDIO dan SHTTP. Kami merekomendasikan Anda menggunakan SHTTP dengan server MCP kami yang dihosting untuk memanfaatkan server pada kapasitas penuh.

SHTTP (MCP yang Dihosting):

Gunakan server MCP yang dihosting Browserbase di https://mcp.browserbase.com/mcp. Ini adalah cara termudah untuk memulai -- kami menghosting server dan menyediakan biaya LLM untuk Gemini, model dengan performa terbaik di Stagehand.

Untuk petunjuk pengaturan lengkap, lihat dokumentasi Browserbase MCP.

Jika klien Anda mendukung SHTTP:

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "https://mcp.browserbase.com/mcp"
    }
  }
}

Jika klien Anda tidak mendukung SHTTP:

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.browserbase.com/mcp"]
    }
  }
}

STDIO (Host Sendiri):

Anda dapat menggunakan server kami yang dihosting di NPM atau menjalankannya sepenuhnya secara lokal dengan mengkloning repo ini.

Catatan: Jika Anda ingin menggunakan model yang berbeda, Anda harus menambahkan --modelName ke args dan memberikan kunci masing-masing sebagai arg. Info lebih lanjut di bawah.

Untuk menjalankan melalui NPM (Direkomendasikan)

Buka JSON Konfigurasi MCP Anda dan tambahkan Server Browserbase:

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Itu saja! Muat ulang klien MCP Anda dan Anda siap menggunakannya.

Untuk menjalankan 100% lokal:

Opsi 1: Instalasi langsung

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build

Opsi 2: Docker

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .

Kemudian di JSON Konfigurasi MCP Anda jalankan server:

Menggunakan Instalasi Langsung

{
  "mcpServers": {
    "browserbase": {
      "command": "node",
      "args": ["/path/to/mcp-server-browserbase/cli.js"],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Menggunakan Docker

{
  "mcpServers": {
    "browserbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BROWSERBASE_API_KEY",
        "-e",
        "BROWSERBASE_PROJECT_ID",
        "-e",
        "GEMINI_API_KEY",
        "mcp-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Konfigurasi

Server MCP Browserbase menerima flag baris perintah berikut:

Flag	Deskripsi
--proxies	Mengaktifkan proksi Browserbase untuk sesi
--verified	Mengaktifkan Identitas Terverifikasi Browserbase (Hanya untuk Pengguna Paket Skala)
--advancedStealth	Alias usang untuk --verified
--keepAlive	Mengaktifkan Sesi Tetap Aktif Browserbase
--contextId <contextId>	Menentukan ID Konteks Browserbase untuk digunakan
--persist	Apakah akan mempertahankan konteks Browserbase (default: true)
--port <port>	Port untuk mendengarkan transport HTTP/SHTTP
--host <host>	Host untuk mengikat server (default: localhost, gunakan 0.0.0.0 untuk semua antarmuka)
--browserWidth <width>	Lebar viewport peramban (default: 1024)
--browserHeight <height>	Tinggi viewport peramban (default: 768)
--modelName <model>	Model yang digunakan untuk Stagehand (default: google/gemini-2.5-flash-lite)
--modelApiKey <key>	Kunci API untuk penyedia model kustom (diperlukan saat menggunakan model kustom)
--experimental	Mengaktifkan fitur eksperimental (default: false)

Flag ini dapat diteruskan langsung ke CLI atau dikonfigurasi dalam file konfigurasi MCP Anda.

Catatan: Flag ini hanya dapat digunakan dengan server yang di-host sendiri (npx @browserbasehq/mcp atau Docker).

Konfigurasi Model

Stagehand secara default menggunakan model Gemini 2.5 Flash Lite Google, tetapi Anda dapat mengonfigurasinya untuk menggunakan model lain seperti GPT-4o, Claude, atau penyedia lainnya.

Penting: Saat menggunakan model kustom apa pun (non-default), Anda harus memberikan kunci API Anda sendiri untuk penyedia model tersebut menggunakan flag --modelApiKey.

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp",
        "--modelName",
        "anthropic/claude-sonnet-4.5",
        "--modelApiKey",
        "your-anthropic-api-key"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": ""
      }
    }
  }
}

Catatan: Model harus didukung di Stagehand. Lihat dokumennya di sini.

Tautan

• Dokumentasi Browserbase MCP
• Dokumentasi MCP
• Spesifikasi MCP
• Dokumentasi Stagehand

Lisensi

Dilisensikan di bawah Lisensi Apache 2.0.

Hak Cipta 2025 Browserbase, Inc.