Browserbase

Browserbase MCP-сервер

Архивировано

Этот репозиторий заархивирован и больше не поддерживается.

Изначально он был опубликован как эталонная реализация и сохранен для исторических целей. Его не следует рассматривать как отражение текущих производственных сервисов или реализации Browserbase.

Model Context Protocol (MCP) — это открытый протокол, обеспечивающий бесшовную интеграцию между LLM-приложениями и внешними источниками данных и инструментами. Независимо от того, создаете ли вы IDE на базе ИИ, улучшаете чат-интерфейс или разрабатываете пользовательские ИИ-рабочие процессы, MCP предоставляет стандартизированный способ подключения LLM к необходимому им контексту.

Этот сервер предоставляет возможности облачной автоматизации браузера с использованием Browserbase и Stagehand. Он позволяет LLM взаимодействовать с веб-страницами, извлекать информацию и выполнять автоматизированные действия.

Это самостоятельно развертываемая версия размещенного MCP-сервера Browserbase с теми же инструментами и функциональностью. Мы рекомендуем использовать размещенную версию для наиболее простой настройки.

Инструменты

Этот сервер предоставляет 6 инструментов, соответствующих размещенному MCP-серверу Browserbase:

Инструмент	Описание	Входные данные
start	Создать или переиспользовать сессию Browserbase	(нет)
end	Закрыть текущую сессию Browserbase	(нет)
navigate	Перейти по URL	{ url: string }
act	Выполнить действие на странице	{ action: string }
observe	Наблюдать за активными элементами на странице	{ instruction: string }
extract	Извлечь данные со страницы	{ instruction?: string }

Как настроить

В настоящее время мы поддерживаем 2 транспорта для нашего MCP-сервера: STDIO и SHTTP. Мы рекомендуем использовать SHTTP с нашим размещенным MCP-сервером, чтобы использовать сервер на полную мощность.

SHTTP (Размещенный MCP):

Используйте размещенный MCP-сервер Browserbase по адресу https://mcp.browserbase.com/mcp. Это самый простой способ начать работу — мы размещаем сервер и покрываем расходы на 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, или запустить его полностью локально, клонировав этот репозиторий.

Примечание: Если вы хотите использовать другую модель, необходимо добавить --modelName в аргументы и предоставить соответствующий ключ в качестве аргумента. Подробнее ниже.

Запуск через NPM (Рекомендуется)

Перейдите в JSON-конфигурацию MCP и добавьте сервер 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 .

Затем в JSON-конфигурации MCP запустите сервер:

Используя прямую установку

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

Конфигурация

MCP-сервер Browserbase принимает следующие флаги командной строки:

Флаг	Описание
--proxies	Включить прокси Browserbase для сессии
--verified	Включить проверенную личность Browserbase (только для пользователей тарифа Scale)
--advancedStealth	Устаревший псевдоним для --verified
--keepAlive	Включить сессию с поддержанием активности Browserbase
--contextId <contextId>	Указать идентификатор контекста Browserbase для использования
--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 или провайдеров.

Важно: При использовании любой пользовательской модели (не по умолчанию) вы должны предоставить собственный API-ключ для этого провайдера модели, используя флаг --modelApiKey.

{
  "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 License.

Copyright 2025 Browserbase, Inc.