Browserbase

Browserbase MCP サーバー

アーカイブ済み

このリポジトリはアーカイブされており、現在はメンテナンスされていません。

元々はリファレンス実装として公開されたものであり、履歴目的で保持されています。Browserbase の現在の本番サービスや実装を代表するものとして解釈されるべきではありません。

Model Context Protocol (MCP) は、LLM アプリケーションと外部データソースやツールとのシームレスな統合を可能にするオープンプロトコルです。AI 搭載 IDE の構築、チャットインターフェースの強化、カスタム AI ワークフローの作成など、どのような場合でも、MCP は LLM が必要なコンテキストに接続するための標準化された方法を提供します。

このサーバーは、Browserbase と Stagehand を使用したクラウドブラウザ自動化機能を提供します。LLM が Web ページと対話し、情報を抽出し、自動化されたアクションを実行できるようにします。

これは、Browserbase ホスト型 MCP サーバー と同じツールと機能を備えたセルフホスト可能なバージョンです。最も簡単なセットアップには、ホスト型バージョンの使用をお勧めします。

ツール

このサーバーは、ホスト型 Browserbase MCP サーバー と一致する 6 つのツールを公開します。

ツール	説明	入力
start	Browserbase セッションを作成または再利用	(なし)
end	現在の Browserbase セッションを閉じる	(なし)
navigate	URL に移動する	{ url: string }
act	ページ上でアクションを実行する	{ action: string }
observe	ページ上の操作可能な要素を観察する	{ instruction: string }
extract	ページからデータを抽出する	{ instruction?: string }

セットアップ方法

現在、MCP サーバーでは STDIO と SHTTP の 2 つのトランスポートをサポートしています。サーバーを最大限に活用するには、ホスト型 MCP サーバーで SHTTP を使用することをお勧めします。

SHTTP (ホスト型 MCP):

https://mcp.browserbase.com/mcp で Browserbase ホスト型 MCP サーバーを使用します。これが最も簡単な開始方法です。サーバーをホストし、Stagehand で 最もパフォーマンスの高いモデル である Gemini の LLM コストを提供します。

完全なセットアップ手順については、Browserbase MCP ドキュメント を参照してください。

クライアントが SHTTP をサポートしている場合:

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

クライアントが SHTTP をサポートしていない場合:

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

STDIO (セルフホスト):

NPM でホストされているサーバーを使用するか、このリポジトリをクローンして完全にローカルで実行できます。

注: 別のモデルを使用する場合は、引数に --modelName を追加し、そのそれぞれのキーを引数として提供する必要があります。詳細は以下をご覧ください。

NPM 経由で実行する場合 (推奨)

MCP 設定 JSON に移動し、Browserbase サーバーを追加します。

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

以上です！MCP クライアントをリロードすれば、すぐに使用できます。

100% ローカルで実行する場合:

オプション 1: 直接インストール

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

オプション 2: Docker

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

次に、MCP 設定 JSON でサーバーを実行します。

直接インストールを使用する場合

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

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

設定

Browserbase MCP サーバーは、以下のコマンドラインフラグを受け付けます。

フラグ	説明
--proxies	セッションで Browserbase プロキシを有効にする
--verified	Browserbase 検証済み ID を有効にする (スケールプランユーザーのみ)
--advancedStealth	--verified の非推奨エイリアス
--keepAlive	Browserbase キープアライブセッションを有効にする
--contextId <contextId>	使用する Browserbase コンテキスト ID を指定する
--persist	Browserbase コンテキストを永続化するかどうか (デフォルト: true)
--port <port>	HTTP/SHTTP トランスポートでリッスンするポート
--host <host>	サーバーをバインドするホスト (デフォルト: localhost、すべてのインターフェースには 0.0.0.0 を使用)
--browserWidth <width>	ブラウザのビューポート幅 (デフォルト: 1024)
--browserHeight <height>	ブラウザのビューポートの高さ (デフォルト: 768)
--modelName <model>	Stagehand で使用するモデル (デフォルト: google/gemini-2.5-flash-lite)
--modelApiKey <key>	カスタムモデルプロバイダーの API キー (カスタムモデル使用時に必要)
--experimental	実験的機能を有効にする (デフォルト: false)

これらのフラグは、CLI に直接渡すか、MCP 設定ファイルで設定できます。

注: これらのフラグは、セルフホストサーバー (npx @browserbasehq/mcp または Docker) でのみ使用できます。

モデル設定

Stagehand はデフォルトで Google の Gemini 2.5 Flash Lite モデルを使用しますが、GPT-4o、Claude、または他のプロバイダーのような他のモデルを使用するように設定できます。

重要: カスタムモデル (デフォルト以外) を使用する場合は、--modelApiKey フラグを使用して、そのモデルプロバイダー用の独自の API キーを提供する必要があります。

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

注: モデルは Stagehand でサポートされている必要があります。ドキュメントは こちら をご確認ください。

リンク

• Browserbase MCP ドキュメント
• MCP ドキュメント
• MCP 仕様
• Stagehand ドキュメント

ライセンス

Apache 2.0 ライセンスの下でライセンスされています。

Copyright 2025 Browserbase, Inc.