CloakBrowser MCP Server¶

cloakbrowser-mcp is a Model Context Protocol browser automation server that runs upstream @playwright/mcp with the CloakBrowser Chromium binary. Use it when you want Playwright MCP-compatible browser tools, CloakBrowser execution, npm installation, or a Docker image for stdio and Streamable HTTP MCP clients.

Current version: v1.1.0.

Version Compatibility¶

cloakbrowser-mcp	@playwright/mcp	Playwright MCP Docker base	CloakBrowser	Transport	Parity
`1.1.0`	`^0.0.75`	`mcr.microsoft.com/playwright/mcp:v0.0.75`	`^0.3.30`	stdio, Streamable HTTP	Compared in CI
`1.0.2`	`^0.0.75`	`mcr.microsoft.com/playwright/mcp:v0.0.75`	`^0.3.30`	stdio	Compared in CI
`1.0.1`	`^0.0.75`	`mcr.microsoft.com/playwright/mcp:v0.0.75`	`^0.3.30`	stdio	Compared in CI
`1.0.0`	`^0.0.75`	`mcr.microsoft.com/playwright/mcp:v0.0.75`	`^0.3.30`	stdio	Compared in CI

See Version Compatibility for the maintained mapping between this project's SemVer releases and upstream Playwright MCP versions.

What It Is¶

Bridge runtime

Starts upstream Playwright MCP as a child process and forwards browser tool calls unchanged.

CloakBrowser execution

Generates a Playwright MCP config with launchOptions.executablePath set to CloakBrowser.

npm CLI

Published as a thin Node.js CLI package for stdio and Streamable HTTP MCP clients.

Docker image

Based on the official Playwright MCP image and preloads the CloakBrowser binary cache.

Tool Surface¶

The upstream Playwright MCP tool contracts are authoritative. This project adds only two local introspection tools:

cloakbrowser_binary_info
cloakbrowser_bridge_info

Next Steps¶

Getting Started for npm, Docker, and MCP client configuration.
Configuration for supported environment variables.
Tools for tool-surface expectations and upstream parity.
FAQ for common installation, Docker, parity, and security questions.
Contributor Guide for development, testing, architecture, and release details.