# Remotion MCP Server A minimal MCP server for Remotion video creation. Claude Desktop generates JSX intelligently - this server just handles file operations and process management. ## Quick Start ### NPM Package Installation (Recommended) 1. **Install globally:** ```bash npm install -g rough-cut-mcp ``` 2. **Automated setup:** ```bash rough-cut-setup ``` This will: - Detect your platform automatically - Find Node.js installation - Test the MCP server - Write Claude Desktop configuration automatically - Provide restart instructions ### Local Development Setup 1. **Install dependencies:** ```bash npm install ``` 2. **Build and setup:** ```bash npm run setup ``` ### Platform-Specific Setup #### Windows For PowerShell experience: ```powershell npm run setup:windows ``` #### macOS/Linux ```bash npm run setup ``` #### Manual Build Only ```bash npm run build # Cross-platform build script npm run build:windows # Windows PowerShell build (if preferred) ``` ### Claude Desktop Configuration The setup script will generate the correct configuration for your system. Example configurations: **Windows (automatically generated):** ```json { "mcpServers": { "rough-cut-mcp": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\Users\\username\\AppData\\Roaming\\npm\\node_modules\\rough-cut-mcp\\build\\index.js"] } } } ``` **macOS (automatically generated):** ```json { "mcpServers": { "rough-cut-mcp": { "command": "/usr/local/bin/node", "args": ["/usr/local/lib/node_modules/rough-cut-mcp/build/index.js"] } } } ``` **Linux (automatically generated):** ```json { "mcpServers": { "rough-cut-mcp": { "command": "/usr/bin/node", "args": ["/usr/lib/node_modules/rough-cut-mcp/build/index.js"] } } } ``` ### Config File Locations - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **Linux:** `~/.config/claude/claude_desktop_config.json` ## Architecture - **Claude Desktop**: Generates all JSX intelligently - **MCP Server**: Handles file operations and process management only - **No templates**: Claude's JSX is accepted exactly as provided - **Ultra-simple**: ~400 lines total code ## Available Tools ### 1. `create-project(name, jsx)` Creates a new Remotion project with Claude's JSX. - Takes JSX exactly as Claude provides it - Creates `src/VideoComposition.tsx` with the JSX - Generates minimal `Root.tsx` that imports VideoComposition - Runs `npm install` automatically ### 2. `edit-project(name, jsx, duration?)` Replaces `VideoComposition.tsx` with new JSX and optionally updates video duration. - Simple file replacement, no AST parsing - Optional duration parameter (in seconds) updates Remotion config - Returns "refresh browser to see changes" ### 3. `launch-studio(name, port?)` Starts Remotion Studio for a project. - Auto-detects available port in 6600-6620 range - Returns working URL ### 4. `stop-studio(port)` Kills studio process on specified port. ### 5. `list-projects()` Returns all project names and basic info. ### 6. `delete-project(name)` Removes project directory completely. - Stops any running studios first ### 7. `get-project-info(name)` Returns detailed project information and status. ### 8. `get-studio-status()` Returns all **running** studios with ports and project names. (Note: This shows active studio processes, not existing projects. Use `list-projects` to see all created projects.) ### 9. `configure-audio(apiKey?, enabled?)` Configure optional AI audio generation features. - Set ElevenLabs API key for sound effects generation - Enable/disable audio features - Safely stores API key in environment variables ### 10. `generate-audio(projectName, prompt, type, duration?)` Generate AI sound effects or music for your video project. - **Requires ElevenLabs API key** (configure with `configure-audio`) - Types: 'sfx' (sound effects) or 'music' - Downloads audio to project's `public/audio/` directory - Returns Remotion code snippet for easy integration - Example: "bouncing ball sound effect", "upbeat background music" ### 11. `debug-audio-config()` Debug tool to check audio environment variables and configuration status. ## Project Structure Created projects have this structure: ``` project-name/ ├── src/ │ ├── VideoComposition.tsx # Claude's JSX (exact copy) │ └── Root.tsx # Minimal wrapper ├── public/ │ └── audio/ # AI-generated audio files ├── package.json # Remotion dependencies ├── remotion.config.ts # Basic config with duration └── .env # Audio API configuration (if used) ``` ## Key Features - **No JSX validation** - Accepts Claude's code exactly - **Relative paths only** - Avoids Windows/WSL path issues - **Auto port detection** - Finds available ports 6600-6620 - **Process tracking** - Manages running studios - **Windows-only build** - Prevents WSL path corruption ## Build Protection The build system includes WSL2 protection: - Blocks builds in WSL2 environment - Validates output for WSL paths - Ensures Windows compatibility ## Usage Examples ### Basic Video Creation 1. Ask Claude: "Create a Remotion video with a bouncing ball" 2. Claude generates JSX and calls `create-project("bouncing-ball", jsx)` 3. Server creates project and runs `npm install` 4. Call `launch-studio("bouncing-ball")` to start editing 5. Server returns `http://localhost:6600` for immediate use ### AI Audio Integration 1. Configure audio (one-time setup): ``` Claude: "Configure audio with my ElevenLabs API key: xi-abc123..." ``` 2. Generate sound effects: ``` Claude: "Generate a bouncing ball sound effect for my project" Server calls: generate-audio("bouncing-ball", "bouncing ball sound effect", "sfx", 3) ``` 3. Audio is automatically saved to `public/audio/` and Claude provides integration code: ```jsx import { staticFile, Audio } from 'remotion';