Browserbase MCP Server

Model Context Protocol (MCP), LLM uygulamalarını dış veri kaynakları ve araçlarla sorunsuz bir şekilde entegre etmeyi sağlayan açık bir protokoldür. AI destekli bir IDE oluşturuyor, sohbet arayüzünü geliştiriyor veya özel AI iş akışları oluşturuyor olsanız da, MCP, LLM'leri ihtiyaç duydukları bağlam ile bağlamak için standartlaştırılmış bir yol sağlar.

Bu sunucu, Browserbase ve Stagehand kullanarak bulut tarayıcı otomasyon yetenekleri sağlar. LLM'lerin web sayfalarıyla etkileşim kurmasını, bilgi çıkarmasını ve otomatik işlemler gerçekleştirmesini sağlar.

Bu, Browserbase barındırılan MCP sunucusu ile aynı araçlara ve işlevselliğe sahip kendi kendine barındırılabilir bir sürümüdür. En kolay kurulum için barındırılan sürümü kullanmanızı öneriyoruz.

Araçlar

Bu sunucu, barındırılan Browserbase MCP sunucusu ile eşleşen 6 aracı sunar:

Araç	Açıklama	Giriş
start	Browserbase oturumu oluştur veya yeniden kullan	(none)
end	Mevcut Browserbase oturumunu kapat	(none)
navigate	Bir URL'ye git	{ url: string }
act	Sayfada bir işlem gerçekleştir	{ action: string }
observe	Sayfadaki işlem yapılabilir öğeleri gözlemle	{ instruction: string }
extract	Sayfadan veri çıkart	{ instruction?: string }

Kurulum Nasıl Yapılır

Şu anda MCP sunucumuz için 2 transport'u destekliyoruz: STDIO ve SHTTP. Sunucuyu tam kapasitesiyle kullanmak için barındırılan MCP sunucumuzla SHTTP kullanmanızı öneriyoruz.

SHTTP (Barındırılan MCP):

https://mcp.browserbase.com/mcp adresindeki Browserbase barındırılan MCP sunucusunu kullanın. Bu, başlamak için en kolay yoldur -- sunucuyu barındırıyoruz ve Gemini için LLM maliyetlerini sağlıyoruz; bu, Stagehand içinde en iyi performans gösteren model'dir.

Tam kurulum talimatları için Browserbase MCP belgelerine bakın.

Clientiniz SHTTP'yi destekliyorsa:

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

Clientiniz SHTTP'yi desteklemiyorsa:

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

STDIO (Kendi Sunucusu):

NPM'de barındırılan sunucumuzu kullanabilir veya bu repo'yu klonlayarak tamamen yerel olarak çalıştırabilirsiniz.

Not: Farklı bir model kullanmak istiyorsanız, args'a --modelName eklemeniz ve ilgili anahtarı bir arg olarak sağlamanız gerekir. Daha fazla bilgi aşağıda.

NPM Üzerinden Çalıştırmak İçin (Önerilir)

MCP Config JSON'unuza gidin ve Browserbase Server'ı ekleyin:

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

Hepsi bu! MCP client'inizi yeniden yükleyin ve başlamaya hazırsınız.

%100 Yerel Olarak Çalıştırmak İçin:

Seçenek 1: Doğrudan Kurulum

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

Seçenek 2: Docker

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

Daha sonra MCP Config JSON'unuzda sunucuyu çalıştırın:

Doğrudan Kurulum Kullanma

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

Docker Kullanma

{
  "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": ""
      }
    }
  }
}

Konfigürasyon

Browserbase MCP sunucusu aşağıdaki komut satırı flag'lerini kabul eder:

Flag	Açıklama
--proxies	Oturum için Browserbase proxy'lerini etkinleştir
--verified	Browserbase Verified Identity'yi etkinleştir (Yalnızca Scale Plan Kullanıcıları İçin)
--advancedStealth	--verified için kullanımdan kaldırılmış diğer ad
--keepAlive	Browserbase Keep Alive Session'ı etkinleştir
--contextId <contextId>	Kullanılacak Browserbase Context ID'sini belirt
--persist	Browserbase context'ini devam ettirip ettirmeyeceği (varsayılan: true)
--port <port>	HTTP/SHTTP transport'u için dinlenecek port
--host <host>	Sunucunun bağlanacağı host (varsayılan: localhost, tüm arayüzler için 0.0.0.0)
--browserWidth <width>	Tarayıcı viewport genişliği (varsayılan: 1024)
--browserHeight <height>	Tarayıcı viewport yüksekliği (varsayılan: 768)
--modelName <model>	Stagehand için kullanılacak model (varsayılan: google/gemini-2.5-flash-lite)
--modelApiKey <key>	Özel model provider'ı için API anahtarı (özel modeller kullanırken gerekli)
--experimental	Deneysel özellikleri etkinleştir (varsayılan: false)

Bu flag'ler doğrudan CLI'ya veya MCP konfigürasyon dosyanızda yapılandırılabilir.

Not: Bu flag'ler yalnızca kendi kendine barındırılan sunucu (npx @browserbasehq/mcp veya Docker) ile kullanılabilir.

Model Konfigürasyonu

Stagehand, varsayılan olarak Google'ın Gemini 2.5 Flash Lite modelini kullanır, ancak GPT-4o, Claude veya diğer provider'lar gibi diğer modelleri kullanmak için yapılandırabilirsiniz.

Önemli: Herhangi bir özel model (varsayılan olmayan) kullanırken, --modelApiKey flag'ini kullanarak o model provider'ı için kendi API anahtarınızı sağlamanız gerekir.

{
  "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": ""
      }
    }
  }
}

Not: Model, Stagehand'da desteklenmelidir. Buradaki belgeleri kontrol edin.

Bağlantılar

• Browserbase MCP Belgeleri
• MCP Belgeleri
• MCP Spesifikasyonu
• Stagehand Belgeleri

Lisans

Apache 2.0 Lisansı altında lisanslanmıştır.

Copyright 2025 Browserbase, Inc.