server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.swimmwatch/cloakbrowser-mcp",
  "title": "CloakBrowser MCP",
  "description": "Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.",
  "version": "1.9.0",
  "websiteUrl": "https://swimmwatch.github.io/cloakbrowser-mcp/",
  "repository": {
    "url": "https://github.com/swimmwatch/cloakbrowser-mcp",
    "source": "github"
  },
  "icons": [
    {
      "src": "https://swimmwatch.github.io/cloakbrowser-mcp/assets/brand/logo.svg",
      "mimeType": "image/svg+xml",
      "sizes": ["any"]
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "cloakbrowser-mcp",
      "version": "1.9.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
          "description": "Bridge browser engine: cloak or playwright.",
          "format": "string",
          "default": "cloak"
        },
        {
          "name": "PLAYWRIGHT_MCP_HEADLESS",
          "description": "Run the browser in headless mode.",
          "format": "boolean",
          "default": "true"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
          "description": "Directory where upstream Playwright MCP writes artifacts.",
          "format": "filepath",
          "default": ".playwright-mcp"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
          "description": "Return snapshots, console logs, and network logs through stdout or files.",
          "format": "string",
          "default": "stdout"
        },
        {
          "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.",
          "format": "filepath"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
          "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
          "description": "JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
          "format": "boolean",
          "default": "true"
        },
        {
          "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.",
          "format": "boolean",
          "default": "false"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
          "format": "string"
        }
      ]
    },
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "cloakbrowser-mcp",
      "version": "1.9.0",
      "packageArguments": [
        {
          "type": "named",
          "name": "--transport",
          "value": "streamable-http"
        }
      ],
      "transport": {
        "type": "streamable-http",
        "url": "http://127.0.0.1:3000/mcp"
      },
      "environmentVariables": [
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_HOST",
          "description": "Streamable HTTP bind host.",
          "format": "string",
          "default": "127.0.0.1"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_PORT",
          "description": "Streamable HTTP bind port.",
          "format": "number",
          "default": "3000"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_ENDPOINT",
          "description": "Streamable HTTP endpoint path.",
          "format": "string",
          "default": "/mcp"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN",
          "description": "Optional Streamable HTTP Bearer token.",
          "format": "string",
          "isSecret": true
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_BACKEND",
          "description": "Session metadata backend. Only memory is implemented in this release.",
          "format": "string",
          "default": "memory"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_IDLE_TTL_MS",
          "description": "Idle TTL for Streamable HTTP sessions.",
          "format": "number",
          "default": "3600000"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_HTTP_SESSION_MAX",
          "description": "Maximum active Streamable HTTP sessions in one process.",
          "format": "number",
          "default": "32"
        },
        {
          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
          "description": "Bridge browser engine: cloak or playwright.",
          "format": "string",
          "default": "cloak"
        },
        {
          "name": "PLAYWRIGHT_MCP_HEADLESS",
          "description": "Run the browser in headless mode.",
          "format": "boolean",
          "default": "true"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
          "description": "Directory where upstream Playwright MCP writes artifacts.",
          "format": "filepath",
          "default": ".playwright-mcp"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
          "description": "Return snapshots, console logs, and network logs through stdout or files.",
          "format": "string",
          "default": "stdout"
        },
        {
          "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.",
          "format": "filepath"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
          "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS",
          "description": "JSON array or comma-separated list of Chrome extension directories. Requires PLAYWRIGHT_MCP_USER_DATA_DIR.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
          "format": "boolean",
          "default": "true"
        },
        {
          "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.",
          "format": "boolean",
          "default": "false"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
          "format": "string"
        }
      ]
    },
    {
      "registryType": "oci",
      "identifier": "ghcr.io/swimmwatch/cloakbrowser-mcp:1.9.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
          "description": "Bridge browser engine: cloak or playwright.",
          "format": "string",
          "default": "cloak"
        },
        {
          "name": "PLAYWRIGHT_MCP_HEADLESS",
          "description": "Run the browser in headless mode.",
          "format": "boolean",
          "default": "true"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
          "description": "Directory inside the container where upstream Playwright MCP writes artifacts.",
          "format": "filepath",
          "default": "/data"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
          "description": "Return snapshots, console logs, and network logs through stdout or files.",
          "format": "string",
          "default": "stdout"
        },
        {
          "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
          "description": "Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.",
          "format": "filepath"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
          "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.",
          "format": "string"
        },
        {
          "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.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
          "format": "boolean",
          "default": "true"
        },
        {
          "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.",
          "format": "boolean",
          "default": "false"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
          "format": "string"
        }
      ]
    },
    {
      "registryType": "oci",
      "identifier": "docker.io/swimmwatch/cloakbrowser-mcp:1.9.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
          "description": "Bridge browser engine: cloak or playwright.",
          "format": "string",
          "default": "cloak"
        },
        {
          "name": "PLAYWRIGHT_MCP_HEADLESS",
          "description": "Run the browser in headless mode.",
          "format": "boolean",
          "default": "true"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
          "description": "Directory inside the container where upstream Playwright MCP writes artifacts.",
          "format": "filepath",
          "default": "/data"
        },
        {
          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
          "description": "Return snapshots, console logs, and network logs through stdout or files.",
          "format": "string",
          "default": "stdout"
        },
        {
          "name": "PLAYWRIGHT_MCP_USER_DATA_DIR",
          "description": "Persistent Chromium profile directory inside the container. Use /data/profiles/... with the existing /data volume.",
          "format": "filepath"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS",
          "description": "JSON object with validated Playwright context options such as viewport, locale, timezoneId, permissions, geolocation, and headers.",
          "format": "string"
        },
        {
          "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.",
          "format": "string"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
          "format": "boolean",
          "default": "true"
        },
        {
          "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.",
          "format": "boolean",
          "default": "false"
        },
        {
          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
          "format": "string"
        }
      ]
    }
  ]
}