Browserbase

Browserbase MCP Sunucusu

Arşivlendi

Bu depo arşivlenmiştir ve artık bakımı yapılmamaktadır.

Başlangıçta bir referans uygulama olarak yayınlanmıştır ve tarihsel amaçlarla saklanmaktadır. Browserbase'in mevcut üretim hizmetlerini veya uygulamasını temsil ettiği şeklinde yorumlanmamalıdır.

Model Bağlam Protokolü (MCP), LLM uygulamaları ile harici veri kaynakları ve araçlar arasında sorunsuz entegrasyon sağlayan açık bir protokoldür. İster yapay zeka destekli bir IDE geliştiriyor olun, ister bir sohbet arayüzünü geliştiriyor olun, isterse özel yapay zeka iş akışları oluşturuyor olun, MCP, LLM'leri ihtiyaç duydukları bağlamla bağlamak için standartlaştırılmış bir yol sunar.

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

Bu, aynı araçlara ve işlevselliğe sahip Browserbase tarafından barındırılan MCP sunucusunun 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ı öneririz.

Araçlar

Bu sunucu, barındırılan Browserbase MCP sunucusuyla eşleşen 6 araç sunar:

Araç	Açıklama	Girdi
start	Bir Browserbase oturumu oluştur veya yeniden kullan	(yok)
end	Geçerli Browserbase oturumunu kapat	(yok)
navigate	Bir URL'ye git	{ url: string }
act	Sayfada bir eylem gerçekleştir	{ action: string }
observe	Sayfadaki eyleme dönüştürülebilir öğeleri gözlemle	{ instruction: string }
extract	Sayfadan veri çıkar	{ instruction?: string }

Kurulum

Şu anda MCP sunucumuz için STDIO ve SHTTP olmak üzere 2 aktarımı destekliyoruz. Sunucudan tam kapasiteyle yararlanmak için barındırılan MCP sunucumuzla SHTTP kullanmanızı öneririz.

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

https://mcp.browserbase.com/mcp adresindeki Browserbase tarafından barındırılan MCP sunucusunu kullanın. Bu, başlamanın en kolay yoludur -- sunucuyu biz barındırırız ve Stagehand'deki en iyi performans gösteren model olan Gemini için LLM maliyetlerini sağlarız.

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

İstemciniz SHTTP'yi destekliyorsa:

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

İstemciniz SHTTP'yi desteklemiyorsa:

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

STDIO (Kendi Kendine Barındırılan):

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

Not: Farklı bir model kullanmak istiyorsanız, argümanlara --modelName eklemeli ve ilgili anahtarı bir argüman olarak sağlamalısınız. Daha fazla bilgi aşağıda.

NPM üzerinden çalıştırmak için (Önerilir)

MCP Yapılandırma JSON'unuza gidin ve Browserbase Sunucusunu ekleyin:

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

Hepsi bu kadar! MCP istemcinizi yeniden yükleyin, kullanıma hazırsınız.

%100 yerel olarak çalıştırmak iç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 .

Ardından MCP Yapılandırma JSON'unuzda sunucuyu çalıştırın:

Doğrudan Kurulum Kullanarak

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

Docker Kullanarak

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

Yapılandırma

Browserbase MCP sunucusu aşağıdaki komut satırı bayraklarını kabul eder:

Bayrak	Açıklama
--proxies	Oturum için Browserbase proxy'lerini etkinleştir
--verified	Browserbase Doğrulanmış Kimliği Etkinleştir (Yalnızca Scale Plan Kullanıcıları İçin)
--advancedStealth	--verified için kullanımdan kaldırılmış takma ad
--keepAlive	Browserbase Oturumu Canlı Tutmayı Etkinleştir
--contextId <contextId>	Kullanılacak bir Browserbase Bağlam Kimliği belirtin
--persist	Browserbase bağlamının kalıcı olup olmayacağı (varsayılan: true)
--port <port>	HTTP/SHTTP aktarımı için dinlenecek bağlantı noktası
--host <host>	Sunucunun bağlanacağı ana bilgisayar (varsayılan: localhost, tüm arayüzler için 0.0.0.0 kullanın)
--browserWidth <width>	Tarayıcı görüntü alanı genişliği (varsayılan: 1024)
--browserHeight <height>	Tarayıcı görüntü alanı 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 sağlayıcısı için API anahtarı (özel modeller kullanılırken gereklidir)
--experimental	Deneysel özellikleri etkinleştir (varsayılan: false)

Bu bayraklar doğrudan CLI'ye iletilebilir veya MCP yapılandırma dosyanızda yapılandırılabilir.

Not: Bu bayraklar yalnızca kendi kendine barındırılan sunucuyla (npx @browserbasehq/mcp veya Docker) kullanılabilir.

Model Yapılandırması

Stagehand varsayılan olarak Google'ın Gemini 2.5 Flash Lite modelini kullanır, ancak GPT-4o, Claude veya diğer sağlayıcılar gibi diğer modelleri kullanacak şekilde yapılandırabilirsiniz.

Önemli: Herhangi bir özel model (varsayılan olmayan) kullanırken, --modelApiKey bayrağını kullanarak o model sağlayıcısı 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'de desteklenmelidir. Belgeleri buradan kontrol edin.

Bağlantılar

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

Lisans

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

Telif Hakkı 2025 Browserbase, Inc.