RV MCP Server
RV MCP 서버
Claude와 같은 AI 어시스턴트를 업계 표준 미디어 리뷰 애플리케이션인 Autodesk/Tweak RV와 연결하는 MCP(Model Context Protocol) 서버입니다. 자연어를 통해 재생 제어, 샷 비교, 색 보정 조정 및 리뷰 세션 관리를 수행할 수 있습니다.
RV 내부에 별도의 플러그인이 필요하지 않습니다. remote-eval을 통한 Mu 스크립팅과 RV의 내장 네트워크 리스너를 사용합니다.
요구 사항
OpenRV (또는 RV 2022.3.1 이상), 네트워크 모드 활성화 상태
Python 3.10+
uv 패키지 관리자
Related MCP server: davinci-resolve-mcp-free
빠른 시작
1. 네트워킹과 함께 RV 시작
RV → Networking → Enable Network(기본 포트 45124)를 통해 RV에서 네트워킹을 활성화합니다.
또는 명령줄에서 실행합니다:
rv -network -networkPort 451242. 설치 및 등록
Claude Code (CLI):
claude mcp add --scope user rv-mcp -- uv run --no-sync --directory /path/to/RV_MCP rv-mcp참고:
--no-sync는 여러 Claude 세션이 동일한 MCP 서버를 공유할 때 파일 잠금 충돌을 방지합니다. 종속성을 변경한 후에는 수동으로uv sync를 실행하세요.
Claude Desktop (~/.claude.json):
{
"mcpServers": {
"rv-mcp": {
"command": "uv",
"args": ["run", "--no-sync", "--directory", "/path/to/RV_MCP", "rv-mcp"]
}
}
}환경 변수 (선택 사항):
변수 | 기본값 | 설명 |
|
| RV 네트워크 호스트 |
|
| RV 네트워크 포트 |
3. 사용 방법
Claude에게 미디어 로드, 재생 제어, 샷 비교 또는 색상 조정을 요청하세요. 서버가 자연어를 RV 명령으로 자동 변환합니다.
아키텍처
Claude (stdio/MCP) --> FastMCP Server --> RV Network Protocol (TCP:45124) --> RV이 서버는 RV의 RvCommunicator를 기반으로 하는 사용자 지정 프로토콜을 사용하여 RV와 지속적인 TCP 연결을 유지합니다. 주요 설계 결정 사항:
소켓 손실 시 자동 재연결을 포함한 지속적인 연결
동시 도구 호출을 위한
threading.Lock을 통한 스레드 안전성DISCONNECT를 전송하는atexit핸들러를 통한 깔끔한 종료(이 과정이 없으면 RV가 향후 연결을 거부함)Mu 문자열 처리 — 반환 값은 자동으로 따옴표가 제거되고 이스케이프 해제됨
프로토콜 흐름
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 색상 관리
이 서버는 완전한 OCIO v2를 지원합니다. $OCIO가 설정되면 RV는 DCC 앱(3ds Max/Redshift, Nuke 등)에서 사용하는 것과 동일한 디스플레이 변환을 일치시킬 수 있습니다.
자동 구성
RV가 미디어를 로드할 때 OCIO를 자동으로 구성하는 rv_ocio_setup.py 스크립트가 포함되어 있습니다:
EXR/HDR/TX 파일은 장면 선형(scene-linear,
scene_linear역할을 통한 ACEScg)으로 자동 감지됩니다.디스플레이 변환은 구성의 기본값(예:
sRGB/ACES 1.0 SDR-video)으로 설정됩니다.EXR의 색도 메타데이터는 활성 구성의 색 공간과 일치됩니다.
설치하려면 rv_ocio_setup.py를 RV 지원 경로에 복사하세요:
# Windows
copy rv_ocio_setup.py %APPDATA%\RV\Python\
# Linux/macOS
cp rv_ocio_setup.py ~/.rv/Python/RV의 내장 ocio_source_setup 패키지가 이 재정의를 자동으로 감지하고 사용합니다.
MCP를 통한 수동 OCIO
도구 | 설명 |
| 활성 OCIO 구성에서 색 공간, 디스플레이, 뷰 및 룩 목록을 가져옵니다 |
| 소스에 대한 입력 색 공간을 설정합니다(OCIOFile 노드 삽입) |
| 디스플레이 변환을 설정합니다(OCIODisplay 노드 삽입) |
| 소스에 OCIO 룩을 적용합니다 |
| 현재 OCIO 노드 상태를 JSON으로 가져옵니다 |
| OCIO 노드를 제거하고 기본 파이프라인을 복원합니다 |
Redshift + RV 색상 일치
Redshift의 OCIO 구성($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio)을 사용하는 경우, 해당 파일 규칙이 EXR을 "Raw"로 표시한다는 점에 유의하세요. rv_ocio_setup.py 스크립트는 부동 소수점 형식을 장면 선형으로 감지하여 이를 재정의하며, Redshift의 렌더 뷰와 마찬가지로 RV에서도 ACES 톤매퍼가 적용되도록 합니다.
도구 (총 47개)
실행 (1)
도구 | 설명 |
| 임의의 Mu 코드 실행 — 전용 도구에서 다루지 않는 모든 작업을 위한 탈출구 |
OCIO (6)
도구 | 설명 |
| OCIO 구성 정보(색 공간, 디스플레이, 뷰, 룩) 가져오기 |
| 소스에 대한 OCIO 입력 색 공간 설정 |
| OCIO 디스플레이 변환 설정 |
| OCIO 룩 적용 |
| 현재 OCIO 상태를 JSON으로 가져오기 |
| OCIO 노드 제거, 기본값 복원 |
재생 (17)
도구 | 설명 |
| 미디어 파일 로드(이미지 시퀀스, 동영상 또는 단일 이미지) |
| 여러 미디어 파일을 한 번에 로드 |
| 재생 시작 |
| 재생 중지 |
| 재생/중지 전환, 새 상태 반환 |
| 현재 프레임 번호 가져오기 |
| 특정 프레임으로 이동 |
| N 프레임만큼 앞으로 이동(기본값 1) |
| N 프레임만큼 뒤로 이동(기본값 1) |
| 인 포인트 설정(재생 범위 시작) |
| 아웃 포인트 설정(재생 범위 끝) |
| 현재 인/아웃 포인트를 JSON으로 가져오기 |
| 재생 초당 프레임 수(FPS) 설정 |
| 현재 재생 FPS 가져오기 |
| 실시간 모드 활성화/비활성화(FPS 유지를 위해 프레임 건너뛰기) |
| 루프 모드 설정: |
| 재생 방향 및 속도 설정(1=정방향, -1=역방향, 2=2배속 등) |
| 전체 재생 상태를 JSON으로 가져오기(프레임, 범위, 인/아웃, 재생 여부, FPS) |
소스 (7)
도구 | 설명 |
| 로드된 모든 소스 노드를 JSON 배열로 나열 |
| 상세 미디어 정보 가져오기(해상도, 프레임 범위, FPS, 비트 심도, 채널) |
| 특정 프레임에서 보이는 소스 노드 가져오기 |
| 새 빈 세션 생성 |
| 현재 세션에서 모든 소스 지우기 |
| 세션을 |
| 세션 상태를 JSON으로 가져오기(뷰 노드, 프레임 범위, 소스 개수) |
비교 (4)
도구 | 설명 |
| 뷰 전환: |
| 스택 합성 모드 설정: |
| A/B 와이프 비교 전환(스택 뷰로 자동 전환) |
| 현재 뷰 상태를 JSON으로 가져오기 |
색상 (12)
도구 | 설명 |
| 대상( |
| 대상에서 LUT 비활성화 |
| CDL 값 설정(슬로프, 오프셋, 파워, 채도) — 부분 업데이트 지원 |
| CDL 색 보정 비활성화 |
| 노출 설정(채널별 또는 전체) |
| 감마 보정 설정 |
| 채도 설정 |
| 현재 색 보정 상태를 JSON으로 가져오기 |
| 디스플레이 감마 설정(예: sRGB와 유사한 경우 2.2) |
| sRGB 디스플레이 변환 활성화/비활성화 |
| 뷰포트 배경 설정: |
사용 예시
푸티지 로드 및 리뷰
"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"두 버전 비교
"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"색 보정
"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"고급 (원시 Mu)
"Execute this Mu code: { require commands; let s = sources(); string(s.size()); }"프로젝트 구조
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문제 해결
"Could not connect to RV"
RV가
-network플래그와 함께 실행 중인지 확인하세요.45124 포트가 방화벽에 의해 차단되지 않았는지 확인하세요.
-networkPort 45124를 사용하여 포트를 명시적으로 설정하세요.
충돌 후 RV가 연결을 거부함
서버가 DISCONNECT를 보내지 않고 종료되면 RV가 새 연결을 거부할 수 있습니다. RV를 다시 시작하여 상태를 지우세요. 서버에는 정상 작동 시 이를 방지하기 위한 atexit 핸들러가 포함되어 있습니다.
Mu 코드 오류
코드 블록은 항상
{ require commands; ... }로 감싸세요.Mu는
if/then/else의 두 분기를 모두 평가하므로 존재하지 않을 수 있는 노드에 대한 속성 액세스를 피하세요.파일 경로는 슬래시(/)를 사용해야 하며,
escape_mu_string()이 이를 자동으로 처리합니다.
시간 초과 오류
기본 시간 초과는 30초입니다. Mu 코드가 더 오래 걸리는 경우(예: 대규모 시퀀스 로드) 시간 초과가 발생할 수 있습니다. 긴 작업에는 execute_mu를 사용하고 더 작은 단계로 나누는 것을 고려하세요.
개발
# Install dependencies
uv sync
# Run the server directly
uv run rv-mcp
# Run with debug logging
uv run python -m src.server라이선스
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