Skip to content

CloakBrowser MCP v1.0.0

Choose a tag to compare

View all tags
@swimmwatch swimmwatch released this 23 May 14:49
v1.0.0
5bc9398

CloakBrowser MCP v1.0.0

Initial stable release of cloakbrowser-mcp, a stdio MCP bridge that runs upstream @playwright/mcp browser tools with the CloakBrowser Chromium binary.

Highlights

  • Rebuilt the runtime as a thin bridge over upstream Playwright MCP, forwarding upstream tool schemas, descriptions, annotations, and responses unchanged.
  • Injects CloakBrowser through a generated Playwright MCP config using browser.launchOptions.executablePath.
  • Publishes a CLI-focused npm package with cloakbrowser-mcp as the executable.
  • Publishes a Docker image based on the official mcr.microsoft.com/playwright/mcp:v0.0.75 runtime base.
  • Adds only two local introspection tools: cloakbrowser_binary_info and cloakbrowser_bridge_info.
  • Includes bridge-focused unit tests, fake-upstream integration tests, package verification, Docker smoke tests, and Playwright MCP parity comparison.
  • Ships user-first documentation, GitHub Pages deployment, SEO metadata, llms.txt, CodeQL, Dependency Review, OpenSSF Scorecard, zizmor, npm audit, and Trivy checks.

Compatibility

  • cloakbrowser-mcp: 1.0.0
  • @playwright/mcp: ^0.0.75
  • Playwright MCP Docker base: mcr.microsoft.com/playwright/mcp:v0.0.75
  • CloakBrowser: ^0.3.30
  • Node.js: >=20
  • MCP transport: stdio
  • Docker platform: linux/amd64

Known Limitations

  • The outer bridge supports stdio transport only.
  • Upstream HTTP/SSE transport is not proxied.
  • Upstream Playwright MCP contracts are authoritative and may change when the pinned upstream version changes.

Install

npx -y cloakbrowser-mcp@1.0.0 --help
docker run --rm --init -i ghcr.io/swimmwatch/cloakbrowser-mcp:1.0.0 --help
Assets 2
Loading