Skip to content

CI Smoke Test¶

Use a smoke test to catch missing runtime dependencies before an MCP client tries to use browser tools.

npm Package Check¶

npx -y cloakbrowser-mcp@latest doctor --json

This verifies Node.js, package metadata, the effective upstream Playwright MCP CLI, the resolved @playwright/mcp, playwright, and playwright-core versions and package paths, the effective core bundle path, and CloakBrowser binary metadata without starting the bridge.

Streamable HTTP Probe¶

npx -y cloakbrowser-mcp@latest --transport streamable-http --http-port 3000 &
server_pid=$!

for attempt in 1 2 3 4 5; do
  curl -fsS http://127.0.0.1:3000/readyz && break
  sleep 1
done

kill "$server_pid"
wait "$server_pid" || true

Use this only in a short-lived CI job. For production-like smoke tests, run the same probe against the Docker image and the deployment entrypoint you actually ship.

Docker Package Check¶

docker run --rm \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  doctor --json