mcp-server-browserbase

Browserbase MCP Server

アーカイブ済み

このリポジトリはアーカイブ済みで、メンテナンスされていません。

このリポジトリはもともとリファレンス実装として公開され、歴史的な目的のために保存されています。Browserbase の現在の本番サービスや実装を代表するものとして解釈しないでください。

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

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

これは、同じツールと機能を備えた 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 の利用料金も当社が負担します。

詳しいセットアップ手順については、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 Config 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 Config 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 Verified Identity を有効にします（Scale プランのユーザーのみ）
--advancedStealth	--verified の非推奨の別名
--keepAlive	Browserbase Keep Alive Session を有効にします
--contextId <contextId>	使用する Browserbase Context 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.