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

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 45124

2. Instalar y registrar

Claude Code (CLI):

claude mcp add --scope user rv-mcp -- uv run --no-sync --directory /path/to/RV_MCP rv-mcp

Nota: --no-sync evita conflictos de bloqueo de archivos cuando varias sesiones de Claude comparten el mismo servidor MCP. Ejecuta uv sync manualmente 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):

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) --> RV

El 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.Lock para llamadas a herramientas concurrentes

• Cierre limpio mediante un manejador atexit que envía DISCONNECT (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> DISCONNECT

Gestió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

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)

OCIO (6)

Ejecución (1)

Reproducción (17)

Fuentes (7)

Comparación (4)

Color (12)

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 tools

Solución de problemas

"Could not connect to RV"

• Asegúrate de que RV se esté ejecutando con el flag -network

• Comprueba que el puerto 45124 no esté bloqueado por un firewall

• Usa -networkPort 45124 para 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 existir

• Las 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.server

Licencia

MIT