Skip to main content
Glama

Animated explainer videos from a chat

The full guide: Animated explainer videos from a chat, on an ordinary computer. Example videos: why the sky is blue and black holes in a minute.

A small MCP server that lets Claude turn a topic into a narrated, animated explainer video. It runs on the processor of an ordinary computer: no graphics card, no paid API and no other AI service.

Each scene is an animated web page with a heading and up to four points. Playwright records the page frame by frame, ffmpeg turns the frames into video, and Piper reads the narration. On the test machine a 27 to 31 second, two-scene video took 105 to 125 seconds to make, with nothing running on the graphics card.

example/why-is-the-sky-blue.mp4 is a 31 second video that Claude Code made through this server from the request "explain why the sky is blue for a ten year old".

A scene from the example video: the heading Air Scatters Blue Light over three points

What it needs

  • Claude Code, or another MCP client

  • Python 3.10 or later

  • ffmpeg on the PATH

  • About 200 MB of downloads: Playwright's Chromium (about 124 MB) and one Piper voice (about 63 MB)

Related MCP server: Video Programado

Set it up

macOS or Linux:

git clone https://github.com/randallvollen-boop/animated-explainers-mcp.git
cd animated-explainers-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m playwright install chromium
.venv/bin/python -m piper.download_voices en_US-ljspeech-medium --download-dir voices

Windows (PowerShell): the same steps with .venv\Scripts\python.exe and .venv\Scripts\pip.exe.

Or open Claude Code in the cloned folder and ask it to do the setup above, asking before any command that needs an administrator password.

Check it works without any chat client:

.venv/bin/python try_it.py

It starts the server the way an MCP client does, asks for a two-scene video about black holes and prints the path of the finished MP4 in videos/.

Connect it to Claude Code

claude mcp add explainer -- "$PWD/.venv/bin/python" "$PWD/server.py"
claude mcp list

Then ask in plain words, for example:

Use the explainer tools to make a short narrated video, two scenes, explaining why the sky is blue for a ten year old. Keep each narration to two or three sentences. Wait for it to finish by checking video_status every 20 seconds, then tell me the file path.

Claude writes the scenes, calls make_explainer, checks video_status until the job is done and gives back the file path. Claude cannot watch the video, so watch it before posting it anywhere.

Tested on Linux with Claude Code. Claude Desktop, macOS and Windows were not tested; the Claude Desktop config takes the same command and arguments under mcpServers.

The two tools

Tool

What it does

make_explainer(title, scenes)

Starts a video and returns a job id at once. Each scene has a heading, up to four points and the narration read during it.

video_status(job_id)

Reports progress, then the path of the finished MP4.

A render takes a couple of minutes and an MCP client can time out on one long tool call, so the work starts in the background and is checked separately.

Output: H.264 video at 1280 by 720 and 30 frames per second, with AAC sound. Each scene lasts as long as its narration plus one second.

Changing it

Ask Claude for changes to server.py in plain words: other colours or fonts in scene_page, a diagram scene, a different voice, or a vertical 1080 by 1920 frame for Shorts (change W and H, and the positions inside scene_page).

A note on the MCP SDK

Version 2 of the Python MCP SDK renamed FastMCP to MCPServer (from mcp.server.mcpserver import MCPServer). Tutorials that import from mcp.server.fastmcp import FastMCP fail on version 2. This repo pins mcp==2.3.0.

Voices and licences

  • The code in this repository is MIT licensed (see LICENSE).

  • Piper, the speech engine installed by requirements.txt, is GPL-3.0-or-later.

  • Each Piper voice has its own licence on its model card. The default here, en_US-ljspeech-medium, is trained on the LJSpeech dataset, which its card lists as public domain. Some popular voices, such as Lessac, use research-only datasets, so check the card before publishing videos made with another voice.

Other routes to animated video

Route

Good for

How Claude drives it

Manim

Maths animation and diagrams

Community MCP servers that run Manim scripts

Remotion

Videos written as React code

An agent skill; free for individuals and teams of up to three, paid for larger companies

Motion Canvas

TypeScript animation with a live editor

Claude writes the scene code (MIT; maintenance status unclear)

Blender MCP

3D scenes

An MCP server driving a live Blender session

By Randall Vollen.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that lets Claude Code create explainer videos from plain English requests by writing and rendering manim animations locally, then publishing the result as a shareable artifact.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Turns a plain-language request into a narrated vertical motion graphics video with natural voice, word-by-word synced animation, music and sound effects, rendered locally as an MP4 ready for Reels, TikTok and Shorts. Validates scripts and estimates OpenAI API cost before spending credits, and works inside MCP-capable assistants like Claude Code, Claude Desktop or Cursor.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude Code, Codex, Claude Desktop and Cursor to see and hear MP4/MOV/MKV/WebM videos and screen recordings through timestamped keyframe storyboards, zoom and full-resolution frame drill-down, and a locally generated Whisper transcript. It also works with recording bundles that capture clicks and typed context, and runs entirely on the user's machine with no uploads or API keys.
      5
      1
      MIT