Skip to content

sid-thephysicskid/leap-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LEAP MCP

AI Educational Video Generator

Transform any topic into a short explainer video with AI narration and 3Blue1Brown-style animations.

Python License MCP

LEAP MCP Demo

Quick Start

Prerequisites:

Note: Currently supports Claude Code only. Support for Cursor, Windsurf, and other MCP clients planned for future releases.

git clone https://github.com/sid-thephysicskid/leap-mcp
cd leap-mcp
python setup.py

The setup will ask for your OpenAI API key. If you skip it, manually add it to .env:

cp .env.example .env
# Edit .env and add: OPENAI_API_KEY=your_actual_key_here

Next steps:

  1. Start Claude Code: claude
  2. In Claude Code chat, type /mcp - you should see leap-mcp connected
  3. If not connected, restart Claude Code and try /mcp again
  4. Start creating videos:
Create an educational video about black holes

Features

Videos - 2-minute structure: Hook → Phenomenon → Mechanism → Synthesis
AI Narration - 6 natural voices powered by OpenAI
Animations - Manim engine (same as 3Blue1Brown)
Any Topic - From quantum physics to cooking recipes

Examples

Create a video about the French Revolution for high schoolers
Make a video about Vincent van Gogh's painting techniques
Create a video explaining cryptocurrency to my grandmother
Make a video explaining MCP servers

Voices: nova (default) • alloyechofableshimmeronyx

Troubleshooting

Python 3.13? Manim's packages don't support Python 3.13+ supported yet - use 3.8-3.11
Connection issues? Restart Claude Code, run /mcp
API errors? Check OpenAI key in .env file

Contributing

Good First Issues:

  • Add Cursor/Windsurf/Qwen Agent support
  • Create subject or domain specific templates (history, art, business, financial reports etc.)
  • Improve error messages and debugging
  • Add video quality/resolution options

License

MIT - Built with ManimFastMCPOpenAI

About

Transform any topic into an explainer video with AI narration and 3Blue1Brown-style animations

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages