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

docker pull endlessblink/clean-cut-mcp:latest

Step 2: Run Container

docker run -d --name clean-cut-mcp -p 6970:6970 -v ./clean-cut-exports:/workspace/out -v ./clean-cut-workspace:/workspace --restart unless-stopped endlessblink/clean-cut-mcp:latest

Step 3: Configure Claude Desktop

Option A: Quick Installer (Recommended for Windows)

powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/endlessblink/clean-cut-mcp/master/install-quick.ps1' -OutFile 'install-quick.ps1'; powershell -ExecutionPolicy Bypass -File 'install-quick.ps1'"

Option B: Manual Installation

# Windows PowerShell:
powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/endlessblink/clean-cut-mcp/master/install.ps1' -OutFile 'install.ps1'; powershell -ExecutionPolicy Bypass -File 'install.ps1'"

# Linux/macOS:
curl -fsSL https://raw.githubusercontent.com/endlessblink/clean-cut-mcp/master/install.ps1 | pwsh -ExecutionPolicy Bypass -

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:

User: "Create a simple welcome animation with the text 'Hello AI Video Generation'"
User: "List all existing animation components"
User: "Get the Remotion Studio URL"

🎯 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

Claude Desktop (Windows/Mac/Linux)
    ↓ MCP Protocol (STDIO transport)
Docker Container (clean-cut-mcp)
    ↓ Internal Services
Remotion Studio (Port 6970) + MCP Server + Node.js Runtime
    ↓ Volume Mount
./clean-cut-exports/ (Your Videos)

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

# Check container is running
docker ps | grep clean-cut-mcp

# Check Remotion Studio is accessible
curl http://localhost:6970

# Check Claude Desktop configuration
cat ~/.config/Claude/claude_desktop_config.json | grep clean-cut-mcp

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:

# Use alternative port
docker run -d --name clean-cut-mcp -p 6971:6970 -v ./clean-cut-exports:/workspace/out -v ./clean-cut-workspace:/workspace --restart unless-stopped endlessblink/clean-cut-mcp:latest

📚 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

Clean-Cut-MCP