Demo Vid
FreeNot checkedRecords narrated walkthroughs of any webapp by orchestrating Playwright, speech-mcp TTS, and FFmpeg composition.
About
Records narrated walkthroughs of any webapp by orchestrating Playwright, speech-mcp TTS, and FFmpeg composition.
README
Demo video pipeline for fleet repos. Records narrated walkthroughs of any webapp by orchestrating Playwright, speech-mcp TTS, and FFmpeg composition — with real background music (songgeneration-mcp), sound effects (sfx-mcp), and crossfade/wipe transitions between pages (vfx-mcp).
Quick Install
uvx mcpb install sandraschi/demo-vid-mcp
Or grab the native Windows installer (Tauri desktop app, no Claude Desktop required) from Releases.
What You Can Do
- Generate a video:
demo_vid_generate(repo="chitchat")— auto-starts the target webapp, records it page-by-page, adds voiceover synced to true speech length, mixes in music/sfx, joins pages with real transitions, composes MP4 - Or drive a native app live:
demo_vid_generate(repo="blender-mcp", script_yaml=<desktop-capture script>)— OBS records a real app window (Blender, Resonite) whilemcp_callsteps actually invoke that app's own MCP server during the recording, not a staged screencast. Seedata/scripts/*.yamlfor working examples and DEMO_VID_MCP_PLAN.md for the architecture. - Draft a script:
demo_vid_script_draft(repo="chitchat")— reads the README and generates a narration script, with a per-page Skip/Show/Detail checklist (demo_vid_list_pages) - Narration that fits the picture: each page's dwell time is stretched to match its actual spoken length (not a fixed guess), so long lines never get cut off mid-sentence
- Browse the depot: Categorized gallery of produced videos with inline player, subtitle tracks (.vtt), poster previews, rebuild, delete, and insert into repo README
- Persistent queue: Background queue manager to schedule and track batch video generation across the fleet
- Chat about it: Built-in chat with personalities, example prompts, and local LLM integration (Ollama/LM Studio)
Tools
| Tool | Description |
|---|---|
demo_vid_generate(repo, script_yaml?, base_url?, theme="dark", aspect_ratio="16:9", resolution="720p", page_config?, voice="heart", music_enabled=False, music_prompt?) |
Full pipeline: voiceover (speech-mcp, wait-aligned to true speech length) → record page-by-page (Playwright with click ripples) → join pages with real transitions (vfx-mcp) or plain cuts → mix in background music (songgeneration-mcp) and timed sound effects (sfx-mcp, via action: sfx script steps) → compose (FFmpeg) → MP4 + WebVTT/SRT subtitles + poster image. Also auto-detects native desktop-capture mode via obs-mcp. |
demo_vid_list_pages(repo) |
List a repo's webapp pages with README-sourced purpose and default Skip/Show/Detail level, for building a page-selection checklist |
demo_vid_script_draft(repo, page_config?) |
Generate a narration YAML from the target repo's README and webapp page structure |
demo_vid_script_validate(yaml) |
Validate a narration script's structure, timing, aspect ratio, and resolution |
demo_vid_list(repo?) |
List produced videos with metadata, poster, and subtitle sidecar paths |
demo_vid_refine(name, feedback) |
Automatically parse user feedback and mutate YAML narration timing, voice, and steps |
demo_vid_help |
List all tools and usage information |
demo_vid_shutdown |
Gracefully terminate the server and background queue worker |
Webapp
| Page | Purpose |
|---|---|
| Dashboard | Backend status, KPI cards, dead port detection with one-click reconnect |
| Depot | Categorized gallery with HTML5 player, subtitle toggle, poster previews, rebuild, delete |
| Queue | Persistent background job queue manager with live polling, status badges, and cancel controls |
| Generate | Select target repo by category, per-page Skip/Show/Detail checklist, aspect ratio/resolution, draft YAML, and generate or queue |
| Choreography | Visual script builder — 11 step types (including timed sound effects and native transitions), global options, YAML preview |
| Speech | Voice picker (shared with Generate/Choreography), speech-mcp health, text-to-preview |
| Music | Background-music enable + mood/style prompt, songgeneration-mcp health, generate-and-preview |
| Chat | SOTA chat with personalities, localStorage, example prompts, LLM integration |
| Settings | LLM provider probe (Ollama/LM Studio), model selection, persistence |
| Logs | Ring-buffer log viewer with level filter and search |
| Help | 6-tab reference: overview, architecture, tools, config, fleet, troubleshooting |
Autostart
demo_vid_generate automatically starts the target repo's backend and Vite frontend before recording. Zombie-kills stale processes first. No manual setup — the pipeline scans for start.ps1 and webapp/ directories.
Themes
Recording is dark-mode by default (fleet identity). Pass theme="light" to record a bright demo — the capture script forces the target webapp's theme class (handles both .dark toggling and persisted localStorage light-mode keys) before navigation, per chat_skills_prefab_standard.md §7.1.
Fleet Services
Required: speech-mcp (voiceover), Playwright (recording), FFmpeg (composition). Optional: songgeneration-mcp (background music — Lyria/ACE-Step/Stable Audio/Studio, tried in order), sfx-mcp (timed sound effects, FreeSound CC0), vfx-mcp (real crossfade/wipe/slide transitions between pages — falls back to a plain cut when unavailable), blender-mcp (3D titles).
Desktop-capture mode (native apps driven live — see DEMO_VID_MCP_PLAN.md): windows-computer-use-mcp (window focus), obs-mcp (recording — window-capture and human-in-video), plus whichever MCP server the demo actually drives (blender-mcp, resonite-mcp, ...).
Ports
Backend: 11134, Frontend: 11135, speech-mcp: 10909, songgeneration-mcp: 10885, sfx-mcp: 11120, vfx-mcp: 11122. See WEBAPP_PORTS.md.
Documentation
| Doc | Contents |
|---|---|
| Roadmap & Architecture | Desktop-capture mode design, the mcp_call step type, the real remaining constraint (no Resonite camera control), v0.3 plans |
| Installation | All install methods, prerequisites |
| Configuration | Env vars, config options |
| Tool Reference | All available tools |
| Development | Contributing, local setup |
| Troubleshooting | Common issues |
Requirements
- Python 3.13+ with
uv - FFmpeg (for composition)
- speech-mcp (for voiceover)
- Playwright (for recording, auto-installed)
License
MIT
Installing Demo Vid
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/demo-vid-mcpFAQ
Is Demo Vid MCP free?
Yes, Demo Vid MCP is free — one-click install via Unyly at no cost.
Does Demo Vid need an API key?
No, Demo Vid runs without API keys or environment variables.
Is Demo Vid hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Demo Vid in Claude Desktop, Claude Code or Cursor?
Open Demo Vid on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Playwright
Browser automation, scraping, screenshots
by MicrosoftPuppeteer
Browser automation and web scraping.
by modelcontextprotocolGarmin Connect
An MCP server for Garmin Connect that provides access to fitness activities, health statistics, and sleep data by routing requests through a headless browser to
by etweisbergHiggsfield Unlimited
MCP server for Higgsfield AI that enables unlimited-mode image, video, audio generation, uploads, and job management via multiple parallel accounts, using brows
by nukIeeropentabs-dev/opentabs
Plugin-based server and Chrome extension that gives AI agents access to web apps through your authenticated browser session, with a plugin SDK.
by opentabs-devhlydecker/ucsc-genome-mcp
Interact with the UCSC Genome Browser API to find genomes, chromosomes and more.
by hlydecker34892002/bilibili-mcp-js
Search Bilibili content, with LangChain integration examples.
by 34892002achiya-automation/safari-mcp
Native Safari browser automation without a Chrome dependency.
by achiya-automationagent-infra/mcp-server-browser
Browser automation using Puppeteer, supporting local and remote browser connections.
by bytedanceaparajithn/agent-scraper-mcp
Web scraping: clean content extraction, CSS-selector scraping, Playwright screenshots, link and metadata extraction, and Google search.
by aparajithnCompare Demo Vid with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All browse MCPs
