mcp-сервер-браузербаза

Сервер MCP браузера драматурга

крышка

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

Как настроить в MCP json

Вы можете использовать наш сервер, размещенный на NPM, или запустить его полностью локально, клонировав этот репозиторий.

Для работы на NPM (рекомендуется)

Перейдите в JSON-файл конфигурации MCP и добавьте сервер Browserbase:

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

Вот и все! Перезагрузите клиент MCP, и Клод сможет использовать Browserbase.

Для 100% локального запуска:

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

# Install the dependencies in the proper directory and build the project
cd browserbase
npm install && npm run build

Затем в вашем MCP Config JSON запустите сервер. Для локального запуска мы можем использовать STDIO или self-host через SSE.

СТДИО:

Добавьте в JSON-файл конфигурации MCP следующее:

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

СЭУ:

Выполните следующую команду в терминале. Вы можете добавить любые флаги (см. параметры ниже), которые вы считаете подходящими для настройки вашей конфигурации.

   node cli.js --port 8931

Затем в файле MCP Config JSON поместите следующее:

   {
      "mcpServers": {
         "browserbase": {
            "url": "http://localhost:8931/sse",
            "env": {
               "BROWSERBASE_API_KEY": "",
               "BROWSERBASE_PROJECT_ID": ""
            }
         }
      }
   }

Затем перезагрузите клиент MCP, и все будет готово!

Объяснение флагов:

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

Флаг	Описание
`--browserbaseApiKey <key>`	Ваш ключ API Browserbase для аутентификации
`--browserbaseProjectId <id>`	Ваш идентификатор проекта Browserbase
`--proxies`	Включить прокси-серверы Browserbase для сеанса
`--advancedStealth`	Включить Browserbase Advanced Stealth (только для пользователей плана масштабирования)
`--contextId <contextId>`	Укажите идентификатор контекста Browserbase для использования
`--persist [boolean]`	Сохранять ли контекст Browserbase (по умолчанию: true)
`--port <port>`	Порт для прослушивания HTTP/SSE-транспорта
`--host <host>`	Хост для привязки сервера (по умолчанию: localhost, используйте 0.0.0.0 для всех интерфейсов)
`--cookies [json]`	Массив JSON-файлов cookie для внедрения в браузер
`--browserWidth <width>`	Ширина области просмотра браузера (по умолчанию: 1024)
`--browserHeight <height>`	Высота области просмотра браузера (по умолчанию: 768)

Эти флаги можно передать непосредственно в CLI или настроить в файле конфигурации MCP.

ПРИМЕЧАНИЕ:

В настоящее время эти флаги можно использовать только с локальным сервером (npx @browserbasehq/mcp).

Флаги и примеры конфигураций

Прокси

Вот наши документы по прокси-серверам .

Чтобы использовать прокси в STDIO, установите флаг --proxies в конфигурации MCP:

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

Расширенная скрытность

Вот наши документы по Advanced Stealth .

Чтобы использовать прокси в STDIO, установите флаг --advancedStealth в конфигурации MCP:

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

Контексты

Вот наши документы по контекстам

Чтобы использовать контексты в STDIO, установите флаг --contextId в конфигурации MCP:

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

Инъекция куки

Зачем вам нужно внедрять куки? Наш контекстный API в настоящее время работает с постоянными куки, но не с сеансовыми куки. Поэтому иногда наша постоянная аутентификация может не работать (мы усердно работаем над добавлением этой функции).

Вы можете пометить файлы cookie в MCP, добавив файл cookies.json в конфигурацию MCP.

Чтобы использовать прокси в STDIO, установите флаг --proxies в конфигурации MCP. Ваши файлы cookie JSON должны быть типа Playwright Cookies

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

Размер области просмотра браузера

Размер области просмотра по умолчанию для сеанса браузера составляет 1024 x 768. Вы можете настроить размер области просмотра браузера с помощью флагов browserWidth и browserHeight.

Вот как использовать его для пользовательского размера браузера. Мы рекомендуем придерживаться соотношения сторон 16:9 (т.е.: 1920 x 1080, 1280, 720, 1024 x 768)

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

Структура

