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: UE5 MCP Server

빠른 시작

1. 네트워킹과 함께 RV 시작

RV → Networking → Enable Network(기본 포트 45124)를 통해 RV에서 네트워킹을 활성화합니다.

또는 명령줄에서 실행합니다:

rv -network -networkPort 45124

2. 설치 및 등록

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

환경 변수 (선택 사항):

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

OCIO 색상 관리

이 서버는 완전한 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

Redshift + RV 색상 일치

Redshift의 OCIO 구성($OCIO = C:\ProgramData\redshift\Data\OCIO\config.ocio)을 사용하는 경우, 해당 파일 규칙이 EXR을 "Raw"로 표시한다는 점에 유의하세요. rv_ocio_setup.py 스크립트는 부동 소수점 형식을 장면 선형으로 감지하여 이를 재정의하며, Redshift의 렌더 뷰와 마찬가지로 RV에서도 ACES 톤매퍼가 적용되도록 합니다.

도구 (총 47개)

실행 (1)

OCIO (6)

재생 (17)

소스 (7)

비교 (4)

색상 (12)

사용 예시

푸티지 로드 및 리뷰

"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

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• clear_cdlA
• clear_lutA
• clear_ocioA
• clear_sessionA
• execute_muA
• get_color_settingsA
• get_fpsA
• get_frameA