Clone Space MCP

Archive a live web page so it replays offline with the motion intact, and so an AI agent can read how the page is actually built.

Saving a page from a browser gives you a dead skeleton: the markup survives, the behaviour does not. clone-space-mcp targets the other end — a carousel that still slides, a GSAP timeline that still runs, a ScrollTrigger that still fires, with the network unplugged.

How it works

The load-bearing decision is that replay re-executes the original JavaScript. Serializing the hydrated DOM into a standalone document is the approach this project rejects: it breaks hydration and entry animations, which is exactly the fidelity being chased.

Related MCP server: UI Perception Engine

Status

Early. The operating layer and the phase plan are in place; the pipeline is not built yet. Current work is tracked in docs/OPEN-WORK-LEDGER.md and in the repo's GitHub issues.

Development

Bun is the package manager and the runtime — except for code that drives a browser, which runs under Node. Playwright's client does not complete its handshake under Bun; see ADR 0001 for the measurements and what was rejected.

bun install
bun run verify        # lint → typecheck → test → build — the ship gate (Bun)
bun run spike         # the CDP measurement harness (Node, with the fixture served by Bun)

Agents: start with CLAUDE.md.

License

Not yet chosen.