ImRonAI-mcp-server-browserbase

Browserbase MCP サーバー

Model Context Protocol（MCP）は、LLM アプリケーションと外部のデータソースやツールをシームレスに統合できるオープンプロトコルです。AI 搭載 IDE の構築、チャットインターフェースの拡張、カスタム AI ワークフローの作成など、MCP は LLM を必要なコンテキストに接続する標準的な方法を提供します。

このサーバーは、Browserbase と Stagehand を使用して、クラウドブラウザーの自動化機能を提供します。LLM がウェブページを操作し、スクリーンショットを撮影し、情報を抽出し、きめ細かく自動アクションを実行できるようにします。

機能

機能	説明
ブラウザー自動化	Browserbase 経由でクラウドブラウザーを制御、オーケストレーションします
データ抽出	任意のウェブページから構造化データを抽出します
ウェブ操作	簡単に移動、クリック、フォーム入力を行います
スクリーンショット	ページ全体や要素のスクリーンショットを撮影します
モデルの柔軟性	複数のモデル（OpenAI、Claude、Gemini など）に対応しています
ビジョンサポート	複雑な DOM に対して注釈付きスクリーンショットを使用します
セッション管理	ブラウザーセッションの作成、管理、終了を行います
マルチセッション	複数のブラウザーセッションを並行して実行します

セットアップ方法

クイックスタート：

Cursor に追加

このリンクをコピーして、ブラウザーに貼り付けてください：

cursor://anysphere.cursor-deeplink/mcp/install?name=browserbase&config=eyJjb21tYW5kIjoibnB4IEBicm93c2VyYmFzZWhxL21jcCIsImVudiI6eyJCUk9XU0VSQkFTRV9BUElfS0VZIjoiIiwiQlJPV1NFUkJBU0VfUFJPSkVDVF9JRCI6IiIsIkdFTUlOSV9BUElfS0VZIjoiIn19

現在、MCP サーバーでは STDIO と SHTTP の 2 つのトランスポートをサポートしています。サーバーの機能を最大限に活用するため、リモートホストされた URL で SHTTP を使用することをおすすめします。

SHTTP：

リモートホストされた URL 経由で Browserbase MCP サーバーを使用するには、以下を設定に追加してください。

smithery.ai にアクセスし、API キーと設定を入力してリモートホストされた URL を取得してください。 リモートホストされたサーバーを使用する場合、Stagehand で最高の性能を発揮するモデルである Gemini の LLM コストを当社が負担します。

クライアントが SHTTP に対応している場合：

{
  "mcpServers": {
    "browserbase": {
      "url": "your-smithery-url.com"
    }
  }
}

クライアントが SHTTP に対応していない場合：

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "your-smithery-url.com"]
    }
  }
}

STDIO：

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

❗️ 重要： 別のモデルを使用する場合は、引数に --modelName を追加し、そのモデルに対応するキーを引数として指定する必要があります。詳しくは以下をご覧ください。

NPM で実行する（推奨）

MCP 設定 JSON を開き、Browserbase サーバーを追加してください：

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

これで完了です！MCP クライアントを再読み込みすると、Claude が Browserbase を使用できるようになります。

100％ローカルで実行する場合：

# Clone the Repo
git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase

# Install the dependencies and build the project
npm install && npm run build

次に、MCP 設定 JSON でサーバーを実行します。ローカルで実行するには、STDIO を使用するか、SHTTP をセルフホストできます。

STDIO：

MCP 設定 JSON ファイルに以下を追加してください：

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

MCP クライアントを再読み込みすれば、準備完了です！

設定

Browserbase MCP サーバーでは、以下のコマンドラインフラグを使用できます。

フラグ	説明
--proxies	セッションで Browserbase プロキシを有効にします
--advancedStealth	Browserbase Advanced Stealth を有効にします（Scale プランのユーザーのみ）
--keepAlive	Browserbase Keep Alive セッションを有効にします
--contextId <contextId>	使用する Browserbase Context ID を指定します
--persist	Browserbase コンテキストを保持するかどうかを指定します（デフォルト：true）
--port <port>	HTTP/SHTTP トランスポートでリッスンするポート
--host <host>	サーバーをバインドするホスト（デフォルト：localhost。すべてのインターフェースでは 0.0.0.0 を使用）
--cookies [json]	ブラウザーに挿入する Cookie の JSON 配列
--browserWidth <width>	ブラウザーのビューポート幅（デフォルト：1024）
--browserHeight <height>	ブラウザーのビューポートの高さ（デフォルト：768）
--modelName <model>	Stagehand で使用するモデル（デフォルト：google/gemini-2.0-flash）
--modelApiKey <key>	カスタムモデルプロバイダーの API キー（カスタムモデル使用時に必須）
--experimental	実験的機能を有効にします（デフォルト：false）

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

注意：

現在、これらのフラグはローカルサーバー（npx @browserbasehq/mcp-server-browserbase）でのみ使用できます。

設定例

プロキシ

プロキシに関するドキュメントはこちらです。

プロキシを使用するには、MCP 設定で --proxies フラグを設定します。

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

Advanced Stealth

Advanced Stealthに関するドキュメントはこちらです。

Advanced Stealth を使用するには、MCP 設定で --advancedStealth フラグを設定します。

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

コンテキスト

コンテキストに関するドキュメントはこちらです。

コンテキストを使用するには、MCP 設定で --contextId フラグを設定します。

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp-server-browserbase",
        "--contextId",
        "<YOUR_CONTEXT_ID>"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

ブラウザーのビューポートサイズ

ブラウザーセッションのデフォルトのビューポートサイズは 1024 x 768 です。browserWidth フラグと browserHeight フラグを使用して、ブラウザーのビューポートサイズを調整できます。

カスタムサイズのブラウザーを使用する方法は次のとおりです。アスペクト比は 16:9（例：1920 x 1080、1280 x 720、1024 x 768）にすることをおすすめします。

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp-server-browserbase",
        "--browserHeight 1080",
        "--browserWidth 1920"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

モデルの設定

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

重要：カスタムモデル（デフォルト以外）を使用する場合は、--modelApiKey フラグを使用して、そのモデルプロバイダーの API キーを指定する必要があります。

さまざまなモデルを設定する方法は次のとおりです。

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

注：モデルは Stagehand でサポートされている必要があります。サポート対象の LLM については、こちらのドキュメントをご確認ください。カスタムモデルを使用する場合は、そのプロバイダーの API キーを指定する必要があります。

リソース

サーバーからスクリーンショットのリソースにアクセスできます。

1. スクリーンショット（screenshot://<screenshot-name>）
   • キャプチャしたスクリーンショットの PNG 画像

主な機能

• AI を活用した自動化：Web 操作を自然言語のコマンドで実行できます
• 複数モデルのサポート：OpenAI、Claude、Gemini などで動作します
• 高度なセッション管理：ブラウザー自動化を並列実行するための単一セッションおよび複数セッションをサポートします
• スクリーンショットのキャプチャ：ページ全体および特定の要素のスクリーンショットを撮影できます
• データ抽出：Web ページからコンテンツをインテリジェントに抽出します
• プロキシのサポート：エンタープライズレベルのプロキシ機能を備えています
• ステルスモード：高度な検出回避機能を備えています
• コンテキストの永続化：セッション間で認証情報と状態を維持します
• 並列ワークフロー：複雑な自動化タスクのために、複数のブラウザーセッションを同時に実行します

Model Context Protocol の詳細については、以下をご覧ください：

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

MCP の公式ドキュメントはこちらをご覧ください：

• Browserbase MCP

ライセンス

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

Copyright 2025 Browserbase, Inc.