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, upstream Playwright MCP CLI resolution, 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 --init \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  doctor --json