CloakBrowser MCP

Servidor CloakBrowser MCP para agentes de IA: navegación impulsada por Playwright, reenvío limpio de herramientas, soporte para Docker y transporte HTTP multisession.

GitHub

Prueba este MCPPatrocinado

Documentación

cloakbrowser-mcp

cloakbrowser-mcp es un servidor de automatización de navegador compatible con Playwright MCP, con herramientas upstream sin cambios, CloakBrowser Chromium, y empaquetado listo para producción con npm, Docker y Streamable HTTP. Ejecuta el @playwright/mcp upstream como superficie de herramientas canónica y apunta ese runtime a CloakBrowser.

Demo de 30 segundos

Ejecuta npx -y cloakbrowser-mcp@latest, conecta Claude Desktop o Codex CLI, pide investigación web, automatización diaria o pruebas en inglés sencillo, e inspecciona el resultado real del navegador.

Documentación: swimmwatch.github.io/cloakbrowser-mcp · Comparación · Recetas

Úsalo cuando necesites:

Automatización de navegador con Playwright MCP respaldada por CloakBrowser;
herramientas de navegador upstream sin cambios más dos herramientas locales de introspección;
instalación con npm o Docker sobre stdio o Streamable HTTP;
acceso CDP gestionado opcional y limitado a la sesión para clientes compatibles con CDP a través de chromium.connectOverCDP();
perfiles de navegador persistentes, opciones de contexto validadas y carga de extensiones de Chrome;
coincidencia de proxy con reconocimiento GeoIP para QA regional;
comportamiento humanizado de mouse, teclado y desplazamiento para flujos sensibles a la interacción.

Las verificaciones multiplataforma cubren npm en Linux x64/arm64, macOS arm64/x64 y Windows x64 con Node.js 22 y 24-26. Las imágenes Docker se compilan y se someten a pruebas de humo para linux/amd64 y linux/arm64.

Consulta @playwright/mcp vs cloakbrowser-mcp al decidir si el Playwright MCP upstream simple o CloakBrowser MCP se adapta mejor a un despliegue. Las páginas de Recetas muestran rutas de configuración enfocadas en tareas para perfiles de inicio de sesión persistentes, extensiones de Chrome, proxies inversos, QA regional, conexiones de clientes y pruebas de humo en CI.

Instalar con npm

npx -y cloakbrowser-mcp@latest

Requiere Node.js 22.13+ en la línea 22.x, o Node.js 24+. Ejecuta diagnósticos antes de conectar un cliente:

npx -y cloakbrowser-mcp@latest doctor

Para Streamable HTTP en lugar de stdio:

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000

Consulta la Referencia de CLI generada para todas las opciones.

Instalar con Docker

docker run --rm -i \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

Para Streamable HTTP:

docker run --rm -p 127.0.0.1:3000:3000 \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  --transport streamable-http --http-host 0.0.0.0 --http-port 3000

La imagen Docker escribe artefactos en /data y se publica para linux/amd64 y linux/arm64. Por defecto usa CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=true para compatibilidad con runtimes contenedorizados donde el sandboxing de Chromium suele no estar disponible. Si tu host y runtime de contenedor admiten el sandboxing de Chromium, establece CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX=false; para páginas no confiables, mantén el acceso de red del contenedor y los directorios montados del host estrictamente limitados. Las mismas etiquetas también están disponibles desde ghcr.io/swimmwatch/cloakbrowser-mcp. Consulta Docker para perfiles persistentes, montajes de extensiones, HTTPS y ejemplos de pruebas de humo, o usa la receta de proxy inverso para un despliegue enfocado de Streamable HTTP.

Agregar a clientes MCP

Codex CLI

codex mcp add cloakbrowser -- npx -y cloakbrowser-mcp@latest

Claude Code

claude mcp add --transport stdio cloakbrowser -- npx -y cloakbrowser-mcp@latest

GitHub Copilot en VS Code

{
  "servers": {
    "cloakbrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

Claude Desktop, Cursor, Cline, Windsurf, Warp y otros clientes `mcpServers`

Agrega esta entrada de servidor a la configuración JSON de MCP del cliente:

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "npx",
      "args": ["-y", "cloakbrowser-mcp@latest"]
    }
  }
}

stdio respaldado por Docker

{
  "mcpServers": {
    "cloakbrowser": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "/tmp/cloakbrowser-artifacts:/data",
        "swimmwatch/cloakbrowser-mcp:latest"
      ]
    }
  }
}

Servidor Streamable HTTP ya en ejecución

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000
codex mcp add cloakbrowser --url http://127.0.0.1:3000/mcp
claude mcp add --transport http cloakbrowser http://127.0.0.1:3000/mcp

