Primeros pasos Comparación Recetas
Servidor MCP de CloakBrowser¶
cloakbrowser-mcp es un servidor de automatización de navegador compatible con Playwright MCP como drop-in, con herramientas upstream sin cambios, CloakBrowser Chromium y empaquetado listo para npm, Docker y Streamable HTTP. Ejecuta upstream @playwright/mcp como superficie canónica de herramientas de navegador y añade alrededor funciones de ejecución CloakBrowser orientadas al despliegue.
Demo de 30 segundos¶
Mira el primer arranque: inicia el paquete npm, conecta un cliente MCP, pide investigación web, automatización o pruebas, e inspecciona el resultado en un navegador real.
Úsalo cuando quieras herramientas de navegador compatibles con Playwright MCP junto con perfiles persistentes, carga de extensiones, validación de contexto, coincidencia GeoIP de proxy para QA regional o entrada humanizada.
Versión actual: v1.7.0.
Compatibilidad entre versiones¶
| 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 | Comparado en CI |
1.6.1 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparado en CI |
1.6.0 | ^0.0.77 | mcr.microsoft.com/playwright/mcp:v0.0.77 | ^0.4.7 | stdio, Streamable HTTP | Comparado en CI |
1.5.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.4.3 | stdio, Streamable HTTP | Comparado en CI |
1.4.0 | ^0.0.76 | mcr.microsoft.com/playwright/mcp:v0.0.76 | ^0.3.32 | stdio, Streamable HTTP | Comparado en CI |
1.3.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.31 | stdio, Streamable HTTP | Comparado en CI |
1.2.7 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.6 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.5 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.3 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.2.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.1.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio, Streamable HTTP | Comparado en CI |
1.0.2 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado en CI |
1.0.1 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado en CI |
1.0.0 | ^0.0.75 | mcr.microsoft.com/playwright/mcp:v0.0.75 | ^0.3.30 | stdio | Comparado en CI |
Consulta Compatibilidad de versiones para ver la correspondencia actualizada entre las versiones SemVer de este proyecto y las versiones de Playwright MCP del proyecto original.
¿Qué es?¶
- Ejecución del puente
Inicia upstream Playwright MCP como proceso hijo y reenvía sin cambios las llamadas a las herramientas del navegador.
- Ejecución de CloakBrowser
Genera una configuración de Playwright MCP con launchOptions.executablePath apuntando a CloakBrowser.
- npm CLI
Se publica como un paquete CLI ligero de Node.js para clientes MCP por stdio y Streamable HTTP.
- Imagen Docker
Se basa en la imagen oficial de Playwright MCP y precarga la caché del binario de CloakBrowser.
- Coincidencia GeoIP del proxy
Alinea la zona horaria, el idioma y la configuración regional de la huella de CloakBrowser con la ubicación del proxy configurado.
- Comportamiento de entrada humanizado
Dirige las interacciones de la página mediante la capa de ratón, teclado y desplazamiento de CloakBrowser con comportamiento similar al humano.
Superficie de la herramienta¶
Los contratos de la herramienta Playwright MCP, situada en la fase previa, son los que prevalecen. Este proyecto solo añade dos herramientas de introspección locales:
cloakbrowser_binary_infocloakbrowser_bridge_info
Próximos pasos¶
- Primeros pasos para la configuración de npm, Docker y el cliente MCP.
- Configuración de las variables de entorno compatibles.
- Coincidencia de proxy GeoIP para el control de calidad regional, los metadatos del proxy en tiempo de ejecución y las sesiones HTTP «Streamable» en múltiples ubicaciones.
- Comportamiento humanizado de la entrada para el realismo de la interacción, la configuración y los casos de uso.
- Herramientas para definir las expectativas de la interfaz de las herramientas y la paridad con los componentes de origen.
- Preguntas frecuentes sobre cuestiones comunes relacionadas con la instalación, Docker, la paridad y la seguridad.
- Guía para colaboradores con detalles sobre el desarrollo, las pruebas, la arquitectura y las versiones.
Más rutas prácticas¶
Para elegir entre Playwright MCP upstream y este paquete, consulta la comparación. Para tareas rápidas, usa las recetas: perfil persistente, extensiones, reverse proxy, QA regional, Claude Desktop, Codex CLI y prueba smoke de CI.