RV MCP Server
Servidor MCP de RV
Servidor MCP (Model Context Protocol) que conecta asistentes de IA como Claude con Autodesk/Tweak RV, la aplicación de revisión de medios estándar en la industria. Controla la reproducción, compara tomas, ajusta la gradación de color y gestiona sesiones de revisión, todo mediante lenguaje natural.
No se requiere ningún plugin dentro de RV. Utiliza el listener de red integrado de RV con scripting Mu a través de remote-eval.
Requisitos
OpenRV (o RV 2022.3.1+) con el modo de red habilitado
Python 3.10+
Gestor de paquetes uv
Related MCP server: davinci-resolve-mcp-free
Inicio rápido
1. Iniciar RV con red
Habilita la red en RV a través de RV → Networking → Enable Network (puerto predeterminado 45124).
O desde la línea de comandos:
rv -network -networkPort 451242. Instalar y registrar
Claude Code (CLI):
claude mcp add --scope user rv-mcp -- uv run --no-sync --directory /path/to/RV_MCP rv-mcpNota:
--no-syncevita conflictos de bloqueo de archivos cuando varias sesiones de Claude comparten el mismo servidor MCP. Ejecutauv syncmanualmente después de cambiar las dependencias.
Claude Desktop (~/.claude.json):
{
"mcpServers": {
"rv-mcp": {
"command": "uv",
"args": ["run", "--no-sync", "--directory", "/path/to/RV_MCP", "rv-mcp"]
}
}
}Variables de entorno (opcional):
Variable | Predeterminado | Descripción |
|
| Host de red de RV |
|
| Puerto de red de RV |
3. Uso
Pídele a Claude que cargue medios, controle la reproducción, compare tomas o ajuste colores. El servidor traduce automáticamente el lenguaje natural a comandos de RV.
Arquitectura
Claude (stdio/MCP) --> FastMCP Server --> RV Network Protocol (TCP:45124) --> RVEl servidor mantiene una conexión TCP persistente con RV utilizando un protocolo personalizado basado en RvCommunicator de RV. Decisiones clave de diseño:
Conexión persistente con reconexión automática en caso de pérdida de socket
Seguro para hilos (Thread-safe) mediante
threading.Lockpara llamadas a herramientas concurrentesCierre limpio mediante un manejador
atexitque envíaDISCONNECT(sin esto, RV rechaza conexiones futuras)Manejo de cadenas Mu — los valores de retorno se eliminan automáticamente de comillas y caracteres de escape
Flujo del protocolo
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> DISCONNECTGestión de color OCIO
El servidor incluye soporte completo para OCIO v2. Cuando $OCIO está configurado, RV puede igualar la transformación de pantalla exacta utilizada por tus aplicaciones DCC (3ds Max/Redshift, Nuke, etc.).
Configuración automática
Se incluye un script rv_ocio_setup.py que configura automáticamente OCIO cuando RV carga medios:
Archivos EXR/HDR/TX se detectan automáticamente como scene-linear (ACEScg a través del rol
scene_linear)Transformación de pantalla se establece a partir de los valores predeterminados de la configuración (ej.
sRGB/ACES 1.0 SDR-video)Metadatos de cromaticidad en EXRs se comparan con los espacios de color de la configuración activa
Para instalar, copia rv_ocio_setup.py a tu ruta de soporte de RV:
# Windows
copy rv_ocio_setup.py %APPDATA%\RV\Python\
# Linux/macOS
cp rv_ocio_setup.py ~/.rv/Python/El paquete integrado ocio_source_setup de RV detectará y utilizará esta anulación automáticamente.
OCIO manual mediante MCP
Herramienta | Descripción |
| Lista espacios de color, pantallas, vistas y looks de la configuración OCIO activa |
| Establece el espacio de color de entrada para una fuente (inserta nodo OCIOFile) |
| Establece la transformación de pantalla (inserta nodo OCIODisplay) |
| Aplica un look OCIO a una fuente |
| Obtiene el estado actual del nodo OCIO como JSON |
| Elimina nodos OCIO y restaura la tubería predeterminada |
Coincidencia de color Redshift + RV
Si utilizas la configuración OCIO de Redshift ($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio), ten en cuenta que sus reglas de archivo marcan los EXR como "Raw". El script rv_ocio_setup.py anula esto detectando formatos de punto flotante como scene-linear, asegurando que el tonemapper ACES se aplique en RV igual que en la vista de renderizado de Redshift.
Herramientas (47 en total)
Ejecución (1)
Herramienta | Descripción |
| Ejecuta código Mu arbitrario — vía de escape para cualquier cosa no cubierta por herramientas dedicadas |
OCIO (6)
Herramienta | Descripción |
| Obtiene información de configuración OCIO (espacios de color, pantallas, vistas, looks) |
| Establece el espacio de color de entrada OCIO para una fuente |
| Establece la transformación de pantalla OCIO |
| Aplica un look OCIO |
| Obtiene el estado OCIO actual como JSON |
| Elimina nodos OCIO, restaura valores predeterminados |
Ejecución (1)
Herramienta | Descripción |
| Ejecuta código Mu arbitrario — vía de escape para cualquier cosa no cubierta por herramientas dedicadas |
Reproducción (17)
Herramienta | Descripción |
| Carga un archivo de medios (secuencia de imágenes, película o imagen única) |
| Carga múltiples archivos de medios a la vez |
| Inicia la reproducción |
| Detiene la reproducción |
| Alterna reproducción/parada, devuelve el nuevo estado |
| Obtiene el número de fotograma actual |
| Salta a un fotograma específico |
| Avanza N fotogramas (predeterminado 1) |
| Retrocede N fotogramas (predeterminado 1) |
| Establece el punto de entrada (inicio del rango de reproducción) |
| Establece el punto de salida (fin del rango de reproducción) |
| Obtiene los puntos de entrada/salida actuales como JSON |
| Establece los fotogramas por segundo de reproducción |
| Obtiene los FPS de reproducción actuales |
| Habilita/deshabilita el modo en tiempo real (salta fotogramas para mantener los FPS) |
| Establece el modo de bucle: |
| Establece la dirección y velocidad de reproducción (1=adelante, -1=atrás, 2=2x, etc.) |
| Obtiene el estado completo de reproducción como JSON (fotograma, rango, entrada/salida, reproduciendo, fps) |
Fuentes (7)
Herramienta | Descripción |
| Lista todos los nodos de fuente cargados como matriz JSON |
| Obtiene información detallada de los medios (resolución, rango de fotogramas, fps, profundidad de bits, canales) |
| Obtiene los nodos de fuente visibles en un fotograma específico |
| Crea una nueva sesión vacía |
| Borra todas las fuentes de la sesión actual |
| Guarda la sesión en un archivo |
| Obtiene el estado de la sesión como JSON (nodo de vista, rango de fotogramas, recuento de fuentes) |
Comparación (4)
Herramienta | Descripción |
| Cambia la vista: |
| Establece el modo de composición de pila: |
| Alterna la comparación de barrido A/B (cambia automáticamente a la vista de pila) |
| Obtiene el estado de vista actual como JSON |
Color (12)
Herramienta | Descripción |
| Carga un archivo LUT ( |
| Desactiva LUT en un objetivo |
| Establece valores CDL (pendiente, desplazamiento, potencia, saturación) — se admiten actualizaciones parciales |
| Desactiva la corrección de color CDL |
| Establece la exposición (por canal o uniforme) |
| Establece la corrección gamma |
| Establece la saturación |
| Obtiene el estado actual de corrección de color como JSON |
| Establece la gamma de pantalla (ej. 2.2 para sRGB) |
| Habilita/deshabilita la transformación de pantalla sRGB |
| Establece el fondo del visor: |
Ejemplos de uso
Cargar y revisar metraje
"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"Comparar dos versiones
"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"Corrección de color
"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"Avanzado (Mu sin procesar)
"Execute this Mu code: { require commands; let s = sources(); string(s.size()); }"Estructura del proyecto
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 toolsSolución de problemas
"Could not connect to RV"
Asegúrate de que RV se esté ejecutando con el flag
-networkComprueba que el puerto 45124 no esté bloqueado por un firewall
Usa
-networkPort 45124para establecer explícitamente el puerto
RV rechaza conexiones después de un bloqueo
Si el servidor sale sin enviar DISCONNECT, RV puede rechazar nuevas conexiones. Reinicia RV para borrar el estado. El servidor incluye un manejador atexit para evitar esto bajo operación normal.
Errores de código Mu
Envuelve siempre los bloques de código en
{ require commands; ... }Mu evalúa ambas ramas de
if/then/else— evita el acceso a propiedades en nodos que pueden no existirLas rutas de archivo deben usar barras inclinadas hacia adelante;
escape_mu_string()maneja esto automáticamente
Errores de tiempo de espera (Timeout)
El tiempo de espera predeterminado es de 30 segundos. Si el código Mu tarda más (ej. cargar secuencias grandes), puede agotarse el tiempo. Usa execute_mu para operaciones largas y considera dividirlas en pasos más pequeños.
Desarrollo
# Install dependencies
uv sync
# Run the server directly
uv run rv-mcp
# Run with debug logging
uv run python -m src.serverLicencia
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.2MIT
- 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