Log inSubmit server
Cloakbrowser MCP logo

Cloakbrowser MCP

by swimmwatch

Automates Chromium through Playwright-compatible MCP tools, with npm and Docker packaging plus stdio and Streamable HTTP transports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Cloakbrowser MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "swimmwatch-cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

swimmwatch/cloakbrowser-mcp provides Playwright-compatible browser automation through CloakBrowser Chromium. It exposes upstream browser controls for navigation, page inspection, interaction, tabs, screenshots, network requests, and JavaScript, plus tools for runtime diagnostics. Install it with npm or Docker and connect over stdio or Streamable HTTP when an agent needs web research, testing, or repeatable browser workflows.

Use cases

  • Automate browser-based research workflows
  • Test websites and regional experiences
  • Fill forms and upload files
  • Inspect page accessibility and network activity
  • Run browser tasks with persistent profiles or extensions

Key features

  • Playwright-compatible browser automation
  • CloakBrowser Chromium runtime
  • npm and Docker distribution
  • stdio and Streamable HTTP transports
  • Accessibility snapshots and network inspection
  • Optional managed CDP access

Tools26

What Cloakbrowser MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/8 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · cloakbrowser-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars172Stargazers on the source repository.
npm downloads2.2kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed26Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Cloakbrowser MCP works

What swimmwatch/cloakbrowser-mcp does

swimmwatch/cloakbrowser-mcp exposes CloakBrowser Chromium to MCP clients through the Playwright MCP-compatible tool surface. It is intended for browser automation tasks such as web research, UI testing, form completion, file interaction, and workflows that need a real browser page rather than an API-only integration.

The server keeps the upstream Playwright MCP tools and adds two CloakBrowser-specific introspection tools. cloakbrowser_binary_info reports package, cache, platform, and resolved browser-binary details. cloakbrowser_bridge_info returns runtime information about the bridge connecting CloakBrowser to upstream Playwright MCP.

Additional capabilities include persistent browser profiles, validated context options, Chrome extension loading, GeoIP-aware proxy matching for regional QA, and humanized mouse, keyboard, and scroll behavior. Managed CDP access is available as an opt-in, session-scoped feature for clients that support chromium.connectOverCDP().

How it works

The server runs upstream @playwright/mcp as its canonical tool layer while directing the runtime to CloakBrowser Chromium. Agents can use accessibility snapshots and targeted searches to locate page elements, then interact with those elements through clicks, typing, keyboard presses, form filling, selections, dragging, hovering, and file operations.

Page state can be inspected with accessibility snapshots, screenshots, console messages, and network request listings. A numbered network request can be expanded with browser_network_request, including selected request parts. Browser tabs can be listed, created, closed, or selected, and the server supports navigation history, resizing, dialog handling, waiting, and page-level JavaScript evaluation.

The package supports both stdio and Streamable HTTP transports. npm runs work across Linux, macOS, and Windows on the supported Node.js versions. Docker images target Linux on amd64 and arm64.

Setup and configuration

The npm quick start is:

Terminal
npx -y cloakbrowser-mcp@latest

Node.js 22.13 or later in the 22.x series, or Node.js 24 or later, is required. Run the built-in diagnostic command before connecting a client:

Terminal
npx -y cloakbrowser-mcp@latest doctor

To use Streamable HTTP instead of stdio, start the server with a port:

Terminal
npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000

Docker is also supported. Mount /data when browser artifacts need to be retained, and publish port 3000 for an HTTP deployment. The image is available from Docker Hub and GitHub Container Registry. Docker defaults CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX to true; set it to false when the host and container runtime support Chromium sandboxing.

MCP configuration examples are provided for Claude Desktop, Cursor, Cline, Windsurf, Codex CLI, Claude Code, and GitHub Copilot in VS Code. A standard mcpServers entry can launch the npm package, while Docker-backed stdio can launch the container directly.

Tools and capabilities

  • Navigate pages and return to earlier history entries.
  • Capture accessibility snapshots and screenshots.
  • Find text or regular expressions in the accessibility tree.
  • Click, hover, drag, type, press keys, fill forms, and select options.
  • Upload files or drop files and MIME-typed data onto elements.
  • Manage dialogs, tabs, window size, and wait conditions.
  • Inspect console output and network requests.
  • Evaluate page or element JavaScript.
  • Run Playwright code through the explicitly unsafe browser_run_code_unsafe tool.
  • Inspect CloakBrowser binary and bridge runtime details.

Limitations and notes

Screenshots are intended for visual inspection; actions should be based on browser_snapshot instead. browser_run_code_unsafe executes arbitrary JavaScript in the Playwright server process and is equivalent to remote code execution, so it requires strict trust and deployment controls.

For container deployments, keep network access and mounted host directories narrowly scoped when browsing untrusted pages. The Docker image writes artifacts to /data. Streamable HTTP deployments can bind to a configured host and port, while stdio is suitable for clients that launch the process directly.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Cloakbrowser MCP

swimmwatch/cloakbrowser-mcp is an MCP server that connects MCP clients to CloakBrowser Chromium through the Playwright MCP tool surface. It provides navigation, snapshots, interaction, forms, tabs, screenshots, network inspection, JavaScript evaluation, and browser and bridge diagnostics for web research, testing, and automation.

Install it with `npx -y cloakbrowser-mcp@latest`, or run the published Docker image. npm use requires Node.js 22.13 or later in the 22.x line, or Node.js 24 or later. The server can run over stdio or Streamable HTTP.

Yes, Cursor is supported through a standard `mcpServers` configuration entry. The entry can launch `npx -y cloakbrowser-mcp@latest` over stdio, allowing Cursor to access the browser automation tools.

Run the `swimmwatch/cloakbrowser-mcp:latest` image and mount `/data` for artifacts. For Streamable HTTP, publish port 3000 and pass the HTTP transport, host, and port options. Images are published for Linux amd64 and arm64.

Related MCP servers

All in Browser Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCloakbrowser MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/swimmwatch-cloakbrowser-mcp?style=directory)](https://allmcps.com/mcp/swimmwatch-cloakbrowser-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/swimmwatch-cloakbrowser-mcp"><img src="https://allmcps.com/api/badge/swimmwatch-cloakbrowser-mcp?style=directory" alt="Cloakbrowser MCP on AllMCPs" /></a>