Clean-Cut-MCP: AI Video Generation for Claude Desktop

Transform natural language into professional videos using Claude Desktop + Remotion.

Simply describe your animation, and watch Claude create stunning React-powered videos in a persistent studio environment.

🚀 INSTALLATION (5 minutes)

Step 1: Pull Container

Step 2: Run Container

Step 3: Configure Claude Desktop

Option A: Quick Installer (Recommended for Windows)

Option B: Manual Installation

Step 4: Restart Claude Desktop

Close Claude Desktop completely and restart it.

✅ Result: Remotion Studio at http://localhost:6970 + Claude Desktop integration ready

🆕 What's New in v2.1.0

• 🛡️ Animation Validation System: Prevents syntax errors in generated code

• 🔧 MCP Singleton Management: No more duplicate processes or conflicts

• 📝 Config Preservation: Safely preserves existing MCP servers during installation

• 🎯 Auto-Fix System: Automatically corrects common TypeScript issues

• ⚡ PowerShell Execution Bypass: No more security policy issues

🎬 Quick Demo Test

After installation, try these commands in Claude Desktop:

🎯 Use Cases

Content Creators

• YouTube Intros: Professional animated intros with your branding

• Social Media: Quick animations for Instagram, TikTok stories

• Explainer Videos: Animated sequences for complex topics

• Brand Animations: Logo reveals, product showcases

Marketers & Businesses

• Ad Creatives: Animated ads for multiple platforms

• Presentation Graphics: Data visualizations, animated charts

• Website Assets: Loading animations, interactive elements

• A/B Testing: Generate multiple animation variants quickly

Educators & Trainers

• Course Content: Visual explanations of complex concepts

• Interactive Lessons: Animated diagrams and processes

• Student Projects: Help students create professional presentations

• Training Materials: Animated guides and tutorials

🏗️ Architecture

System Requirements

• Docker Desktop installed and running

• Claude Desktop installed

• 4GB RAM recommended for video rendering

• 2GB disk space for container and videos

🛠️ Available MCP Tools

Clean-Cut-MCP provides 18 professional animation tools:

Core Animation Tools:

• create_animation - Generate animations from natural language

• list_existing_components - View available animation templates

• rebuild_compositions - Refresh animation registry

• delete_component - Remove animations safely

Professional Features:

• generate_with_learning - AI-powered animation with learned preferences

• record_user_correction - System learns from your feedback

• upload_asset - Add images, logos, audio to animations

• format_code - Professional code formatting

🔧 Troubleshooting

Installation Issues

PowerShell Security Issues

If you get execution policy errors, use the bypass commands shown in Step 3.

Port Conflicts

If port 6970 is in use:

📚 Documentation

• User Guide - Complete tool reference

• Troubleshooting - Common issues and solutions

• Examples - Sample animations and use cases

🤝 Community & Support

• GitHub Issues: Bug reports and feature requests

• Discussions: Share animations, ask questions

• Docker Hub: Pre-built container images

📄 License

This project uses Remotion, which has special licensing requirements:

• Free for: Individuals, organizations ≤3 employees, non-profits, evaluation

• Company license required: For-profit organizations >3 employees

• Details: Check remotion.pro for complete licensing terms

Clean-Cut-MCP container/MCP server code: MIT License Remotion dependency: Subject to Remotion's license terms

🎬 Ready to start creating? Follow the 4 installation steps above!

Questions or issues? → Check the Troubleshooting guide