CloakBrowser MCP Setup & Guide

{
  "id": "io.github.swimmwatch/cloakbrowser-mcp",
  "type": "mcp-server",
  "version": "1.14.1",
  "displayName": "CloakBrowser MCP",
  "description": "Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.",
  "repository": {
    "url": "https://github.com/swimmwatch/cloakbrowser-mcp",
    "source": "github"
  },
  "homepage": "https://swimmwatch.github.io/cloakbrowser-mcp/",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "cloakbrowser-mcp",
        "version": "1.14.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
            "description": "Bridge browser engine: cloak or playwright."
          },
          {
            "name": "PLAYWRIGHT_MCP_HEADLESS",
            "description": "Run the browser in headless mode."
          },
          {
            "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
            "description": "Directory where upstream Playwright MCP writes artifacts."
          },
          {
            "name": "PLAYWRIGHT_MCP_CODEGEN",
            "description": "Generate code in typescript, python, java, csharp, or none."
          },
          {
            "name": "PLAYWRIGHT_MCP_SNAPSHOT_BOXES",
            "description": "Include element bounding boxes in browser snapshots."
          },
          {
            "name": "PLAYWRIGHT_MCP_TIMEOUT_SETTLE",
            "description": "Milliseconds to wait after actions for triggered work to settle."
          },
          {
            "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
            "description": "Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
            "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
            "description": "JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
            "description": "Patch upstream console message collection for CloakBrowser compatibility."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH",
            "description": "Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
            "description": "Comma-separated or JSON array of extra Chromium launch arguments."
          }
        ]
      },
      {
        "registryType": "npm",
        "identifier": "cloakbrowser-mcp",
        "version": "1.14.1",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST",
            "description": "Streamable HTTP bind host."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT",
            "description": "Streamable HTTP bind port."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT",
            "description": "Streamable HTTP endpoint path."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN",
            "description": "Optional Streamable HTTP Bearer token.",
            "isSecret": true
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND",
            "description": "Session metadata backend. Only memory is implemented in this release."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS",
            "description": "Idle TTL for Streamable HTTP sessions."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX",
            "description": "Maximum active Streamable HTTP sessions in one process."
          },
          {
            "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
            "description": "Bridge browser engine: cloak or playwright."
          },
          {
            "name": "PLAYWRIGHT_MCP_HEADLESS",
            "description": "Run the browser in headless mode."
          },
          {
            "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
            "description": "Directory where upstream Playwright MCP writes artifacts."
          },
          {
            "name": "PLAYWRIGHT_MCP_CODEGEN",
            "description": "Generate code in typescript, python, java, csharp, or none."
          },
          {
            "name": "PLAYWRIGHT_MCP_SNAPSHOT_BOXES",
            "description": "Include element bounding boxes in browser snapshots."
          },
          {
            "name": "PLAYWRIGHT_MCP_TIMEOUT_SETTLE",
            "description": "Milliseconds to wait after actions for triggered work to settle."
          },
          {
            "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
            "description": "Persistent Chromium profile directory. The bridge resolves it to an absolute path and writes it to generated Playwright MCP config."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
            "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
            "description": "JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
            "description": "Patch upstream console message collection for CloakBrowser compatibility."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH",
            "description": "Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
            "description": "Comma-separated or JSON array of extra Chromium launch arguments."
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "ghcr.io/swimmwatch/cloakbrowser-mcp:1.14.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
            "description": "Bridge browser engine: cloak or playwright."
          },
          {
            "name": "PLAYWRIGHT_MCP_HEADLESS",
            "description": "Run the browser in headless mode."
          },
          {
            "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
            "description": "Directory inside the container where upstream Playwright MCP writes artifacts."
          },
          {
            "name": "PLAYWRIGHT_MCP_CODEGEN",
            "description": "Generate code in typescript, python, java, csharp, or none."
          },
          {
            "name": "PLAYWRIGHT_MCP_SNAPSHOT_BOXES",
            "description": "Include element bounding boxes in browser snapshots."
          },
          {
            "name": "PLAYWRIGHT_MCP_TIMEOUT_SETTLE",
            "description": "Milliseconds to wait after actions for triggered work to settle."
          },
          {
            "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
            "description": "Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
            "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
            "description": "JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
            "description": "Patch upstream console message collection for CloakBrowser compatibility."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH",
            "description": "Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
            "description": "Comma-separated or JSON array of extra Chromium launch arguments."
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "docker.io/swimmwatch/cloakbrowser-mcp:1.14.1",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
            "description": "Bridge browser engine: cloak or playwright."
          },
          {
            "name": "PLAYWRIGHT_MCP_HEADLESS",
            "description": "Run the browser in headless mode."
          },
          {
            "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
            "description": "Directory inside the container where upstream Playwright MCP writes artifacts."
          },
          {
            "name": "PLAYWRIGHT_MCP_CODEGEN",
            "description": "Generate code in typescript, python, java, csharp, or none."
          },
          {
            "name": "PLAYWRIGHT_MCP_SNAPSHOT_BOXES",
            "description": "Include element bounding boxes in browser snapshots."
          },
          {
            "name": "PLAYWRIGHT_MCP_TIMEOUT_SETTLE",
            "description": "Milliseconds to wait after actions for triggered work to settle."
          },
          {
            "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
            "description": "Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
            "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
            "description": "JSON array or comma-separated list of Chrome extension directories inside the container. Requires PLAYWRIGHT_MCP_USER_DATA_DIR."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
            "description": "Patch upstream console message collection for CloakBrowser compatibility."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH",
            "description": "Resolve proxy GeoIP and match CloakBrowser timezone/locale fingerprint flags when PLAYWRIGHT_MCP_PROXY_SERVER is set."
          },
          {
            "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
            "description": "Comma-separated or JSON array of extra Chromium launch arguments."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.swimmwatch/cloakbrowser-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.swimmwatch%2Fcloakbrowser-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}