git404hub

what is video-mcp fr?

wgawan/video-mcp — explained in plain English

Analysis updated 2026-05-18

1JavaScriptAudience · developerComplexity · 4/5Setup · hard

tl;dr

An MCP server that lets AI coding agents record your screen and automatically produce a narrated video walkthrough of what happened.

vibe map

mindmap
  root((video-mcp))
    What it does
      Records screen
      Detects key moments
      Adds narration
    Tech stack
      Node.js
      Python
      ffmpeg
    Use cases
      Bug documentation
      Workflow demos
      Automated tutorials
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Have an AI agent record a screen session and auto-generate a narrated bug report video.

VIBE 2

Automatically detect key interface changes and cut, zoom, or slow down relevant clips.

VIBE 3

Generate a text-to-speech voiceover, overlay it, and stitch clips with transitions into a finished video.

what's the stack?

Node.jsPythonffmpegtesseract-ocrMCP

how it stacks up fr

wgawan/video-mcpabhishek-kumar09/testacip/slack-claude-agent
Stars111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-05-29
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Currently Linux/X11 only, alpha stage, tested on a single Ubuntu machine.

in plain english

video-mcp is a server that plugs into AI coding tools (using the Model Context Protocol, or MCP, a standard interface for giving AI assistants new capabilities) and lets the AI agent record your screen, analyze what happened, and produce a narrated video walkthrough. The main use case is helping an AI agent document a bug or demonstrate a workflow without any manual video editing. The tool covers the full pipeline from recording to a finished video. It can start and stop a screen recording, then automatically detect the key moments where the interface changed, cut out relevant clips, zoom into specific areas, and slow down or speed up sections. Once the visuals are assembled, it can generate a spoken voiceover from a script using text-to-speech (either online or offline with a downloaded voice model), overlay the narration, add background music, burn text labels onto frames, animate cursor highlights, and stitch everything together with transitions or hard cuts. The project currently runs on Linux with the X11 display system only. It depends on Node.js, Python, ffmpeg, and tesseract-ocr for detecting on-screen text elements. It is at an alpha stage and was tested on a single Ubuntu machine. The non-recording tools for analysis, annotation, narration, and assembly are described as mostly platform-agnostic and may work on other systems with minor changes. The full README is longer than what was provided.

prompts (copy fr)

prompt 1
Show me how to install video-mcp's dependencies including ffmpeg and tesseract-ocr on Ubuntu.
prompt 2
Explain how video-mcp detects key moments in a screen recording to cut relevant clips.
prompt 3
Walk me through connecting video-mcp to an AI coding tool over MCP to document a bug.
prompt 4
What platforms does video-mcp currently support and what are its main limitations?

Frequently asked questions

what is video-mcp fr?

An MCP server that lets AI coding agents record your screen and automatically produce a narrated video walkthrough of what happened.

What language is video-mcp written in?

Mainly JavaScript. The stack also includes Node.js, Python, ffmpeg.

How hard is video-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is video-mcp for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.