cloakbrowser-mcp

cloakbrowser-mcp is a drop-in Playwright MCP-compatible browser automation server with unchanged upstream tools, CloakBrowser Chromium, and production-ready npm, Docker, and Streamable HTTP packaging. It runs upstream @playwright/mcp as the canonical tool surface and points that runtime at CloakBrowser.

30-second demo

Run npx -y cloakbrowser-mcp@latest, connect Claude Desktop or Codex CLI, ask for web research, daily automation, or testing in plain English, and inspect the real browser result.

Documentation: swimmwatch.github.io/cloakbrowser-mcp · Comparison · Recipes

Use it when you need:

• Playwright MCP browser automation backed by CloakBrowser;
• unchanged upstream browser tools plus two local introspection tools;
• npm or Docker installation over stdio or Streamable HTTP;
• opt-in, session-scoped managed CDP access for CDP-capable clients through chromium.connectOverCDP();
• persistent browser profiles, validated context options, and Chrome extension loading;
• GeoIP-aware proxy matching for regional QA;
• humanized mouse, keyboard, and scroll behavior for interaction-sensitive flows.

Cross-platform checks cover npm on Linux x64/arm64, macOS arm64/x64, and Windows x64 across the Node.js versions listed in Testing. Docker images are built and smoke-tested for linux/amd64 and linux/arm64.

This is the beginning of the README. Read the rest at the original. Read the full README ↗