경로 계획하기
경유지를 순서에 상관없이 말하면 어시스턴트가 여행을 구성합니다. 도시에서 도시로, 산책로에서 다음 산책로까지.
개요
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를 쓰면 좋은 사람은?
이미 AI 도우미를 사용하며 컴퓨터에서 경로를 설명하고 스타일 변경을 요청하며 영상을 만들고 싶다면 MCP를 선택하세요. Python 패키지 설치와 도우미 도구 설정에 익숙해야 합니다.
직접 탭하여 경로와 미리 보기를 확인하고 싶다면 모바일 앱을 선택하세요. 촬영본과 내레이션이 있는 긴 영상에는 내보낸 지도 클립을 동영상 편집기에서 사용하세요.
결정하기 전에: 컴퓨터의 렌더링 가능 여부, 계정, 크레딧 잔액을 확인하고 짧은 경로를 시험하세요. 렌더링을 허용하기 전에 경유지와 스타일을 검토하세요. CLI의 render-bundle 명령은 준비된 번들이 필요하며, 설명으로 프로젝트를 만들 때는 MCP를 사용하세요.
렌더링 비용: 프리미엄 계정과 크레딧이 필요합니다. 영상마다 1크레딧입니다. 준비가 끝난 뒤 로컬 렌더링에 실패해도 크레딧이 사용될 수 있습니다.
렌더링 전에 공개된 패키지 요구 사항과 크레딧 규칙을 검토하세요. 모바일 Free와 Pro 비교는 앱을 설명하며 MCP 크레딧 할당량이 아닙니다.
어시스턴트가 할 수 있는 일
서버 하나로 모든 과정을
MCP 서버는 전체 제작 과정을 도구로 제공합니다. 편집기를 열지 않아도 어시스턴트가 한 문장에서 완성된 영상까지 만들어 낼 수 있습니다.
애니메이션 조정하기
차량, 경로 스타일, 속도 등 애니메이션의 모습과 움직임을 일상적인 말로 요청해 바꾸세요.
영상 렌더링하기
내 하드웨어로 MP4를 내보내세요. libx264는 모든 환경에서 작동하며, NVIDIA 인코딩에는 h264_nvenc를 지정하면 됩니다.
설치
세 단계로 시작하기
시작 전에 Python 3.12 이상을 설치하세요. 설정 시간은 컴퓨터와 MCP 클라이언트에 따라 다릅니다.
- 1
mcpextra와 함께 패키지 설치MCP SDK를 포함하려면
mcp추가 패키지를 설치하세요. 안정 버전에는 더 이상 사전 출시 플래그가 필요하지 않습니다.터미널pip install "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가 필요합니다.
시작하기 전에
요구 사항과 알아둘 점
그래픽 및 영상
플랫폼별 wheel에는 Java가 포함되며 macOS와 Windows에는 그래픽 드라이버도 포함됩니다. Linux는 시스템 GLES 드라이버 또는 Mesa가 필요합니다. 렌더링은 지도 자산을 온라인으로 가져옵니다.
플랫폼
로컬 렌더링은 Apple silicon Mac, Windows x64, Linux x86-64 또는 arm64를 지원합니다. Intel Mac은 로컬 렌더링을 할 수 없으며 지원되지 않는 컴퓨터에서는 MCP가 서버 측 대체 처리를 제안할 수 있습니다.
라이선스
오픈 소스가 아닌 제한적 사용 라이선스입니다. 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 계정으로 로그인하세요. 무료 계정도 프로젝트를 작성할 수 있지만 렌더링에는 프리미엄 이용 권한과 크레딧이 필요합니다.
렌더링은 어디서 이루어지나요?
지원 컴퓨터에서는 로컬에서 렌더링하며 지도 자산을 온라인으로 가져옵니다. 로컬 렌더링이 지원되지 않으면 MCP가 서버 측 대체 처리를 제안할 수 있습니다.
pip에서 일치하는 버전을 찾을 수 없다고 하는 이유는 무엇인가요?
Python 3.12 이상을 사용하고 PyPI의 최신 설치 지침을 확인하세요. 안정 버전에는 --pre가 필요하지 않습니다.
오픈 소스인가요?
아니요. travel-animator는 제한적 사용 라이선스로 배포됩니다. Travel Animator 콘텐츠를 준비하고 렌더링하기 위해 수정 없이 설치하고 실행할 수 있지만, 재배포하거나 수정하거나 경쟁 서비스 제작에 사용할 수는 없습니다. 전체 약관은 패키지에 포함되어 있으며, 함께 제공되는 글꼴과 국기 이미지는 각각의 OFL 및 MIT 라이선스를 따릅니다.
하드웨어 인코딩을 사용할 수 있나요?
네. 기본 인코더는 모든 환경에서 작동하는 libx264입니다. NVIDIA 하드웨어 인코딩을 사용하려면 render-bundle에 --encoder h264_nvenc를 전달하세요.
MCP 서버는 어떤 데이터를 수집하나요?
MCP 분석은 선택 사항이지만 기본적으로 켜져 있습니다. 끄려면 travel-animator analytics off를 실행하세요. 이벤트에는 도구 사용과 렌더링 설정이 포함되며 없는 도구에 대한 요청에는 작업 텍스트가 포함될 수 있습니다. 전체 데이터 범위는 PyPI의 분석 섹션을 읽어보세요.
지시문보다 화면 터치가 편하신가요?
Travel Animator는 모바일 앱에서 시작했습니다. 터미널 없이 iOS와 Android에서 같은 경로 애니메이션을 직접 만들어 보세요.
앱 다운로드
