Сервер 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 принимает следующие флаги командной строки:

Эти флаги можно передать непосредственно в 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, аутентификацию и кэшированные данные во всех сеансах браузера:

1. Создание контекста :

   browserbase_context_create: Creates a new context, optionally with a friendly name

2. Использование контекста с сеансом :

   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)

3. Удаление контекста :

   browserbase_context_delete: Deletes a context when you no longer need it

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

• Поддерживать состояние входа в систему между сеансами

• Сократите время загрузки страницы за счет сохранения кэша

• Избегайте CAPTCHA и обнаружения путем повторного использования отпечатков браузера

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

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

1. Добавление файлов cookie :

   browserbase_cookies_add: Add cookies to the current browser session with full control over properties

2. Получение файлов cookie :

   browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)

3. Удаление файлов cookie :

   browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

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

• Установка файлов cookie аутентификации без перехода на страницы входа

• Резервное копирование и восстановление состояния cookie-файлов

• Устранение неполадок, связанных с файлами cookie

• Манипулирование атрибутами cookie (срок действия, флаги безопасности и т. д.)

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

• Реализуйте настоящую логику взаимодействия на основе ref для щелчка, ввода текста, перетаскивания, наведения, select_option.

• Реализуйте скриншоты, специфичные для элемента, с помощью ref .

• Добавьте больше стандартных инструментов MCP (вкладки, навигация и т. д.).

• Добавьте тесты.