RV MCP Server
The RV MCP Server bridges AI assistants (like Claude) to Autodesk/Tweak RV, enabling full control of the professional media review application through natural language.
Media Loading & Session Management
Load single files, image sequences, or multiple media files
Create, clear, and save sessions (
.rvfiles)List loaded sources, get detailed media info (resolution, frame range, FPS, bit depth, channels)
Query sources visible at specific frames and get session info
Playback Control
Start/stop/toggle playback; jump to specific frames; step forward/backward
Set in/out points, FPS, playback speed and direction (forward, reverse, 2x, etc.)
Set loop mode (
loop,once,pingpong) and enable/disable realtime modeQuery full playback state (frame, range, in/out, FPS)
View & Comparison Modes
Switch between
sequence,stack, andlayout(tiled) viewsSet compositing mode (
over,add,difference,replace,topmost, etc.)Toggle A/B wipe comparison
Color Correction & Display
Apply/clear LUT files (
.3dl,.csp,.cube) tolook,linearize, ordisplaytargetsSet/clear CDL values (slope, offset, power, saturation)
Adjust exposure, gamma, and saturation
Configure display gamma, sRGB transform, and viewport background (black, checker, grey18, etc.)
Query all current color correction settings
Advanced Control
Execute arbitrary Mu scripting code directly in RV for anything not covered by dedicated tools
Provides tools to control Autodesk RV and OpenRV, enabling playback control, media loading, shot comparison, and color grading adjustments for media review sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RV MCP Server Load shot_v02 and compare it with v01 using a wipe"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RV MCP Server
MCP (Model Context Protocol) server that bridges AI assistants like Claude to Autodesk/Tweak RV, the industry-standard media review application. Control playback, compare shots, adjust color grading, and manage review sessions — all through natural language.
No plugin required inside RV. Uses RV's built-in network listener with Mu scripting via remote-eval.
Requirements
OpenRV (or RV 2022.3.1+) with network mode enabled
Python 3.10+
uv package manager
Related MCP server: davinci-resolve-mcp-free
Quick Start
1. Start RV with networking
Enable networking in RV via RV → Networking → Enable Network (default port 45124).
Or from the command line:
rv -network -networkPort 451242. Install and register
Claude Code (CLI):
claude mcp add --scope user rv-mcp -- uv run --no-sync --directory /path/to/RV_MCP rv-mcpNote:
--no-syncprevents file lock conflicts when multiple Claude sessions share the same MCP server. Runuv syncmanually after changing dependencies.
Claude Desktop (~/.claude.json):
{
"mcpServers": {
"rv-mcp": {
"command": "uv",
"args": ["run", "--no-sync", "--directory", "/path/to/RV_MCP", "rv-mcp"]
}
}
}Environment variables (optional):
Variable | Default | Description |
|
| RV network host |
|
| RV network port |
3. Use it
Ask Claude to load media, control playback, compare shots, or adjust colors. The server translates natural language into RV commands automatically.
Architecture
Claude (stdio/MCP) --> FastMCP Server --> RV Network Protocol (TCP:45124) --> RVThe server maintains a persistent TCP connection to RV using a custom protocol based on RV's RvCommunicator. Key design decisions:
Persistent connection with automatic reconnection on socket loss
Thread-safe via
threading.Lockfor concurrent tool callsClean shutdown via
atexithandler that sendsDISCONNECT(without this, RV rejects future connections)Mu string handling — return values are automatically unquoted and unescaped
Protocol Flow
1. Connect TCP to 127.0.0.1:45124
2. Send: NEWGREETING <len> rv-mcp rvController
3. Send: PINGPONGCONTROL 1 0 (disable heartbeat)
4. Recv: NEWGREETING <len> <rv-name> (consume RV's greeting)
5. For each command:
Send: MESSAGE <len> RETURNEVENT remote-eval * { require commands; <mu_code> }
Recv: MESSAGE <len> RETURN <value>
6. On shutdown:
Send: MESSAGE <len> DISCONNECTOCIO Color Management
The server includes full OCIO v2 support. When $OCIO is set, RV can match the exact display transform used by your DCC apps (3ds Max/Redshift, Nuke, etc.).
Auto-configuration
An rv_ocio_setup.py script is included that auto-configures OCIO when RV loads media:
EXR/HDR/TX files are auto-detected as scene-linear (ACEScg via the
scene_linearrole)Display transform is set from the config's defaults (e.g.,
sRGB/ACES 1.0 SDR-video)Chromaticity metadata in EXRs is matched against the active config's color spaces
To install, copy rv_ocio_setup.py to your RV support path:
# Windows
copy rv_ocio_setup.py %APPDATA%\RV\Python\
# Linux/macOS
cp rv_ocio_setup.py ~/.rv/Python/RV's built-in ocio_source_setup package will detect and use this override automatically.
Manual OCIO via MCP
Tool | Description |
| List color spaces, displays, views, and looks from the active OCIO config |
| Set input color space for a source (inserts OCIOFile node) |
| Set display transform (inserts OCIODisplay node) |
| Apply an OCIO look to a source |
| Get current OCIO node state as JSON |
| Remove OCIO nodes and restore default pipeline |
Redshift + RV Color Matching
If you use Redshift's OCIO config ($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio), note that its file rules mark EXRs as "Raw". The rv_ocio_setup.py script overrides this by detecting float formats as scene-linear, ensuring the ACES tonemapper is applied in RV just like in Redshift's Render View.
Tools (47 total)
Execute (1)
Tool | Description |
| Run arbitrary Mu code — escape hatch for anything not covered by dedicated tools |
OCIO (6)
Tool | Description |
| Get OCIO config info (color spaces, displays, views, looks) |
| Set OCIO input color space for a source |
| Set OCIO display transform |
| Apply an OCIO look |
| Get current OCIO state as JSON |
| Remove OCIO nodes, restore defaults |
Execute (1)
Tool | Description |
| Run arbitrary Mu code — escape hatch for anything not covered by dedicated tools |
Playback (17)
Tool | Description |
| Load a media file (image sequence, movie, or single image) |
| Load multiple media files at once |
| Start playback |
| Stop playback |
| Toggle play/stop, returns new state |
| Get current frame number |
| Jump to a specific frame |
| Step forward by N frames (default 1) |
| Step backward by N frames (default 1) |
| Set the in-point (start of playback range) |
| Set the out-point (end of playback range) |
| Get current in/out points as JSON |
| Set playback frames per second |
| Get current playback FPS |
| Enable/disable realtime mode (skip frames to maintain FPS) |
| Set loop mode: |
| Set playback direction and speed (1=forward, -1=reverse, 2=2x, etc.) |
| Get full playback state as JSON (frame, range, in/out, playing, fps) |
Sources (7)
Tool | Description |
| List all loaded source nodes as JSON array |
| Get detailed media info (resolution, frame range, fps, bit depth, channels) |
| Get source nodes visible at a specific frame |
| Create a new empty session |
| Clear all sources from the current session |
| Save session to an |
| Get session state as JSON (view node, frame range, source count) |
Compare (4)
Tool | Description |
| Switch view: |
| Set stack composite mode: |
| Toggle A/B wipe comparison (auto-switches to stack view) |
| Get current view state as JSON |
Color (12)
Tool | Description |
| Load a LUT file ( |
| Deactivate LUT on a target |
| Set CDL values (slope, offset, power, saturation) — partial updates supported |
| Deactivate CDL color correction |
| Set exposure (per-channel or uniform) |
| Set gamma correction |
| Set saturation |
| Get current color correction state as JSON |
| Set display gamma (e.g., 2.2 for sRGB-like) |
| Enable/disable sRGB display transform |
| Set viewport background: |
Usage Examples
Load and review footage
"Load the EXR sequence at /shots/sh010/comp/sh010_comp.1-100#.exr"
"Play it back at 24fps"
"Go to frame 50"
"Set in point at 20 and out point at 80"Compare two versions
"Load both /shots/sh010/comp_v1.mov and /shots/sh010/comp_v2.mov"
"Switch to stack view"
"Set composite to difference mode"
"Toggle the wipe to compare side by side"Color correction
"Apply CDL with slope [1.1, 0.95, 1.0] and saturation 1.2"
"Load the ACES LUT from /luts/sRGB.cube"
"Set exposure to 0.5"
"Show me the current color settings"Advanced (raw Mu)
"Execute this Mu code: { require commands; let s = sources(); string(s.size()); }"Project Structure
RV_MCP/
├── pyproject.toml # Package config, entry point, dependencies
├── README.md
├── .gitignore
└── src/
├── __init__.py
├── server.py # FastMCP server + RvClient instantiation
├── rv_client.py # Persistent TCP client (RV network protocol)
└── tools/
├── __init__.py
├── execute.py # execute_mu — raw Mu escape hatch
├── playback.py # 17 playback/transport tools
├── sources.py # 7 source & session tools
├── compare.py # 4 view/compare tools
├── color.py # 12 color/LUT/CDL tools
└── ocio.py # OCIO v2 color management toolsTroubleshooting
"Could not connect to RV"
Ensure RV is running with the
-networkflagCheck that port 45124 is not blocked by a firewall
Use
-networkPort 45124to explicitly set the port
RV rejects connections after a crash
If the server exits without sending DISCONNECT, RV may reject new connections. Restart RV to clear the state. The server includes an atexit handler to prevent this under normal operation.
Mu code errors
Always wrap code blocks in
{ require commands; ... }Mu evaluates both branches of
if/then/else— avoid property access on nodes that may not existFile paths must use forward slashes;
escape_mu_string()handles this automatically
Timeout errors
The default timeout is 30 seconds. If Mu code takes longer (e.g., loading large sequences), it may time out. Use execute_mu for long operations and consider breaking them into smaller steps.
Development
# Install dependencies
uv sync
# Run the server directly
uv run rv-mcp
# Run with debug logging
uv run python -m src.serverLicense
MIT
Available Tools
47 toolsclear_cdlA
Deactivate CDL color correction.
Inputs: no named parameters. Returns: result
clear_lutA
Deactivate the LUT on a target.
Args: target: Which LUT to clear: "look", "linearize", or "display".
Inputs: target. Returns: result
clear_ocioA
Remove OCIO nodes and restore default RV pipeline.
Args: target: What to clear — "linearize", "display", "look", or "all".
Inputs: target. Returns: result
clear_sessionA
Clear all sources from the current session.
Inputs: no named parameters. Returns: result
execute_muA
Execute arbitrary Mu code in RV and return the result.
The code is evaluated via remote-eval. Use 'require commands;' at the start if you need commands functions like play(), stop(), etc.
Examples: execute_mu("{ require commands; string(frame()); }") execute_mu("{ require commands; play(); "playing"; }") execute_mu("{ require commands; sources(); }")
Inputs: code (required). Returns: result
get_color_settingsA
Get current color correction settings as JSON.
Requires at least one source loaded in the session.
Inputs: no named parameters. Returns: result
get_fpsA
Get the current playback FPS.
Inputs: no named parameters. Returns: result
get_frameA
Get the current frame number in RV.
Inputs: no named parameters. Returns: result
get_frame_rangeA
Get the full frame range and current state as JSON.
Returns JSON with: frame, frameStart, frameEnd, inPoint, outPoint, playing, fps.
Inputs: no named parameters. Returns: result
get_in_out_pointsA
Get the current in/out points as JSON.
Inputs: no named parameters. Returns: result
get_ocio_configA
Get OCIO config information as JSON.
Returns color spaces, displays, views, and looks from the active OCIO config (or a specific config file).
Args: config_path: Optional path to an OCIO config file. If omitted, uses the $OCIO environment variable.
Inputs: config_path. Returns: result
get_ocio_stateA
Get current OCIO state for all sources and display as JSON.
Returns which sources have OCIO nodes and their settings.
Inputs: no named parameters. Returns: result
get_session_infoB
Get current session information as JSON.
Returns: viewNode, frame, frameStart, frameEnd, sourceCount.
Inputs: no named parameters. Returns: result
get_source_media_infoB
Get detailed media info for a source node.
Args: source_node: The source node name (e.g. "sourceGroup000000").
Inputs: source_node (required). Returns: result
get_sourcesB
List all sources currently loaded in RV as JSON.
Returns a JSON array with source node names.
Inputs: no named parameters. Returns: result
get_sources_at_frameA
Get source nodes visible at a specific frame.
Args: frame: Frame number to query (-1 for current frame).
Inputs: frame. Returns: result
get_view_infoA
Get current view state as JSON.
Returns: viewNode, viewType, and wipe state.
Inputs: no named parameters. Returns: result
load_sourceA
Load a media file (image sequence, movie, or single image) into RV.
Args: file_path: Path to the media file. For sequences use RV notation e.g. "/path/to/image.1-100#.exr" or just the path to one frame.
Inputs: file_path (required). Returns: result
load_sourcesA
Load multiple media files into RV at once.
Args: file_paths: List of paths to media files.
Inputs: file_paths (required). Returns: result
new_sessionA
Create a new empty session, clearing all current sources.
Inputs: no named parameters. Returns: result
playB
Start playback in RV.
Inputs: no named parameters. Returns: result
save_sessionC
Save the current session to an .rv file.
Args: file_path: Path for the .rv session file.
Inputs: file_path (required). Returns: result
set_backgroundB
Set the viewport background.
Args: method: One of "black", "checker", "grey18", "grey50", "crosshatch".
Inputs: method. Returns: result
set_cdlB
Set CDL (Color Decision List) values.
All parameters are optional — only provided values are changed.
Args: slope: RGB slope values [r, g, b]. offset: RGB offset values [r, g, b]. power: RGB power values [r, g, b]. saturation: Global saturation value.
Inputs: slope, offset, power, saturation. Returns: result
set_composite_typeA
Set the compositing mode when in stack view.
Automatically switches to stack view if not already in it.
Args: composite_type: One of "over", "add", "difference", "-difference", "replace", "topmost".
Inputs: composite_type. Returns: result
set_display_gammaB
Set display gamma.
Args: gamma: Display gamma value (e.g. 2.2 for sRGB-like).
Inputs: gamma (required). Returns: result
set_display_srgbA
Enable or disable sRGB display transform.
Args: enabled: True to enable sRGB, False to disable.
Inputs: enabled. Returns: result
set_exposureB
Set exposure adjustment.
Args: value: Exposure value (0.0 = no change). channel: "all" for uniform, or "r", "g", "b" for per-channel.
Inputs: value (required), channel. Returns: result
set_fpsC
Set the playback frames per second.
Args: fps: Target FPS value.
Inputs: fps (required). Returns: result
set_frameB
Go to a specific frame in RV.
Args: frame: The frame number to jump to.
Inputs: frame (required). Returns: result
set_gammaB
Set gamma correction.
Args: value: Gamma value (1.0 = no change).
Inputs: value (required). Returns: result
set_in_pointB
Set the in-point (start of playback range).
Args: frame: Frame number for the in-point.
Inputs: frame (required). Returns: result
set_lutA
Load a LUT file and activate it.
Args: lut_file_path: Path to the LUT file (.3dl, .csp, .cube, etc.). target: Where to apply: "look" (color pipeline), "linearize" (input linearization), "display" (display transform).
Inputs: lut_file_path (required), target. Returns: result
set_ocio_colorspaceA
Set the OCIO input color space for a source.
Inserts an OCIOFile node into the source's linearize pipeline, converting from the specified color space to scene-linear.
Args: colorspace: Input color space name (e.g. "sRGB - Texture", "ACEScg"). source_node: Source group name (e.g. "sourceGroup000000"). If omitted, uses the first source.
Inputs: colorspace (required), source_node. Returns: result
set_ocio_displayB
Set the OCIO display transform.
Inserts an OCIODisplay node into the display pipeline.
Args: display: Display name (e.g. "sRGB - Display"). view: View name (e.g. "ACES 1.0 - SDR Video").
Inputs: display (required), view (required). Returns: result
set_ocio_lookA
Apply an OCIO look to a source.
Inserts an OCIOLook node into the source's look pipeline.
Args: look: Look name from the OCIO config. direction: "forward" or "inverse". source_node: Source group name. If omitted, uses the first source.
Inputs: look (required), direction, source_node. Returns: result
set_out_pointB
Set the out-point (end of playback range).
Args: frame: Frame number for the out-point.
Inputs: frame (required). Returns: result
set_playback_speedA
Set the playback increment (direction and speed).
Args: direction: Positive for forward, negative for reverse. 1 = normal forward, -1 = normal reverse, 2 = 2x forward, etc.
Inputs: direction. Returns: result
set_play_modeA
Set the playback loop mode.
Args: mode: One of "loop", "once", or "pingpong".
Inputs: mode. Returns: result
set_realtimeA
Enable or disable realtime playback mode.
When enabled, RV will skip frames to maintain the target FPS.
Args: enabled: True to enable realtime, False to play every frame.
Inputs: enabled. Returns: result
set_saturationB
Set saturation.
Args: value: Saturation value (1.0 = normal, 0.0 = desaturated).
Inputs: value (required). Returns: result
set_view_modeA
Switch RV's view mode.
Args: mode: One of "sequence" (play sources in order), "stack" (layer sources for comparison), "layout" (tile sources side by side).
Inputs: mode (required). Returns: result
step_backwardB
Step backward by N frames.
Args: count: Number of frames to step backward (default 1).
Inputs: count. Returns: result
step_forwardA
Step forward by N frames.
Args: count: Number of frames to step forward (default 1).
Inputs: count. Returns: result
stopA
Stop playback in RV.
Inputs: no named parameters. Returns: result
toggle_playbackA
Toggle play/stop in RV. Returns the new state.
Inputs: no named parameters. Returns: result
toggle_wipeA
Toggle wipe mode on/off for A/B comparison in stack view.
Automatically switches to stack view first.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 47 tools
Most tools have distinct purposes, with clear descriptions differentiating them. There is some potential confusion between similar 'clear' tools and frame-info tools, but overall an agent can distinguish well.
Naming uses underscores consistently but verb style varies (clear_, get_, set_, load_, play, stop, toggle). The pattern is not strictly verb_noun throughout, e.g., 'execute_mu' and 'new_session' deviate. Still readable.
With 47 tools, the server is quite heavy. While the domain (media playback and color correction) can justify many tools, this count feels excessive and could be streamlined.
The tool set covers most aspects of RV control: session management, source loading, playback, frame navigation, color correction (CDL, LUT, OCIO), display settings, and view modes. A notable gap is the lack of a tool to remove individual sources.
Maintenance
Related MCP Connectors
Edit video by talking to your AI — search footage, cut timelines, apply effects, add captions.
Video review and collaboration for teams and agents: a full review interface for agentic video and motion graphics, feedback by voice, screen and drawing on the frame, agents that iterate version by version, and every version's notes and source files saved for the team.
QC, conform and AI video, image and sound generation for film. Priced before every run.
Edit video and audio using natural language.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI-driven DaVinci Resolve 21 automation with 88 tools for project management, timeline editing, color grading, AI analysis, rendering, and dailies creation.884MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control DaVinci Resolve (Free and Studio) through natural language, providing 162 tools for timeline editing, color grading, rendering, and more. Includes local AI replacements for Studio-only features like voice isolation, background removal, and transcription.1MIT
- AlicenseBqualityCmaintenanceEnables AI-driven video editing and color grading in DaVinci Resolve, including beat-synced cuts, algorithmic 3D LUT generation, media transcoding, and hands-free playback control through natural language.212MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI assistants to control Adobe Premiere Pro through natural language, automating project and media management, timeline editing, color and audio adjustments, titles and markers, and batch exports via a local bridge.1MIT