Сервер 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, и все будет готово!

Related MCP server: Puppeteer MCP Server

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

Сервер 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:

Добавление файлов 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 (вкладки, навигация и т. д.).
Добавьте тесты.

mcp-server-browserbase