Сервер CloakBrowser MCP¶
cloakbrowser-mcp — это drop-in совместимый с Playwright MCP сервер браузерной автоматизации с неизменёнными upstream-инструментами, CloakBrowser Chromium и готовой упаковкой npm, Docker и Streamable HTTP. Он запускает upstream @playwright/mcp как каноническую поверхность браузерных инструментов и добавляет вокруг неё возможности запуска CloakBrowser для развёртывания.
30-секундная демонстрация¶
Посмотрите первый запуск: запустите npm-пакет, подключите MCP-клиент, попросите выполнить веб-исследование, автоматизацию или тестирование и проверьте результат в настоящем браузере.
Используйте его, когда нужны совместимые с Playwright MCP браузерные инструменты плюс постоянные профили, загрузка расширений, проверка контекста, сопоставление GeoIP прокси для регионального QA или человекоподобный ввод для чувствительных к взаимодействию сценариев.
Текущая версия: v1.7.0.
Совместимость версий¶
| cloakbrowser-mcp | @playwright/mcp | Playwright MCP Docker base | CloakBrowser | Transport | Parity |
|---|---|---|---|---|---|
1.7.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.8 | stdio, Streamable HTTP | Сравнивается в CI |
1.6.1 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Сравнивается в CI |
1.6.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Сравнивается в CI |
1.5.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.4.3 | stdio, Streamable HTTP | Сравнивается в CI |
1.4.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.3.32 | stdio, Streamable HTTP | Сравнивается в CI |
1.3.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.31 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.7 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.6 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.5 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.3 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.2.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.1.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Сравнивается в CI |
1.0.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Сравнивается в CI |
1.0.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Сравнивается в CI |
1.0.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Сравнивается в CI |
См. раздел Совместимость версий, где приведено актуальное сопоставление релизов данного проекта по стандарту SemVer и версий исходного проекта Playwright MCP.
Что это такое¶
- Среда выполнения моста
Запускает upstream Playwright MCP как дочерний процесс и пересылает вызовы браузерных инструментов без изменений.
- Запуск CloakBrowser
Создает конфигурацию Playwright MCP, где launchOptions.executablePath указывает на CloakBrowser.
- npm CLI
Поставляется как тонкий CLI-пакет Node.js для MCP-клиентов stdio и Streamable HTTP.
- Образ Docker
Основан на официальном образе Playwright MCP и предварительно загружает кэш бинарного файла CloakBrowser.
- Сопоставление GeoIP прокси
Согласует часовой пояс, язык и локаль отпечатка CloakBrowser с настроенным местоположением прокси.
- Человекообразное поведение ввода
Направляет взаимодействия со страницей через слой CloakBrowser для человекоподобной работы мыши, клавиатуры и прокрутки.
Поверхность инструмента¶
Определяющими являются контракты инструмента Playwright MCP, расположенные выше по цепочке. В рамках данного проекта добавляются лишь два локальных инструмента интроспекции:
cloakbrowser_binary_infocloakbrowser_bridge_info
Следующие шаги¶
- Начало работы — настройка npm, Docker и клиента MCP.
- Настройка поддерживаемых переменных среды.
- Сопоставление прокси по GeoIP для регионального контроля качества, метаданных прокси во время выполнения и HTTP-сессий Streamable с несколькими местоположениями.
- Гуманизированное поведение ввода для реалистичности взаимодействия, настройки и сценариев использования.
- Инструменты для соответствия ожиданиям в отношении интерфейса инструментов и согласованности с исходным кодом.
- Часто задаваемые вопросы по типичным вопросам об установке, Docker, совместимости и безопасности.
- Руководство для участников с подробностями о разработке, тестировании, архитектуре и выпусках.
Дополнительные практические сценарии¶
Для выбора между upstream Playwright MCP и этим пакетом используйте сравнение. Для быстрых задач используйте рецепты: постоянный профиль, расширения, reverse proxy, региональное QA, Claude Desktop, Codex CLI и smoke-тест CI.