경로 계획하기
경유지를 순서에 상관없이 말하면 어시스턴트가 여행을 구성합니다. 도시에서 도시로, 산책로에서 다음 산책로까지.
개요
Travel Animator MCP 서버란?
Travel Animator MCP 서버는 PyPI의 travel-animator라는 Python 패키지입니다. Model Context Protocol을 통해 AI 어시스턴트가 Travel Animator의 경로 영상 제작 과정을 실행할 수 있게 합니다. 설치 후 한 번 로그인하면 Claude나 Cursor 같은 어시스턴트가 채팅으로 입력한 내용만으로 경로를 계획하고, 애니메이션을 꾸미고, 내 컴퓨터에서 MP4를 렌더링할 수 있습니다.
MCP는 어시스턴트를 외부 도구에 연결하는 개방형 표준입니다. 클라이언트는 travel-animator mcp로 서버를 시작하고 사용 가능한 도구를 찾은 다음 대화 중에 호출합니다. 별도 앱 사용법을 익히거나 API 키를 설정할 필요 없이 Travel Animator에 로그인하면 됩니다.
모바일 앱과 같은 계정으로 같은 여행을 렌더링합니다. Travel Animator의 핵심인 경로 애니메이션, 3D 차량 모델, 지도 스타일을 그대로 사용합니다. 직접 영상을 만들고 싶다면 iOS 및 Android 앱에서 터미널 없이 같은 작업을 할 수 있습니다. 경유지 추가, 차량 선택, 내보내기까지 휴대폰에서 네 단계면 됩니다.
어시스턴트가 할 수 있는 일
서버 하나로 모든 과정을
MCP 서버는 전체 제작 과정을 도구로 제공합니다. 편집기를 열지 않아도 어시스턴트가 한 문장에서 완성된 영상까지 만들어 낼 수 있습니다.
애니메이션 조정하기
차량, 경로 스타일, 속도 등 애니메이션의 모습과 움직임을 일상적인 말로 요청해 바꾸세요.
영상 렌더링하기
내 하드웨어로 MP4를 내보내세요. libx264는 모든 환경에서 작동하며, NVIDIA 인코딩에는 h264_nvenc를 지정하면 됩니다.
설치
세 단계로 시작하기
컴퓨터에 Python 3.12 이상이 설치되어 있다면 약 2분이면 됩니다.
- 1
mcpextra와 함께 패키지 설치extra는 기본 설치에서 의도적으로 제외한 MCP SDK를 추가합니다. 패키지가 아직 베타 버전이므로 첫 정식 버전이 나올 때까지
--pre옵션이 필요합니다.터미널pip install --pre "travel-animator[mcp]" - 2
Travel Animator 계정에 로그인
모바일 앱과 같은 계정을 사용합니다. 대화형 터미널에서는 매직 링크 방식으로 로그인합니다. 이메일을 입력한 뒤 6자리 코드를 입력하세요. CI에서는 대신 bearer 토큰을 전달합니다. 인증 정보는
~/.config/tada/credentials.json에0600권한으로 저장됩니다.터미널travel-animator login - 3
AI 클라이언트를 서버에 연결
클라이언트의 MCP 설정에 서버를 추가하고 클라이언트를 다시 시작하세요. 그다음 영상을 만들어 달라고 요청하면 됩니다. 어시스턴트는 여행을 만들기 전에
auth_status를 호출해 로그인 상태를 확인할 수 있습니다.MCP 클라이언트 설정{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
호환 클라이언트
- Claude Desktop
- Claude Code
- Cursor
- stdio를 지원하는 모든 MCP 클라이언트
직접 해보기
연결 후 이렇게 요청해 보세요
명령어를 외울 필요가 없습니다. 사람에게 말하듯 여행과 원하는 분위기를 설명하세요.
- 도쿄 → 교토 → 오사카 여행을 비행기 경로로 애니메이션화하고 1080p로 렌더링해 줘.
- 두바이에서 무스카트까지 자동차 여행 경로를 계획하고 영화 같은 느낌으로 꾸며 줘.
- 마지막 영상을 더 느린 속도와 다른 차량으로 다시 렌더링해 줘.
- 로그인 상태를 확인한 뒤 아까 준비한 번들을 렌더링해 줘.
명령줄
travel-animator CLI
MCP 서버는 직접 실행할 수도 있는 작은 콘솔 스크립트의 하위 명령어입니다.
travel-animator login매직 링크로 로그인하거나 비대화형 사용을 위해 bearer 토큰을 저장합니다.
travel-animator logout로컬에 저장된 인증 정보를 삭제합니다. 내 컴퓨터에만 적용되며 서버 측 세션 해제 기능은 아직 없습니다.
travel-animator render-bundle준비된 번들을 네트워크 연결 없이 MP4로 렌더링합니다. 전체 옵션은 --help로 확인하세요.
travel-animator mcpstdio MCP 서버를 실행합니다. mcp extra가 필요합니다.
시작하기 전에
요구 사항과 알아둘 점
그래픽 및 영상
렌더링에는 OpenGL 구현이 필요합니다. 운영 환경에서는 GPU 드라이버, CPU만 사용하는 Linux에서는 Mesa/llvmpipe를 사용하며, FFmpeg/PyAV의 일반적인 런타임 라이브러리도 필요합니다.
플랫폼
Linux, macOS, Windows를 모두 지원합니다. Windows에서는 WGL로 GL 컨텍스트를 생성하므로 대화형 데스크톱 세션이 필요합니다. 서비스에서는 이 컨텍스트를 만들 수 없으며 소프트웨어 렌더링으로 대체하는 기능도 없습니다.
라이선스
오픈 소스가 아닌 제한적 사용 라이선스입니다. Travel Animator 콘텐츠를 준비하고 렌더링하기 위해 수정 없이 설치하고 실행할 수 있습니다. 재배포, 수정, 경쟁 서비스 제작은 허용되지 않습니다. 추가 권한은 Lascade에 문의하세요.
자주 묻는 질문
궁금한 점에 답해 드립니다
Model Context Protocol이란?
MCP는 AI 어시스턴트를 외부 도구와 데이터에 연결하는 개방형 표준입니다. Claude Desktop, Claude Code, Cursor 같은 클라이언트가 MCP 서버를 시작하고 제공되는 도구를 찾은 뒤 대화 중 사용자를 대신해 호출할 수 있습니다. travel-animator에는 이러한 서버가 포함되어 있어 어시스턴트가 경로 영상 제작 과정을 직접 실행할 수 있습니다.
어떤 AI 어시스턴트에서 사용할 수 있나요?
stdio를 통한 MCP를 지원하는 모든 클라이언트에서 사용할 수 있습니다. Claude Desktop, Claude Code, Cursor가 포함됩니다. 모두 동일한 JSON 설정 블록을 사용하며 travel-animator 명령어에 mcp 인수를 지정합니다.
Travel Animator 계정이 필요한가요?
네. 이 패키지는 Travel Animator 서비스를 보완하므로 먼저 travel-animator login을 실행하세요. 모바일 앱과 같은 계정 시스템을 사용합니다. 로그인하지 않으면 인증 정보가 필요한 도구가 실행을 중단하고 로그인을 요청하는 명확한 메시지를 표시합니다.
렌더링은 어디서 이루어지나요?
내 컴퓨터에서 이루어집니다. 로컬 OpenGL 구현과 FFmpeg 라이브러리를 사용하며, render-bundle은 준비된 번들을 네트워크 연결 없이 렌더링합니다.
pip에서 일치하는 버전을 찾을 수 없다고 하는 이유는 무엇인가요?
패키지가 아직 베타 버전이고 pip는 기본적으로 사전 릴리스를 제외합니다. --pre 옵션으로 설치하세요: pip install --pre "travel-animator[mcp]".
오픈 소스인가요?
아니요. travel-animator는 제한적 사용 라이선스로 배포됩니다. Travel Animator 콘텐츠를 준비하고 렌더링하기 위해 수정 없이 설치하고 실행할 수 있지만, 재배포하거나 수정하거나 경쟁 서비스 제작에 사용할 수는 없습니다. 전체 약관은 패키지에 포함되어 있으며, 함께 제공되는 글꼴과 국기 이미지는 각각의 OFL 및 MIT 라이선스를 따릅니다.
하드웨어 인코딩을 사용할 수 있나요?
네. 기본 인코더는 모든 환경에서 작동하는 libx264입니다. NVIDIA 하드웨어 인코딩을 사용하려면 render-bundle에 --encoder h264_nvenc를 전달하세요.
MCP 서버는 어떤 데이터를 수집하나요?
프로젝트, 경로, 렌더링된 영상은 내 컴퓨터에 저장되며, 경로를 계정에 명시적으로 저장하지 않는 한 업로드되지 않습니다. 분석은 선택 사항이며 기본적으로 꺼져 있습니다. travel-animator analytics on을 실행하기 전에는 아무것도 수집하지 않으며, travel-animator analytics off로 동의를 철회할 수 있습니다. 동의하면 실행한 도구, 실행 순서, 소요 시간, 실패 여부, 렌더링 설정, 경로의 포인트 수가 이벤트에 기록됩니다. 좌표, 장소 이름, 파일 경로, 사용자 미디어, 도구가 반환한 결과는 절대 포함되지 않습니다. 자세한 내용은 https://www.travelanimator.com/privacy-policy의 개인정보 처리방침에서 확인할 수 있습니다.
지시문보다 화면 터치가 편하신가요?
Travel Animator는 모바일 앱에서 시작했습니다. 터미널 없이 iOS와 Android에서 같은 경로 애니메이션을 직접 만들어 보세요.
앱 다운로드
