home / mcp / chuk motion mcp server

Chuk Motion MCP Server

An MCP server that exposes Remotion-based video generation with a design-system-driven token library and multi-platform layout support.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ibm-chuk-motion": {
      "command": "python",
      "args": [
        "-m",
        "chuk_motion.server",
        "stdio"
      ],
      "env": {
        "MCP_STDIO": "1"
      }
    }
  }
}

You run an MCP server that exposes the chuk-motion video-generation system to AI assistants, enabling design-token-driven, multi-platform video production with a track-based timeline and a library of prebuilt components. This server empowers you to generate professional videos by accepting component instructions from clients and rendering Remotion-based outputs with consistent design systems across platforms like YouTube, TikTok, and Instagram.

How to use

You use the MCP server by running it in local STDIO mode during development. This mode allows an AI client to communicate with the server through standard input and output, enabling you to request project creation, component additions, and rendering workflows without exposing a network interface.

How to install

Prerequisites: You must have Python 3.11 or newer installed on your system.

Install the MCP server package in editable mode so you can run the server and iterate quickly.

# Install dependencies with uv (recommended)
uv pip install -e .

# Or with pip
pip install -e .

Run the server in STDIO mode

Start the MCP server in STDIO mode to connect with Claude Desktop or other local clients.

python -m chuk_motion.server stdio

Run the server in HTTP mode (for testing)

If you want to test over HTTP, you can run the server in HTTP mode on a port for local access.

python -m chuk_motion.server http --port 8000

Available tools

remotion_create_project

Create a new Remotion-based video project with specified name, theme, frame rate, and dimensions.

remotion_get_project_info

Retrieve information about the current Remotion project.

remotion_list_projects

List all existing Remotion projects.

remotion_add_pie_chart

Add a PieChart component to the project with data and duration.

remotion_add_bar_chart

Add a BarChart component for vertical comparisons.

remotion_add_horizontal_bar_chart

Add a HorizontalBarChart with top highlights.

remotion_add_line_chart

Add a LineChart showing trends over time.

remotion_add_area_chart

Add an AreaChart with filled area visuals.

remotion_add_donut_chart

Add a DonutChart with a center statistic.

remotion_add_title_scene

Add a TitleScene with text, subtitle, and animation.

remotion_add_end_screen

Add an EndScreen with a CTA for YouTube endings.

remotion_add_lower_third

Add a LowerThird with a name plate and position variants.

remotion_add_text_overlay

Add a TextOverlay for animated emphasis.

remotion_add_subscribe_button

Add a SubscribeButton with animation and placement.

remotion_add_code_block

Add a CodeBlock with syntax highlighting and options.

remotion_add_typing_code

Add a TypingCode block with typing animation.

remotion_add_grid

Create a Grid-based layout with a chosen layout.

remotion_add_container

Add a Container with optional borders and backgrounds.

remotion_add_split_screen

Create a SplitScreen layout with left/right content.

remotion_add_counter

Add a Counter animation from start to end.

remotion_add_typewriter_text

Add TypewriterText with cursor and styling options.

remotion_add_stagger_text

Add StaggerText with staggered reveal.

remotion_add_wavy_text

Add WavyText with sine wave animation.

remotion_add_true_focus

Add TrueFocus with word-focused animation.

remotion_add_decrypted_text

Add DecryptedText with scrambling reveals.

remotion_add_fuzzy_text

Add FuzzyText with glitch-style effects.

remotion_list_components

List available component categories.

remotion_search_components

Search for components matching a query.

remotion_get_component_schema

Get detailed schema for a specific component.

remotion_list_themes

List available themes for videos.

remotion_get_theme_info

Get details about a specific theme.

remotion_list_color_tokens

List color design tokens.

remotion_list_typography_tokens

List typography design tokens.

remotion_list_motion_tokens

List motion design tokens.

remotion_list_spacing_tokens

List spacing tokens and platform safe margins.

remotion_get_info

Retrieve server information and statistics.