RV MCP Server

Ein MCP-Server (Model Context Protocol), der KI-Assistenten wie Claude mit Autodesk/Tweak RV verbindet, der branchenüblichen Anwendung für Medien-Reviews. Steuern Sie die Wiedergabe, vergleichen Sie Aufnahmen, passen Sie Farbkorrekturen an und verwalten Sie Review-Sitzungen – alles per natürlicher Sprache.

Es ist kein Plugin innerhalb von RV erforderlich. Verwendet den integrierten Netzwerk-Listener von RV mit Mu-Scripting via remote-eval.

Anforderungen

• OpenRV (oder RV 2022.3.1+) mit aktiviertem Netzwerkmodus

• Python 3.10+

• uv Paketmanager

Schnellstart

1. RV mit Netzwerk starten

Aktivieren Sie das Netzwerk in RV über RV → Networking → Enable Network (Standard-Port 45124).

Oder über die Befehlszeile:

rv -network -networkPort 45124

2. Installieren und registrieren

Claude Code (CLI):

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

Hinweis: --no-sync verhindert Dateisperrkonflikte, wenn mehrere Claude-Sitzungen denselben MCP-Server gemeinsam nutzen. Führen Sie uv sync manuell aus, nachdem Sie Abhängigkeiten geändert haben.

Claude Desktop (~/.claude.json):

{
  "mcpServers": {
    "rv-mcp": {
      "command": "uv",
      "args": ["run", "--no-sync", "--directory", "/path/to/RV_MCP", "rv-mcp"]
    }
  }
}

Umgebungsvariablen (optional):

3. Verwendung

Bitten Sie Claude, Medien zu laden, die Wiedergabe zu steuern, Aufnahmen zu vergleichen oder Farben anzupassen. Der Server übersetzt natürliche Sprache automatisch in RV-Befehle.

Architektur

Claude (stdio/MCP) --> FastMCP Server --> RV Network Protocol (TCP:45124) --> RV

Der Server unterhält eine persistente TCP-Verbindung zu RV unter Verwendung eines benutzerdefinierten Protokolls, das auf RVs RvCommunicator basiert. Wichtige Designentscheidungen:

• Persistente Verbindung mit automatischer Wiederverbindung bei Socket-Verlust

• Threadsicher durch threading.Lock für gleichzeitige Tool-Aufrufe

• Sauberes Herunterfahren über einen atexit-Handler, der DISCONNECT sendet (ohne diesen lehnt RV zukünftige Verbindungen ab)

• Mu-String-Verarbeitung — Rückgabewerte werden automatisch von Anführungszeichen befreit und maskiert

Protokollfluss

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

OCIO-Farbmanagement

Der Server beinhaltet volle OCIO v2-Unterstützung. Wenn $OCIO gesetzt ist, kann RV die exakte Display-Transformation abgleichen, die von Ihren DCC-Anwendungen (3ds Max/Redshift, Nuke, etc.) verwendet wird.

Automatische Konfiguration

Ein rv_ocio_setup.py-Skript ist enthalten, das OCIO automatisch konfiguriert, wenn RV Medien lädt:

• EXR/HDR/TX-Dateien werden automatisch als Scene-Linear erkannt (ACEScg über die scene_linear-Rolle)

• Display-Transformation wird aus den Standardeinstellungen der Konfiguration gesetzt (z. B. sRGB / ACES 1.0 SDR-video)

• Chromatizitäts-Metadaten in EXRs werden mit den Farbräumen der aktiven Konfiguration abgeglichen

Kopieren Sie zur Installation rv_ocio_setup.py in Ihren RV-Support-Pfad:

# Windows
copy rv_ocio_setup.py %APPDATA%\RV\Python\

# Linux/macOS
cp rv_ocio_setup.py ~/.rv/Python/

RVs integriertes ocio_source_setup-Paket erkennt und verwendet diese Überschreibung automatisch.

Manuelles OCIO via MCP

Redshift + RV Farbabgleich

Wenn Sie die OCIO-Konfiguration von Redshift verwenden ($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio), beachten Sie, dass deren Dateiregeln EXRs als "Raw" markieren. Das rv_ocio_setup.py-Skript überschreibt dies, indem es Float-Formate als Scene-Linear erkennt und sicherstellt, dass der ACES-Tonemapper in RV genauso angewendet wird wie in der Render-Ansicht von Redshift.

Tools (insgesamt 47)

Ausführen (1)

OCIO (6)

Wiedergabe (17)

Quellen (7)

Vergleich (4)

Farbe (12)

Anwendungsbeispiele

Filmmaterial laden und überprüfen

"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"

Zwei Versionen vergleichen

"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"

Farbkorrektur

"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"

Fortgeschritten (roher Mu-Code)

"Execute this Mu code: { require commands; let s = sources(); string(s.size()); }"

Projektstruktur

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

Fehlerbehebung

"Could not connect to RV"

• Stellen Sie sicher, dass RV mit dem -network-Flag läuft

• Überprüfen Sie, ob Port 45124 nicht durch eine Firewall blockiert wird

• Verwenden Sie -networkPort 45124, um den Port explizit festzulegen

RV lehnt Verbindungen nach einem Absturz ab

Wenn der Server beendet wird, ohne DISCONNECT zu senden, lehnt RV möglicherweise neue Verbindungen ab. Starten Sie RV neu, um den Status zu löschen. Der Server enthält einen atexit-Handler, um dies im Normalbetrieb zu verhindern.

Mu-Code-Fehler

• Umschließen Sie Codeblöcke immer mit { require commands; ... }

• Mu wertet beide Zweige von if/then/else aus — vermeiden Sie den Zugriff auf Eigenschaften von Nodes, die möglicherweise nicht existieren

• Dateipfade müssen Schrägstriche verwenden; escape_mu_string() handhabt dies automatisch

Timeout-Fehler

Das Standard-Timeout beträgt 30 Sekunden. Wenn Mu-Code länger dauert (z. B. beim Laden großer Sequenzen), kann es zu einem Timeout kommen. Verwenden Sie execute_mu für lange Operationen und ziehen Sie in Betracht, diese in kleinere Schritte zu unterteilen.

Entwicklung

# Install dependencies
uv sync

# Run the server directly
uv run rv-mcp

# Run with debug logging
uv run python -m src.server

Lizenz

MIT