Embody (Envoy MCP)의 개요
Embody는 Dylan Roscover가 만든 TouchDesigner 컴포넌트로, .tox 파일로 프로젝트에 끌어다 놓아 씁니다. 네 부분으로 이뤄져 있습니다. 실행 중인 TouchDesigner 세션에 내장된 MCP 서버 Envoy, 태그한 오퍼레이터를 네트워크 구조 그대로 디스크 파일로 쓰는 외부화, 네트워크 전체를 읽기 쉬운 파일 하나에 담는 YAML 형식 TDXN, 그리고 신뢰할 수 있는 LAN의 Embody 노드끼리 서로를 제어하게 하는 미리보기 기능 Convoy입니다.
Envoy는 Claude Code, Codex, Cursor, Copilot 같은 클라이언트에 약 70개 도구를 제공해 오퍼레이터를 만들고, 연결하고, 파라미터를 설정하고, Python을 실행하고, 렌더링된 프레임을 캡처하고, 오류를 읽게 합니다. 프로젝트는 MIT 라이선스의 Python으로 스타가 약 218개이며, 2026년 11월 1일 v6.3.3을 출시했고, Windows나 macOS에서 TouchDesigner 2025.33230 이상이 필요합니다. TouchDesigner 자체는 비상업적 작업에만 무료이며, 유료 프로젝트에는 $600의 Commercial이나 $2,200의 Pro 라이선스가 필요합니다.
Embody (Envoy MCP) 설치 방법
Download the Embody .tox from https://github.com/dylanroscover/Embody/tree/main/release and drag it into a TouchDesigner projectEmbody (Envoy MCP), 쓸 만한 가치가 있습니까?
Embody의 진짜 기여는 TouchDesigner 네트워크를 읽을 수 있게 만든 것입니다. .toe 프로젝트는 에이전트가 읽지 못하고 git이 비교하지 못하는 바이너리 파일인데, TDXN은 네트워크를 둘 다 다룰 수 있는 YAML로 바꿉니다. read_tdxn은 실행 중인 네트워크를 이 형식으로 돌려주며, 문서에 따르면 오퍼레이터를 하나씩 훑는 것보다 토큰이 20에서 90배 적게 듭니다. 변경을 일으키는 도구 호출은 모두 TouchDesigner의 실행 취소 블록으로 감싸지므로 Ctrl+Z로 에이전트의 변경을 되돌릴 수 있고, capture_top으로 에이전트가 렌더링 결과를 직접 보며 검거나 빈 프레임은 표시됩니다.
설치 전에 읽어야 할 부분은 보안 모델입니다. Envoy는 127.0.0.1:9870에서 대기하며, 인스턴스가 여러 개면 9879까지 차례로 찾고, 브라우저발 공격에 대비해 Host와 Origin 헤더를 검사합니다. 인증은 없습니다. 문서에 따르면 포트에 닿는 로컬 프로세스라면 무엇이든 세션을 완전히 제어할 수 있고, 여기에는 TouchDesigner 메인 스레드에서 파일, 네트워크, 프로세스에 접근하며 임의의 Python을 실행하는 execute_python도 포함됩니다. 개인 워크스테이션이라면 괜찮지만 공용 컴퓨터나 클라우드 데스크톱에서는 실제 위험입니다. 설정 마법사가 Claude Code용으로 권장하는 권한 설정 Don't ask는 execute_python을 포함한 모든 Envoy 도구를 미리 승인합니다. Ask for some을 고르면 편집과 실행은 확인을 거칩니다.
Convoy는 노출 범위를 넓힙니다. 로그인할 때마다 계속 실행되는 사용자별 백그라운드 앱을 설치하고, 암호화와 상호 인증을 갖춘 LAN 리스너를 열며, TouchDesigner가 닫혀 있어도 컴퓨터 사이에서 작업을 중계합니다. 원격 Python과 셸은 기본적으로 꺼져 있고 로컬에서만 켤 수 있지만, 일반 중계 도구로도 프로젝트를 바꿀 수 있으며, 문서는 게스트용이나 공용 네트워크에서 켜지 말라고 합니다. Convoy는 개발 미리보기로 표시돼 있고, macOS에서 노드 간 동작은 아직 검증되지 않았습니다.
경쟁자는 가까이 있습니다. 8beeeaaat의 먼저 나온 touchdesigner-mcp는 스타가 약 626개이고, Derivative의 자체 TDMCP는 2026년 9월부터 공개돼 있으며, Embody는 둘 다에서 아이디어를 얻었다고 밝힙니다. Embody는 기능 범위, 텍스트 형식, TouchDesigner 안에서 도는 5,720개 테스트에서 앞서고, 차지하는 공간에서 밀립니다. AGENTS.md, CLAUDE.md, .mcp.json 등 클라이언트 파일을 저장소에 쓰고 자체 Python 환경을 관리하기 때문입니다.
제 역할을 하는 곳
페스티벌용 영상을 만드는 프리랜서 비주얼 아티스트
피드백 루프 룩을 하룻밤에 세 가지로 스케치하기
각 룩을 Claude Code에 설명하면 Envoy가 오퍼레이터를 만들고 연결하며, capture_top이 결과를 보여 주고, 시도마다 TDXN으로 내보내 비교합니다. 유료 작업에는 $600의 TouchDesigner Commercial 라이선스가 필요합니다.
세 명 규모의 인터랙티브 설치 작품 스튜디오
TouchDesigner 프로젝트를 git으로 관리하고 변경 검토하기
COMP에 외부화 태그 를 달면 저장할 때마다 .tdxn과 .py 파일이 써져 풀 리퀘스트에서 깔끔하게 비교됩니다. Roundtrip 모드를 켜지 않는 한 기준은 .toe입니다.
렌더 노드 랙을 운영하는 테크니컬 디렉터
한 세션에서 프로젝트 업데이트를 배포하고 모든 컴퓨터 재시작하기
Convoy가 저장, 재시작, 파일 전송을 LAN으로 각 노드에 중계합니다. 신뢰할 수 있는 제작 네트워크에서만 쓰고, 작업에 꼭 필요하지 않다면 Allow Execute TD Python과 Allow Full Shell은 꺼 둡니다.
도입 전 확인할 점
- 설정
- release 폴더에서 .tox를 내려받아 프로젝트에 끌어다 놓습니다. 설정 마법사에서 AI 클라이언트, 권한, Convoy를 고릅니다. Envoy는 TouchDesigner를 실행할 수 있는 stdio 브리지가 담긴 .mcp.json을 쓰며, 직접 HTTP 주소는 http://127.0.0.1:9870/mcp입니다. Windows나 macOS에서 TouchDesigner 2025.33230+가 필요합니다.
- 연동
- 약 70개 도구: create_op, set_parameter, connect_ops, execute_python, exec_op_method, read_tdxn, export_network와 import_network, capture_top, get_op_errors, run_tests, launch_td, 그리고 Convoy 중계 도구. Claude Code, Codex, OpenCode, Gemini, Cursor, Windsurf, Copilot용 설정을 생성합니다.
- 데이터와 개인정보
- 로컬입니다. Envoy는 127.0.0.1에만 바인딩하고 Host와 Origin을 검사하지만 인증은 없습니다. execute_python과 exec_op_method로 연결된 클라이언트는 누구든 사용자 권한으로 코드를 실행할 수 있습니다. Convoy는 로그인 시 상주하는 호스트 앱을 통해 인증된 LAN 리스너를 엽니다. 원격 Python과 셸은 기본적으로 꺼져 있습니다. 로그는 최근 200개 작업과 일별 파일을 보관합니다.
- 대규모 사용 시 비용
- Embody는 무료입니다. TouchDesigner Non-Commercial은 무료지만 1280x1280으로 제한되고 유료 작업에는 쓸 수 없습니다. Commercial $600, Pro $2,200, Educational $300입니다.
- 제한
- 타임라인이 돌고 있어야 하며, 클론과 레플리컨트 오퍼레이터는 외부화할 수 없습니다. Convoy는 미리보기이며 macOS의 LAN 동작은 검증되지 않았습니다. 열린 이슈는 9개입니다. 공용 컴퓨터에서는 인증 없는 포트가 다른 사용자에게 노출됩니다.
좋은 점
- TDXN으로 네트워크를 비교하고 에이전 트가 읽을 수 있음
- 에이전트의 변경을 Ctrl+Z로 되돌릴 수 있음
- 검은 프레임을 자동 판별하는 프레임 캡처
- MIT 라이선스에 잦은 릴리스
아쉬운 점
- Envoy의 로컬 포트에 인증이 없음
- execute_python이 임의 코드를 실행하며, 권장 설정에서 자동 승인됨
- Convoy가 LAN 백그라운드 서비스를 추가하고 아직 미리보기임
- 여러 설정 및 에이전트 파일을 프로젝트에 씀
추천 대상
혼자 쓰는 워크스테이션에서 에이전트에게 네트워크 구축과 디버깅을 맡기고 프로젝트를 git으로 관리하려는 TouchDesigner 아티스트와 스튜디오.
Embody (Envoy MCP) 대안
Embody (Envoy MCP): 자주 묻는 질문
- Embody (Envoy MCP), 쓸 만한 가치가 있습니까?
- Embody는 에이전트가 실행 중인 TouchDesigner 안에서 작업하고 그 결과를 git에 남기게 해 주지만, 포트에 비밀번호가 없고 도구 하나가 건네받은 Python을 무엇이든 실행한다는 점은 기억해야 합니다. 평점은 5점 만점에 3.9점입니다.
- Embody (Envoy MCP)의 가격은 얼마입니까?
- Embody는 무료 오픈 소스(MIT)입니다. TouchDesigner Non-Commercial은 무료이고, Educational $300, Commercial $600, Pro $2,200입니다.
- Embody (Envoy MCP)의 단점은 무엇입니까?
- Envoy의 로컬 포트에 인증이 없음; execute_python이 임의 코드를 실행하며, 권장 설정에서 자동 승인됨; Convoy가 LAN 백그라운드 서비스를 추가하고 아직 미리보기임; 여러 설정 및 에이전트 파일을 프로젝트에 씀.
- Embody (Envoy MCP)에 적합한 사람은 누구입니까?
- 혼자 쓰는 워크스테이션에서 에이전트에게 네트워크 구축과 디버깅을 맡기고 프로젝트를 git으로 관리하려는 TouchDesigner 아티스트와 스튜디오.
- 팀이나 프로덕션 환경에서 Embody (Envoy MCP)의 비용은 얼마입니까?
- Embody는 무료입니다. TouchDesigner Non-Commercial은 무료지만 1280x1280으로 제한되고 유료 작업에는 쓸 수 없습니다. Commercial $600, Pro $2,200, Educational $300입니다.
- Embody (Envoy MCP)에 회사 데이터를 맡겨도 안전합니까?
- 로컬입니다. Envoy는 127.0.0.1에만 바인딩하고 Host와 Origin을 검사하지만 인증은 없습니다. execute_python과 exec_op_method로 연결된 클라이언트는 누구든 사용자 권한으로 코드를 실행할 수 있습니다. Convoy는 로그인 시 상주하는 호스트 앱을 통해 인증된 LAN 리스너를 엽니다. 원격 Python과 셸은 기본적으로 꺼져 있습니다. 로그는 최근 200개 작업과 일별 파일을 보관합니다.
- Embody (Envoy MCP)의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 MCP for Blender 입니다.
답변 확인일: 2026년 11월 11일.