Planificar la ruta
Indica tus paradas en cualquier orden y deja que el asistente organice el viaje, de ciudad en ciudad o de sendero en sendero.
Descripción general
¿Qué es el servidor MCP de Travel Animator?
El servidor MCP de Travel Animator es un paquete de Python — travel-animator en PyPI — que permite a los asistentes de IA acceder a todo el proceso de creación de vídeos de rutas de Travel Animator mediante Model Context Protocol. Instálalo e inicia sesión una vez: un asistente como Claude o Cursor podrá planificar una ruta, personalizar la animación y renderizar un MP4 en tu ordenador, guiándose únicamente por lo que escribas en el chat.
MCP es un estándar abierto que conecta asistentes con herramientas externas. Tu cliente inicia el servidor con travel-animator mcp, descubre las herramientas disponibles y las invoca durante la conversación. Así, no tienes que aprender a usar otra aplicación ni configurar claves API: basta con iniciar sesión en Travel Animator.
Renderiza los mismos viajes que la aplicación móvil y con la misma cuenta: las rutas animadas, los modelos de vehículos 3D y los estilos de mapa que definen Travel Animator. Si prefieres crear los vídeos a mano, las aplicaciones para iOS y Android ofrecen las mismas posibilidades sin terminal. Añadir paradas, elegir un vehículo y exportar se hace en cuatro pasos desde el móvil.
Elige tu forma de trabajar
¿Quién debería usar MCP en lugar de la aplicación móvil?
Elige MCP si ya trabajas con un asistente de IA y quieres describir rutas, solicitar cambios de estilo y crear vídeos desde tu ordenador. Debes sentirte cómodo instalando paquetes Python y configurando las herramientas de tu asistente.
Elige la aplicación móvil si prefieres recorrer y previsualizar la ruta tú mismo con la pantalla táctil. Para una película más larga con grabaciones y narración, usa el clip del mapa exportado en un editor de vídeo.
Antes de decidirte: confirma que tu ordenador puede renderizar, comprueba tu cuenta y saldo de créditos y prueba una ruta corta. Revisa las paradas y el estilo antes de autorizar un renderizado. El comando render-bundle de la CLI necesita un paquete preparado; usa MCP para crear un proyecto a partir de una descripción.
Costes de renderizado: se requieren una cuenta premium y créditos. Cada vídeo cuesta un crédito. El crédito puede consumirse aunque falle el renderizado local después de la preparación.
Revisa los requisitos publicados del paquete y las reglas de créditos antes de renderizar. La comparativa móvil de Free y Pro describe la aplicación; no representa una asignación de créditos MCP.
Lo que puede hacer tu asistente
Un servidor para todo el proceso
El servidor MCP ofrece herramientas para cada fase del proceso, de modo que un asistente puede pasar de una frase a un vídeo terminado sin que tengas que abrir un editor.
Ajustar la animación
Modifica el aspecto y el movimiento de la animación — el vehículo, el estilo de la ruta y el ritmo — pidiendo los cambios con tus propias palabras.
Renderizar el vídeo
Exporta un MP4 en tu propio equipo. libx264 funciona en todas las plataformas; utiliza h264_nvenc para la codificación con NVIDIA.
Instalación
Listo en tres pasos
Instala Python 3.12 o posterior antes de empezar. El tiempo de configuración depende de tu ordenador y del cliente MCP.
- 1
Instala el paquete con el extra
mcpInstala el complemento
mcppara incluir el SDK de MCP. Las versiones estables ya no necesitan la opción de versión preliminar.Terminalpip install "travel-animator[mcp]" - 2
Inicia sesión en tu cuenta de Travel Animator
Usa la misma cuenta que en la aplicación móvil. En un terminal interactivo, el inicio de sesión se realiza mediante un enlace mágico: introduce tu correo electrónico y después el código de 6 dígitos. Para CI, proporciona un token bearer en su lugar. Las credenciales se guardan en
~/.config/tada/credentials.jsoncon permisos0600.Terminaltravel-animator login - 3
Conecta tu cliente de IA al servidor
Añade el servidor a la configuración MCP de tu cliente y reinícialo. Después, solo tienes que pedir un vídeo. El asistente puede invocar
auth_statuspara comprobar que has iniciado sesión antes de empezar a crear el viaje.Configuración del cliente MCP{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
Compatible con
- Claude Desktop
- Claude Code
- Cursor
- Cualquier cliente MCP que use stdio
Pruébalo
Qué pedir una vez conectado
No tienes que memorizar comandos: describe el viaje y el estilo que quieres como se lo contarías a otra persona.
- Anima mi viaje Tokio → Kioto → Osaka como una ruta en avión y renderízalo en 1080p.
- Planifica una ruta por carretera de Dubái a Mascate y dale un estilo cinematográfico.
- Vuelve a renderizar el último vídeo con un ritmo más lento y otro vehículo.
- Comprueba si he iniciado sesión y luego renderiza el paquete que preparaste antes.
Línea de comandos
La CLI de travel-animator
El servidor MCP es un subcomando de un pequeño script de consola que también puedes utilizar directamente.
travel-animator loginInicia sesión mediante un enlace mágico o guarda un token bearer para uso no interactivo.
travel-animator logoutElimina las credenciales guardadas localmente. Solo afecta al equipo local: todavía no se pueden revocar sesiones en el servidor.
travel-animator render-bundleRenderiza un paquete preparado a MP4. Los recursos del mapa requieren conexión a Internet. Ejecuta con --help para consultar todas las opciones.
travel-animator mcpEjecuta el servidor MCP stdio. Requiere el extra mcp.
Antes de empezar
Requisitos e información útil
Gráficos y vídeo
Los paquetes wheel de plataforma incluyen Java y, en macOS y Windows, controladores gráficos. Linux necesita un controlador GLES del sistema o Mesa. El renderizado obtiene recursos de mapas en línea.
Plataformas
El renderizado local admite Mac con Apple silicon, Windows x64 y Linux x86-64 o arm64. Los Mac Intel no pueden renderizar localmente; MCP puede ofrecer una alternativa en el servidor en equipos no compatibles.
Licencia
Se trata de una licencia de uso limitado, no de código abierto: puedes instalar y ejecutar el paquete sin modificaciones para preparar y renderizar contenido de Travel Animator. No se permiten la redistribución, las modificaciones ni los servicios competidores. Contacta con Lascade para obtener derechos adicionales.
Preguntas frecuentes
Respuestas a tus preguntas
¿Qué es Model Context Protocol?
MCP es un estándar abierto que conecta asistentes de IA con herramientas y datos externos. Un cliente — Claude Desktop, Claude Code o Cursor — inicia un servidor MCP, descubre las herramientas que ofrece y puede invocarlas en tu nombre durante una conversación. travel-animator incluye uno de estos servidores, de modo que un asistente puede controlar directamente el proceso de creación de vídeos de rutas.
¿Qué asistentes de IA pueden usarlo?
Cualquier cliente que admita MCP mediante stdio, incluidos Claude Desktop, Claude Code y Cursor. Todos usan el mismo bloque de configuración JSON, que apunta al comando travel-animator con el argumento mcp.
¿Necesito una cuenta de Travel Animator?
Sí. Inicia sesión con tu cuenta de Travel Animator. Las cuentas gratuitas pueden crear proyectos, pero el renderizado requiere acceso premium y créditos.
¿Dónde se realiza el renderizado?
En ordenadores compatibles, el renderizado se ejecuta localmente y obtiene los recursos de mapas en línea. MCP puede ofrecer una alternativa en el servidor cuando no se admite el renderizado local.
¿Por qué pip indica que no encuentra una versión compatible?
Usa Python 3.12 o posterior y consulta las instrucciones de instalación actuales en PyPI. Las versiones estables no requieren --pre.
¿Es de código abierto?
No. travel-animator se publica con una licencia de uso limitado: puedes instalarlo y ejecutarlo sin modificaciones para preparar y renderizar contenido de Travel Animator, pero no redistribuirlo, modificarlo ni crear con él un servicio competidor. Los términos completos se incluyen en el paquete, y las fuentes e ilustraciones de banderas incluidas conservan sus respectivas licencias OFL y MIT.
¿Puedo usar codificación por hardware?
Sí. El codificador predeterminado es libx264, que funciona en todas las plataformas. Pasa --encoder h264_nvenc a render-bundle para utilizar la codificación por hardware de NVIDIA.
¿Qué datos recopila el servidor MCP?
La analítica de MCP es opcional, pero está activada de forma predeterminada. Ejecuta travel-animator analytics off para desactivarla. Los eventos incluyen uso de herramientas y ajustes de renderizado; las solicitudes de herramientas que faltan pueden incluir el texto de la tarea. Lee la sección de analítica de PyPI para conocer todo el alcance de los datos.
¿Prefieres tocar la pantalla a escribir instrucciones?
Travel Animator es, ante todo, una aplicación móvil: crea las mismas rutas animadas a mano en iOS y Android, sin necesidad de un terminal.
Descargar la aplicación
