MCP Hub › Browser & Web › CloakBrowser MCP

CloakBrowser MCP MCP server

by swimmwatch · io.github.swimmwatch/cloakbrowser-mcp

Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.

🌐 Browser & WebDockernpmv1.15.1
Open in MCP HubGitHub repository ↗Website ↗

How to install CloakBrowser MCP

npm

claude mcp add cloakbrowser-mcp -- npx -y [email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

Environment variables:
PLAYWRIGHT_MCP_BROWSER_ENGINE – Bridge browser engine: cloak or playwright.
PLAYWRIGHT_MCP_HEADLESS – Run the browser in headless mode.
PLAYWRIGHT_MCP_OUTPUT_DIR – Directory where upstream Playwright MCP writes artifacts.
PLAYWRIGHT_MCP_CODEGEN – Generate code in typescript, python, java, csharp, or none.
PLAYWRIGHT_MCP_SNAPSHOT_BOXES – Include element bounding boxes in browser snapshots.
PLAYWRIGHT_MCP_TIMEOUT_SETTLE – Milliseconds to wait after actions for triggered work to settle.
PLAYWRIGHT_MCP_USER_DATA_DIR – 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 – JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS – JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK – Patch upstream console message collection for CloakBrowser compatibility.
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH – Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS – Comma-separated or JSON array of extra Chromium launch arguments.

npm

claude mcp add cloakbrowser-mcp -- npx -y [email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ]
    }
  }
}

Environment variables:
CLOAK_PLAYWRIGHT_MCP_HTTP_HOST – Streamable HTTP bind host.
CLOAK_PLAYWRIGHT_MCP_HTTP_PORT – Streamable HTTP bind port.
CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT – Streamable HTTP endpoint path.
CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN – Optional Streamable HTTP Bearer token.
CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND – Session metadata backend. Only memory is implemented in this release.
CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS – Idle TTL for Streamable HTTP sessions.
CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX – Maximum active Streamable HTTP sessions in one process.
PLAYWRIGHT_MCP_BROWSER_ENGINE – Bridge browser engine: cloak or playwright.
PLAYWRIGHT_MCP_HEADLESS – Run the browser in headless mode.
PLAYWRIGHT_MCP_OUTPUT_DIR – Directory where upstream Playwright MCP writes artifacts.
PLAYWRIGHT_MCP_CODEGEN – Generate code in typescript, python, java, csharp, or none.
PLAYWRIGHT_MCP_SNAPSHOT_BOXES – Include element bounding boxes in browser snapshots.
PLAYWRIGHT_MCP_TIMEOUT_SETTLE – Milliseconds to wait after actions for triggered work to settle.
PLAYWRIGHT_MCP_USER_DATA_DIR – 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 – JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS – JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK – Patch upstream console message collection for CloakBrowser compatibility.
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH – Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS – Comma-separated or JSON array of extra Chromium launch arguments.

Docker

claude mcp add cloakbrowser-mcp -- docker run -i --rm ghcr.io/swimmwatch/cloakbrowser-mcp:1.15.1

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/swimmwatch/cloakbrowser-mcp:1.15.1"
      ]
    }
  }
}

Environment variables:
PLAYWRIGHT_MCP_BROWSER_ENGINE – Bridge browser engine: cloak or playwright.
PLAYWRIGHT_MCP_HEADLESS – Run the browser in headless mode.
PLAYWRIGHT_MCP_OUTPUT_DIR – Directory inside the container where upstream Playwright MCP writes artifacts.
PLAYWRIGHT_MCP_CODEGEN – Generate code in typescript, python, java, csharp, or none.
PLAYWRIGHT_MCP_SNAPSHOT_BOXES – Include element bounding boxes in browser snapshots.
PLAYWRIGHT_MCP_TIMEOUT_SETTLE – Milliseconds to wait after actions for triggered work to settle.
PLAYWRIGHT_MCP_USER_DATA_DIR – Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS – JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS – JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK – Patch upstream console message collection for CloakBrowser compatibility.
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH – Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS – Comma-separated or JSON array of extra Chromium launch arguments.

Docker

claude mcp add cloakbrowser-mcp -- docker run -i --rm docker.io/swimmwatch/cloakbrowser-mcp:1.15.1

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/swimmwatch/cloakbrowser-mcp:1.15.1"
      ]
    }
  }
}

Environment variables:
PLAYWRIGHT_MCP_BROWSER_ENGINE – Bridge browser engine: cloak or playwright.
PLAYWRIGHT_MCP_HEADLESS – Run the browser in headless mode.
PLAYWRIGHT_MCP_OUTPUT_DIR – Directory inside the container where upstream Playwright MCP writes artifacts.
PLAYWRIGHT_MCP_CODEGEN – Generate code in typescript, python, java, csharp, or none.
PLAYWRIGHT_MCP_SNAPSHOT_BOXES – Include element bounding boxes in browser snapshots.
PLAYWRIGHT_MCP_TIMEOUT_SETTLE – Milliseconds to wait after actions for triggered work to settle.
PLAYWRIGHT_MCP_USER_DATA_DIR – Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.
CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS – JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.
CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS – JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.
CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK – Patch upstream console message collection for CloakBrowser compatibility.
CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH – Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set.
CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS – Comma-separated or JSON array of extra Chromium launch arguments.

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
1.15.1
Published
2026-10-18
Updated
2026-10-18
Namespace
io.github.swimmwatch
Source
swimmwatch/cloakbrowser-mcp

Similar browser & web servers