Zero-setup Remotion video generation for Claude Desktop. Auto-installs projects, dependencies, and guidelines on first use.
npm install @endlessblink/rough-cuts-mcpProfessional AI-powered video creation for Claude Desktop with automatic setup and built-in animation guidelines.
bash
npx -y @endlessblink/rough-cuts-mcp@latest
`$3
bash
npm install -g @endlessblink/rough-cuts-mcp
`$3
If automatic setup fails, add this to your :
`json
{
"mcpServers": {
"rough-cuts-mcp": {
"command": "npx",
"args": ["-y", "@endlessblink/rough-cuts-mcp@latest"]
}
}
}
`🚀 What This Package Does
$3
- ✅ Auto-detects Node.js, npm, and system configuration
- ✅ Auto-configures Claude Desktop (no manual JSON editing)
- ✅ Auto-creates Remotion projects when needed
- ✅ Auto-installs all dependencies and requirements
- ✅ Auto-launches Remotion Studio for preview and rendering$3
- 🎯 Built-in Guidelines - Professional animation rules loaded automatically
- 🔧 Safe Patterns - Bulletproof interpolation and timing functions
- ⚡ Quick Templates - Professional templates with overlapping scenes
- 🎨 Syntax Repair - Automatically fixes animation code issues
- 📚 Best Practices - Follows industry standards for motion graphics$3
- 🖥️ Windows - Full support with enhanced path detection
- 🍎 macOS - Native support with proper app bundle detection
- 🐧 Linux - Complete compatibility with standard distributions🎯 Usage with Claude
After installation, simply ask Claude:
$3
"Create a dynamic product showcase video"
"Make an animated logo intro with smooth transitions"
"Generate a professional demo video for my SaaS app"
"Build a GitHub repository showcase animation"
"Create a video explaining our company's services"
$3
- 🏗️ Project Setup - Creates workspace at automatically
- 📱 Studio Launch - Opens preview at http://localhost:3000
- 🎬 Professional Results - Follows animation best practices automatically
- 🔧 Error Recovery - Fixes syntax and timing issues automatically🛠️ Available MCP Tools
$3
- - Verify system requirements
- setup_remotion_environment - Create new Remotion projects
- create_remotion_component - Generate animation components
- launch_remotion_studio - Start preview server
- list_components - Show available animations$3
- get_animation_guidelines - NEW! Built-in professional animation rules
- repair_component - Auto-fix syntax and timing issues
- read_guidelines_file - Access extended documentation📋 Animation Guidelines (Built-In)
The MCP includes professional animation guidelines that ensure:
$3
- Overlapping Scenes - No empty screen time (15-frame overlaps)
- Movement + Fades - Never fade-only transitions
- Quick Timing - 20-frame entries, 15-frame exits
- Proper Sizing - 16px+ text, 44px+ touch targets
- Safe Interpolation - Bounds checking for all animations
- Cubic Easing - Professional easing curves$3
- Empty screen time during transitions
- Fade-only transitions without movement
- Slow timing (>20 frame transitions)
- Small text (<16px) and touch targets (<44px)
- Hard cuts without smooth transitions🔧 Requirements
- Node.js 18.0.0 or higher
- npm 8.0.0 or higher
- Claude Desktop (any recent version)
- Platform: Windows, macOS, or Linux
🚨 Troubleshooting
$3
`bash
Check Node.js version
node --version # Should be 18.0.0+Restart Claude Desktop after installation
Close completely and reopen
Test MCP connection
Ask Claude: "Check my video creation environment"
`$3
bash
Windows: Run as Administrator if needed
macOS/Linux: Ensure npm global permissions are correct
npm config get prefix # Check npm global directory
`$3
If automatic setup fails, the installer creates with manual instructions.📊 System Compatibility
$3
- ✅ Windows 10/11 (x64, ARM64)
- ✅ macOS 12+ (Intel, Apple Silicon)
- ✅ Ubuntu 20.04+ (x64, ARM64)
- ✅ Debian 11+ (x64, ARM64)
- ✅ CentOS/RHEL 8+ (x64)$3
- ✅ Node.js 18.x (LTS)
- ✅ Node.js 20.x (LTS)
- ✅ Node.js 22.x (Current)🎯 Professional Results
Following the built-in guidelines ensures:
- 🏆 No text overlap during transitions
- ⚡ No empty screen time - always engaging
- 📱 Proper sizing - clearly readable on all devices
- 🎭 Smooth motion - professional cinematic feel
- ⚡ Fast performance - transform-only animations
- 🎨 Consistent quality - industry-standard patterns
🆘 Support & Documentation
$3
- 📖 Built-in Guidelines - Use get_animation_guidelines() in Claude
- 🐛 Issues - Report at GitHub Issues
- 💬 Discussions - Join GitHub Discussions$3
- 📁 Custom Projects - Specify project paths: setup_remotion_environment("/custom/path")
- 🎛️ Studio Options - Custom ports:
- 🔧 Repair Tools - Fix components: 📄 License
MIT License - See LICENSE for details.
🙏 Credits
Built with:
- Remotion - React-based video framework
- Model Context Protocol - AI integration standard
- Claude Desktop - AI assistant platform
---
🎬 Start creating professional videos with AI assistance in under 60 seconds!
bash
npx -y @endlessblink/rough-cuts-mcp@latest
Then ask Claude: "Create my first professional video"
``