mcp-video

<!-- badges -->





<!-- /badges -->Cinema-grade video production for AI agents.

8 MCP tools for recording, editing, effects, captions, TTS, and smart screenshots.<br>
Built on ffmpeg and Playwright. Works with any MCP client.

Features · Quick Start · Examples · Architecture

</div>

A note from us

We have been building tools and systems for ourselves for the past two years. The fact that this repo is small and has few stars is not because it is new. It is because we only just decided to share what we have built. It is not a fresh experiment, it is a long story with a recent commit.

We love building things and sharing them. We do not love social media tactics, growth hacks, or chasing stars and followers. So this repo is small. The code is real, it gets used, issues get answered. Judge for yourself.

If it helps you, sharing, testing, and feedback help us. If it could be better, an issue is more useful. If you build something with it, tell us at hello@studiomeyer.io. That genuinely makes our day.

From a small studio in Palma de Mallorca.

Features

| Tool | Operations | Description |
|------|-----------|-------------|
| video_record | cinema, scroll, multi-device | Record websites at 60fps with frame-by-frame capture |
| video_edit | speed, crop, reverse, keyframe, pip | Edit clips with zoom/pan, PiP, slow-mo |
| video_color | grade, effect, lut, chroma | Color grading, 22 LUT presets, green screen |
| video_audio | extract, music, ducking, mix, voice | Audio extraction, mixing, 9 voice effects |
| video_text | subtitles, caption, overlay, animate | Burn SRT, Whisper auto-caption, 15 text animations |
| video_compose | concat, intro, social, beat-sync, templates | Join clips, social format conversion, beat sync |
| video_speech | generate, voices, narrated | ElevenLabs/OpenAI TTS, full narrated videos |
| video_screenshot | capture, detect | Element-aware screenshots, page feature detection |

Highlights

- 60fps frame-by-frame capture — Playwright screenshots every frame, ffmpeg encodes. Zero frame drops.
- Cinema easing curves — 16 easing options including cinematic and showcase for buttery smooth scrolling.
- Smart screenshots — Auto-detects 15+ UI elements (chat widgets, pricing sections, booking forms, etc.).
- Narrated videos — Provide a URL + script, get a professional video with synchronized AI voiceover.
- 22 LUT presets — Film-grade color grading (teal-orange, noir, vintage, cyberpunk, etc.).
- Social format export — One-click conversion to Instagram Reel, TikTok, YouTube Short, LinkedIn.
- Dual transport — Stdio (default) or HTTP mode for persistent microservice deployment.

Prerequisites

- Node.js >= 18
- ffmpeg and ffprobe (validated on startup, cross-platform)
- Playwright browsers (npx playwright install chromium)
- Optional: ELEVENLABS_API_KEY for ElevenLabs TTS
- Optional: OPENAI_API_KEY for Whisper captions and OpenAI TTS

If ffmpeg lives outside PATH, set FFMPEG_PATH and FFPROBE_PATH to the
absolute binary paths. Both env vars are honoured at startup AND at every
runtime spawn site.

Quick Start

With Claude Code (stdio)

{
  "mcpServers": {
    "video": {
      "command": "npx",
      "args": ["-y", "mcp-video"]
    }
  }
}

With npx

npx mcp-video

From source

git clone https://github.com/studiomeyer-io/mcp-video.git
cd mcp-video
npm install
npx playwright install chromium
npm run build
npm start

HTTP mode

```bash