mcp-server-browserbase

mcp-server-browserbase

browserbaseApache-2.0
3.4k звёзд357 форков
Сервер для автоматизации веб-браузера через языковые модели. Работает на базе облачной платформы Browserbase и библиотеки Stagehand. Разработчики могут дать AI-ассистенту управлять браузером: заполнять формы, кликать, собирать данные, выполнять сложные сценарии. Сервер решает проблему интеграции браузера с LLM. Вместо сложных настроек достаточно установить пакет и указать API-ключ. Все действия выполняются в облачном браузере — не нужно ставить локальные драйверы и эмуляторы. Можно переиспользовать сессии, чтобы экономить ресурсы. Сервер подходит для веб-скрапинга, тестирования и создания AI-агентов. Stagehand, используемый в сервере, обеспечивает точное взаимодействие с элементами страницы на основе компьютерного зрения.

Установка

npx -y @browserbasehq/mcp-server-browserbase

Характеристики

Общее

  • СтатусСообщество
  • Разработчикbrowserbase
  • ЛицензияApache-2.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • start — создать новую сессию облачного браузера или возобновить существующую, сохраняя состояние страницы.
  • end — завершить активную сессию и освободить облачные ресурсы браузера.
  • navigate — перейти по указанному URL в текущей сессии.
  • act — выполнить действие на странице, описанное на естественном языке. Stagehand находит подходящий элемент и выполняет клик, ввод текста, выбор опции и другое.
  • observe — получить список интерактивных элементов, соответствующих инструкции. Помогает понять, что доступно для взаимодействия.
  • extract — извлечь данные со страницы по заданному шаблону. Результат возвращается в структурированном виде, например, в JSON.

Как подключить

Для работы необходим аккаунт на Browserbase и созданный проект. Получите API-ключ и Project ID в настройках проекта.

Шаг 1. Установите сервер через npx:

npx -y @browserbasehq/mcp-server-browserbase

Шаг 2. Настройте конфигурацию MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "browserbase": { "command": "npx", "args": ["-y", "@browserbasehq/mcp-server-browserbase"], "env": { "BROWSERBASE_API_KEY": "ваш_API_ключ", "BROWSERBASE_PROJECT_ID": "ваш_Project_ID" } } } }

Шаг 3. Перезапустите MCP-клиент. После перезапуска в списке инструментов появятся все шесть команд управления браузером.

Если ваш клиент поддерживает HTTP-транспорт, можно использовать облачную версию сервера, просто указав URL https://mcp.browserbase.com/mcp. Это проще, но все запросы проходят через сервер Browserbase.

Для самостоятельной установки требуется Node.js 18 или выше.

Примеры запросов

  • «Открой страницу https://example.com и опиши, что на ней отображается.»
  • «Найди форму обратной связи, введи в поле «Имя» значение «Тест» и нажми «Отправить».»
  • «Извлеки заголовки и даты всех статей из блога в JSON.»
  • «Проверь, есть ли на странице кнопка «Купить» и активна ли она.»

Технические детали

  • Язык: TypeScript
  • Транспорт: STDIO (self-hosted) и SHTTP (облачная версия)
  • Лицензия: Apache-2.0
  • Совместимость: Claude Desktop и любые другие MCP-клиенты
  • Зависимости: Browserbase (облачные браузеры), Stagehand (библиотека для взаимодействия со страницами)
  • Это self-hosted версия официального MCP-сервера Browserbase. Исходный код доступен на GitHub.

Поделиться