io.github.swimmwatch/cloakbrowser-mcp icon
io.github.swimmwatch

cloakbrowser-mcp

CloakBrowser MCP

Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.

communityapplication

Package Details

Transportstdio

Environment Variables

PLAYWRIGHT_MCP_BROWSER_ENGINE(str)
Default:cloak

Bridge browser engine: cloak or playwright.

PLAYWRIGHT_MCP_HEADLESS(bool)
Default:true

Run the browser in headless mode.

PLAYWRIGHT_MCP_OUTPUT_DIR(file)
Default:.playwright-mcp

Directory where upstream Playwright MCP writes artifacts.

PLAYWRIGHT_MCP_OUTPUT_MODE(str)
Default:stdout

Return snapshots, console logs, and network logs through stdout or files.

PLAYWRIGHT_MCP_USER_DATA_DIR(file)

Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.

CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS(str)

JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.

CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS(str)

JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK(bool)
Default:true

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH(bool)
Default:false

Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS(str)

Comma-separated or JSON array of extra Chromium launch arguments.

TransportStreamable HTTP

Package Arguments

Named
--transport
streamable-http

Environment Variables

CLOAK_PLAYWRIGHT_MCP_HTTP_HOST(str)
Default:127.0.0.1

Streamable HTTP bind host.

CLOAK_PLAYWRIGHT_MCP_HTTP_PORT(num)
Default:3000

Streamable HTTP bind port.

CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT(str)
Default:/mcp

Streamable HTTP endpoint path.

CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN(str)
Secret

Optional Streamable HTTP Bearer token.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND(str)
Default:memory

Session metadata backend. Only memory is implemented in this release.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS(num)
Default:3600000

Idle TTL for Streamable HTTP sessions.

CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX(num)
Default:32

Maximum active Streamable HTTP sessions in one process.

PLAYWRIGHT_MCP_BROWSER_ENGINE(str)
Default:cloak

Bridge browser engine: cloak or playwright.

PLAYWRIGHT_MCP_HEADLESS(bool)
Default:true

Run the browser in headless mode.

PLAYWRIGHT_MCP_OUTPUT_DIR(file)
Default:.playwright-mcp

Directory where upstream Playwright MCP writes artifacts.

PLAYWRIGHT_MCP_OUTPUT_MODE(str)
Default:stdout

Return snapshots, console logs, and network logs through stdout or files.

PLAYWRIGHT_MCP_USER_DATA_DIR(file)

Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config.

CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS(str)

JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.

CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS(str)

JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK(bool)
Default:true

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH(bool)
Default:false

Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS(str)

Comma-separated or JSON array of extra Chromium launch arguments.

Transportstdio

Environment Variables

PLAYWRIGHT_MCP_BROWSER_ENGINE(str)
Default:cloak

Bridge browser engine: cloak or playwright.

PLAYWRIGHT_MCP_HEADLESS(bool)
Default:true

Run the browser in headless mode.

PLAYWRIGHT_MCP_OUTPUT_DIR(file)
Default:/data

Directory inside the container where upstream Playwright MCP writes artifacts.

PLAYWRIGHT_MCP_OUTPUT_MODE(str)
Default:stdout

Return snapshots, console logs, and network logs through stdout or files.

PLAYWRIGHT_MCP_USER_DATA_DIR(file)

Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.

CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS(str)

JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.

CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS(str)

JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK(bool)
Default:true

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH(bool)
Default:false

Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS(str)

Comma-separated or JSON array of extra Chromium launch arguments.

docker.io/swimmwatch/cloakbrowser-mcp:1.8.0

Transportstdio

Environment Variables

PLAYWRIGHT_MCP_BROWSER_ENGINE(str)
Default:cloak

Bridge browser engine: cloak or playwright.

PLAYWRIGHT_MCP_HEADLESS(bool)
Default:true

Run the browser in headless mode.

PLAYWRIGHT_MCP_OUTPUT_DIR(file)
Default:/data

Directory inside the container where upstream Playwright MCP writes artifacts.

PLAYWRIGHT_MCP_OUTPUT_MODE(str)
Default:stdout

Return snapshots, console logs, and network logs through stdout or files.

PLAYWRIGHT_MCP_USER_DATA_DIR(file)

Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.

CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS(str)

JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.

CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS(str)

JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK(bool)
Default:true

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH(bool)
Default:false

Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS(str)

Comma-separated or JSON array of extra Chromium launch arguments.