CloakBrowser MCP

io.github.swimmwatch/cloakbrowser-mcp·v1.2.3·Browser Automation

Quality Score

100

/100

Playwright MCP bridge that runs upstream browser tools with the CloakBrowser Chromium binary.

Repository →Website →

§00 Trust verdict · v1 advisory · method

UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01 Install

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

npx -y cloakbrowser-mcp

Claude Desktop (Docker)

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/swimmwatch/cloakbrowser-mcp:1.2.3"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "cloak",
        "PLAYWRIGHT_MCP_HEADLESS": "true",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/data",
        "PLAYWRIGHT_MCP_OUTPUT_MODE": "stdout",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "true",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<cloak_playwright_mcp_extra_args>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST": "127.0.0.1",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT": "3000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT": "/mcp",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN": "<your-cloak_playwright_mcp_http_auth_token>",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND": "memory",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS": "3600000",
        "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX": "32"
      }
    }
  }
}

§02 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_OUTPUT_MODE

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

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK

Patch upstream console message collection for CloakBrowser compatibility.

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

secret

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_OUTPUT_MODE

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

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS

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

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_OUTPUT_MODE

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

CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK

Patch upstream console message collection for CloakBrowser compatibility.

CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS

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

§03 MCP Quality Score · methodology

freshness

completeness

installability

documentation

stability

§04 Alternatives in Browser Automation

ai.smithery/ImRonAI-mcp-server-browserbase

Automate cloud browsers to navigate websites, interact with elements, and extract structured data.…

ai.smithery/browserbasehq-mcp-browserbase

Provides cloud browser automation capabilities using Stagehand and Browserbase, enabling LLMs to i…

com.clauxel.autobrowserapproval/autobrowserapproval-mcp

A paid remote MCP for AI agent browser approval MCP, built to return verdicts, receipts, usage logs,