CloakBrowser MCP Server

by swimmwatchio.github.swimmwatch/cloakbrowser-mcpv1.14.1

Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.

164Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install CloakBrowser MCP server

claude mcp add cloakbrowser -- npx -y cloakbrowser-mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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.
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	—	yes	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.