Remotion Video Generator

Instructions

Implementation Reference

• src/chuk_motion/server.py:187-225 (handler)

  MCP tool handler decorated with @mcp.tool that registers and executes the remotion_create_project tool. Delegates core logic to ProjectManager.create_project.
  @mcp.tool # type: ignore[arg-type] async def remotion_create_project( name: str, theme: str = "tech", fps: int = 30, width: int = 1920, height: int = 1080 ) -> str: """ Create a new Remotion video project. Creates a complete Remotion project with package.json, TypeScript config, and project structure ready for video generation. Args: name: Project name (will be used as directory name) theme: Theme to use (tech, finance, education, lifestyle, gaming, minimal, business) fps: Frames per second (default: 30) width: Video width in pixels (default: 1920 for 1080p) height: Video height in pixels (default: 1080 for 1080p) Returns: JSON with project information Example: project = await remotion_create_project( name="my_video", theme="tech", fps=30, width=1920, height=1080 ) """ def _create(): try: result = project_manager.create_project(name, theme, fps, width, height) return json.dumps(result, indent=2) except Exception as e: return json.dumps({"error": str(e)}) return await asyncio.get_event_loop().run_in_executor(None, _create)
• src/chuk_motion/utils/project_manager.py:42-111 (helper)

  Core implementation of project creation in ProjectManager class. Handles directory creation, template copying from remotion-templates, and timeline initialization.
  def create_project( self, name: str, theme: str = "tech", fps: int = 30, width: int = 1920, height: int = 1080 ) -> dict[str, str]: """ Create a new Remotion project. Args: name: Project name theme: Theme to use fps: Frames per second width: Video width height: Video height Returns: Dictionary with project info """ project_dir = self.workspace_dir / name if project_dir.exists(): raise ValueError(f"Project '{name}' already exists") # Create project structure project_dir.mkdir(parents=True) (project_dir / "src").mkdir() (project_dir / "src" / "components").mkdir() # Copy template files template_dir = Path(__file__).parent.parent.parent.parent / "remotion-templates" # Copy package.json self._copy_template( template_dir / "package.json", project_dir / "package.json", {"project_name": name} ) # Copy config files shutil.copy(template_dir / "remotion.config.ts", project_dir / "remotion.config.ts") shutil.copy(template_dir / "tsconfig.json", project_dir / "tsconfig.json") shutil.copy(template_dir / ".gitignore", project_dir / ".gitignore") # Copy source files # Remotion composition IDs can only contain a-z, A-Z, 0-9, and hyphens composition_id = name.replace("_", "-") self._copy_template( template_dir / "src" / "Root.tsx", project_dir / "src" / "Root.tsx", { "composition_id": composition_id, "duration_in_frames": 300, # 10 seconds at 30fps "fps": fps, "width": width, "height": height, "theme": theme, }, ) shutil.copy(template_dir / "src" / "index.ts", project_dir / "src" / "index.ts") # Create timeline (track-based system) self.current_project = name self.current_timeline = Timeline(fps=fps, width=width, height=height, theme=theme) return { "name": name, "path": str(project_dir), "theme": theme, "fps": str(fps), "resolution": f"{width}x{height}", }