Сервер 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 для регіонального контролю якості, метаданих проксі під час виконання та сеансів Streamable HTTP у кількох локаціях.
- Гуманізована поведінка введення даних для реалістичності взаємодії, налаштування та сценаріїв використання.
- Інструменти для відповідності очікуванням щодо інтерфейсу інструментів та узгодженості з вищими рівнями.
- FAQ для відповідей на типові запитання щодо встановлення, Docker, сумісності та безпеки.
- Посібник для учасників з детальною інформацією щодо розробки, тестування, архітектури та випуску версій.
Додаткові практичні сценарії¶
Щоб обрати між upstream Playwright MCP і цим пакетом, перегляньте порівняння. Для швидких задач використовуйте рецепти: постійний профіль, розширення, reverse proxy, регіональне QA, Claude Desktop, Codex CLI і smoke-тест CI.