Regional QA Through Proxy¶

Use GeoIP proxy matching when a QA task depends on a consistent network region, timezone, language, and locale profile.

npm¶

PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
  CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
  npx -y cloakbrowser-mcp@latest

Percent-encode special characters in proxy credentials before putting them in the URL.

Docker¶

docker run --rm --init -i \
  -e PLAYWRIGHT_MCP_PROXY_SERVER="http://user:pass@proxy.example:8080" \
  -e CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH=true \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

Streamable HTTP Session Metadata¶

One Streamable HTTP server can accept different proxy settings per MCP session:

{
  "params": {
    "_meta": {
      "io.github.swimmwatch/cloakbrowser-mcp": {
        "proxyServer": "http://user:pass@proxy.example:8080",
        "proxyBypass": ".internal,localhost",
        "geoipProxyMatch": true
      }
    }
  }
}

Existing sessions keep the proxy captured during initialize; start a new session to switch region.

Verify¶

Ask the MCP client to visit an IP or localization test page and compare the observed region, language, and timezone with the proxy provider's expected location.

Related¶

• GeoIP Proxy Matching
• Configuration
• Docker