Browserbase

官方

在雲端自動化瀏覽器操作（例如網頁導航、資料擷取、表單填寫等）

GitHub

3.4k

你可以用 Browserbase MCP 做什麼？

啟動雲端瀏覽器工作階段 — 要求您的助手使用 start 建立或重複使用 Browserbase 工作階段。
導航至任何 URL — 使用 navigate 將瀏覽器導向特定網頁。
在頁面上執行動作 — 指示助手透過 act 點擊、輸入或與元素互動。
觀察可互動元素 — 使用 observe 請求一份符合指令的可操作頁面元素清單。
提取結構化資料 — 使用 extract 從目前頁面擷取資訊，可選擇性地透過自然語言指令引導。
結束瀏覽器工作階段 — 使用 end 乾淨地關閉作用中的 Browserbase 工作階段。

文件

Browserbase MCP 伺服器

已封存

此儲存庫已封存，不再維護。

它最初作為參考實作發布，並基於歷史目的保留。不應將其解讀為代表 Browserbase 目前的生產服務或實作。

cover

模型上下文協定 (MCP) 是一個開放協定，可讓 LLM 應用程式與外部資料來源和工具之間無縫整合。無論您是在建置 AI 驅動的 IDE、增強聊天介面，還是建立自訂 AI 工作流程，MCP 都提供了一種標準化方式，將 LLM 與其所需的上下文連接起來。

此伺服器使用 Browserbase 和 Stagehand 提供雲端瀏覽器自動化功能。它讓 LLM 能夠與網頁互動、擷取資訊並執行自動化操作。

這是一個可自行託管的版本，與 Browserbase 託管的 MCP 伺服器具有相同的工具和功能。我們建議使用託管版本以獲得最簡單的設定體驗。

工具

此伺服器公開 6 個工具，與託管的 Browserbase MCP 伺服器相符：

工具	描述	輸入
`start`	建立或重複使用 Browserbase 工作階段	(無)
`end`	關閉目前的 Browserbase 工作階段	(無)
`navigate`	導航至某個 URL	`{ url: string }`
`act`	在頁面上執行動作	`{ action: string }`
`observe`	觀察頁面上可操作的元素	`{ instruction: string }`
`extract`	從頁面擷取資料	`{ instruction?: string }`

如何設定

我們目前支援兩種 MCP 伺服器傳輸方式：STDIO 和 SHTTP。我們建議您使用 SHTTP 搭配我們的託管 MCP 伺服器，以充分利用伺服器的完整容量。

SHTTP (託管 MCP)：

使用位於 https://mcp.browserbase.com/mcp 的 Browserbase 託管 MCP 伺服器。這是最簡單的入門方式——我們託管伺服器並提供 Gemini 的 LLM 成本，Gemini 是 Stagehand 中效能最佳的模型。

如需完整的設定說明，請參閱 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 上的伺服器，或透過複製此儲存庫在本機完全執行。

注意： 如果您想使用不同的模型，必須在 args 中加入 --modelName，並提供相應的金鑰作為 arg。更多資訊如下。

透過 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 驗證身分 (僅限 Scale 方案使用者)
`--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 中受支援。請查閱此處的文件。

連結

授權

依據 Apache 2.0 授權條款授權。