src/ : Исходный код TypeScript
- index.ts : Основная точка входа, проверки окружения, выключение
- server.ts : настройка сервера MCP и маршрутизация запросов
- sessionManager.ts : управляет созданием/управлением сеансом Browserbase
- tools/ : Определения и реализации инструментов
- resources/ : Обработка ресурсов (скриншотов)
- types.ts : общие типы TypeScript
dist/ : Скомпилированный вывод JavaScript
tests/ : Заполнитель для тестов
utils/ : Заполнитель для служебных скриптов
Dockerfile : для создания образа Docker
Файлы конфигурации ( .json , .ts , .mjs , .npmignore )

Контексты для сохранения

Этот сервер поддерживает функцию контекстов Browserbase, которая позволяет сохранять файлы cookie, аутентификацию и кэшированные данные во всех сеансах браузера:

Создание контекста :
browserbase_context_create: Creates a new context, optionally with a friendly name
Использование контекста с сеансом :
browserbase_session_create: Now accepts a 'context' parameter with: - id: The context ID to use - name: Alternative to ID, the friendly name of the context - persist: Whether to save changes (cookies, cache) back to the context (default: true)
Удаление контекста :
browserbase_context_delete: Deletes a context when you no longer need it

Контексты значительно облегчают:

Поддерживать состояние входа в систему между сеансами
Сократите время загрузки страницы за счет сохранения кэша
Избегайте CAPTCHA и обнаружения путем повторного использования отпечатков браузера

Этот сервер также предоставляет возможности прямого управления файлами cookie:

Добавление файлов cookie :
browserbase_cookies_add: Add cookies to the current browser session with full control over properties
Получение файлов cookie :
browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)
Удаление файлов cookie :
browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

Эти инструменты полезны для:

Установка файлов cookie аутентификации без перехода на страницы входа
Резервное копирование и восстановление состояния cookie-файлов
Устранение неполадок, связанных с файлами cookie
Манипулирование атрибутами cookie (срок действия, флаги безопасности и т. д.)

TODO/дорожная карта

Реализуйте настоящую логику взаимодействия на основе ref для щелчка, ввода текста, перетаскивания, наведения, select_option.
Реализуйте скриншоты, специфичные для элемента, с помощью ref .
Добавьте больше стандартных инструментов MCP (вкладки, навигация и т. д.).
Добавьте тесты.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

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

Related MCP Servers

Playwright MCP Server
lebrodus
A
security
F
license
A
quality
A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
Last updated -
12
10,534
1
TypeScript
Puppeteer MCP Server
jwaldor
A
security
F
license
A
quality
Enables LLMs to perform web browsing tasks, take screenshots, and execute JavaScript using Puppeteer for browser automation.
Last updated -
4
15,502
1
JavaScript
MCP Puppeteer Linux Server
PhialsBasement
A
security
F
license
A
quality
Enables browser automation for LLMs on Linux display servers, supporting web interaction, screenshots, and JavaScript execution in a real browser.
Last updated -
7
5
4
JavaScript
Steel Puppeteer
rdvo
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.
Last updated -
JavaScript
MIT License

View all related MCP servers

mcp-server-browserbase

Сервер MCP браузера драматурга

Как настроить в MCP json

Для работы на NPM (рекомендуется)

Для 100% локального запуска:

СТДИО:

СЭУ:

Объяснение флагов:

ПРИМЕЧАНИЕ:

Флаги и примеры конфигураций

Прокси

Расширенная скрытность

Контексты

Инъекция куки

Размер области просмотра браузера

Структура

Контексты для сохранения

TODO/дорожная карта

Tools

Related MCP Servers

Playwright MCP Server

Puppeteer MCP Server

MCP Puppeteer Linux Server

Steel Puppeteer

Appeared in Searches

New MCP Servers

MCP directory API

Сервер MCP браузера драматурга

Как настроить в MCP json

Для работы на NPM (рекомендуется)

Для 100% локального запуска:

СТДИО:

СЭУ:

Объяснение флагов:

ПРИМЕЧАНИЕ:

Флаги и примеры конфигураций

Прокси

Расширенная скрытность

Контексты

Инъекция куки

Размер области просмотра браузера

Структура

Контексты для сохранения

Управление файлами cookie

TODO/дорожная карта

Tools

Related MCP Servers

Playwright MCP Server

Puppeteer MCP Server

MCP Puppeteer Linux Server

Steel Puppeteer

Appeared in Searches

New MCP Servers

MCP directory API