Prompt para un asistente de código

Pega esto en Codex, Claude Code, Copilot, Cursor, Cline, Windsurf o un asistente de codificación similar que pueda editar la configuración de MCP:

Install the CloakBrowser MCP server for this workspace. Name it "cloakbrowser".
Prefer stdio with command "npx" and args ["-y", "cloakbrowser-mcp@latest"].
If this client uses VS Code mcp.json, add it under "servers" with type "stdio".
If this client uses Claude/Cursor/Cline/Windsurf/Warp-style config, add it under
"mcpServers" with the same command and args. Do not add secrets.

Hay más ejemplos en Primeros pasos, con recetas dedicadas para Claude Desktop y Codex CLI.

Configuración

Usa las variables PLAYWRIGHT_MCP_* upstream para configuración de navegador, artefactos, tiempos de espera, red y capacidades de herramientas. Los interruptores de puente específicos de Cloak usan CLOAK_PLAYWRIGHT_MCP_*. Selecciona una compilación de navegador Pro Preview antes del inicio con --release-channel preview o CLOAK_PLAYWRIGHT_MCP_RELEASE_CHANNEL=preview; el valor predeterminado es stable.

La tabla común de variables ahora está en Configuración. Esa página también cubre perfiles persistentes, opciones de contexto validadas, extensiones de Chrome, metadatos de Streamable HTTP y opciones de HTTPS/auth. Consulta Coincidencia de proxy GeoIP para el comportamiento de proxy regional, Comportamiento de entrada humanizado para realismo de interacción y Recetas para configuraciones enfocadas en tareas.

Compatibilidad de versiones

cloakbrowser-mcp	@playwright/mcp	CloakBrowser	Node.js	Plataforma
`1.14.1`	`^0.0.82`	`^0.5.10`	`^22.13.0
`1.14.0`	`^0.0.82`	`^0.5.10`	`^22.13.0
`1.13.0`	`^0.0.80`	`^0.5.10`	`^22.13.0
`1.12.0`	`^0.0.79`	`^0.5.7`	`^22.13.0
`1.11.0`	`^0.0.79`	`^0.5.6`	`^22.13.0
`1.10.0`	`^0.0.78`	`^0.5.3`	`^22.13.0
`1.9.0`	`^0.0.78`	`^0.5.1`	`^22.13.0
`1.8.0`	`^0.0.78`	`^0.4.10`	`^22.13.0
`1.7.0`	`^0.0.77`	`^0.4.8`	`>=22.12`	npm en Linux x64/arm64, macOS arm64/x64, Windows x64; Docker `linux/amd64`, `linux/arm64`
`1.6.1`	`^0.0.77`	`^0.4.7`	`>=22.12`	npm en Linux x64/arm64, macOS arm64/x64, Windows x64; Docker `linux/amd64`, `linux/arm64`
`1.6.0`	`^0.0.77`	`^0.4.7`	`>=22.12`	npm en Linux x64/arm64, macOS arm64/x64, Windows x64; Docker `linux/amd64`, `linux/arm64`
`1.5.0`	`^0.0.76`	`^0.4.3`	`>=22.12`	npm en Linux x64/arm64, macOS arm64/x64, Windows x64; Docker `linux/amd64`, `linux/arm64`
`1.4.0`	`^0.0.76`	`^0.3.32`	`>=22.12`	npm en Linux x64/arm64, macOS arm64/x64, Windows x64; Docker `linux/amd64`, `linux/arm64`
`1.3.0`	`^0.0.75`	`^0.3.31`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.7`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.6`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.5`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.3`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.2`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.1`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.2.0`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.1.0`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.0.2`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.0.1`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local
`1.0.0`	`^0.0.75`	`^0.3.30`	`>=20`	Docker `linux/amd64`, Node.js local

Consulta Compatibilidad de versiones para la tabla de compatibilidad mantenida.

Herramientas

La lista de herramientas de Playwright MCP upstream es la autoritativa. Este proyecto no reimplementa ni redocumenta los esquemas de navegador upstream en el código fuente.

Herramientas locales:

cloakbrowser_binary_info devuelve datos del paquete CloakBrowser, plataforma, caché y binario resuelto.
cloakbrowser_bridge_info devuelve metadatos del puente, paquete/versión upstream y nombres de herramientas locales.

Desarrollo

npm install
npm run build
npm test
npm run docker:build
npm run docker:smoke
npm run server:validate
npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json

La documentación comienza en docs/getting-started.md. El material para colaboradores está agrupado en docs/contributor-guide.md.