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.
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
Unos dos minutos, siempre que ya tengas Python 3.12 o una versión posterior instalado en tu ordenador.
- 1
Instala el paquete con el extra
mcpEl extra añade el SDK de MCP, que se omite deliberadamente en la instalación básica. El paquete sigue en fase beta, así que necesitas
--prehasta que se publique la primera versión estable.Terminalpip install --pre "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 en MP4 sin acceso a la red. Ejecuta el comando 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
El renderizado requiere una implementación de OpenGL — un controlador de GPU en producción o Mesa/llvmpipe para Linux con procesamiento solo por CPU —, además de las bibliotecas de ejecución habituales de FFmpeg/PyAV.
Plataformas
Es compatible con Linux, macOS y Windows. En Windows, el contexto GL se crea mediante WGL, que requiere una sesión de escritorio interactiva. Un servicio no puede crear ese contexto y no hay una alternativa de renderizado por software.
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í. El paquete complementa el servicio Travel Animator, así que primero debes ejecutar travel-animator login. Usa el mismo sistema de cuentas que la aplicación móvil. Si no has iniciado sesión, las herramientas que necesitan credenciales fallan con un mensaje claro que te pide hacerlo.
¿Dónde se realiza el renderizado?
En tu ordenador. El renderizado utiliza tu implementación local de OpenGL y las bibliotecas FFmpeg. El comando render-bundle renderiza un paquete preparado sin ningún acceso a la red.
¿Por qué pip indica que no encuentra una versión compatible?
El paquete sigue en fase beta y pip omite las versiones preliminares de forma predeterminada. Instálalo con la opción --pre: pip install --pre "travel-animator[mcp]".
¿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?
Los proyectos, las rutas y los vídeos renderizados se guardan en tu ordenador y nunca se suben, salvo que guardes expresamente una ruta en tu cuenta. Los análisis son opcionales y están desactivados de forma predeterminada: no se recopila nada hasta que ejecutes travel-animator analytics on, y travel-animator analytics off revoca el consentimiento. Con tu permiso, los eventos registran qué herramientas se ejecutaron, en qué orden, cuánto tardaron y si fallaron, además de la configuración de renderizado y el número de puntos de una ruta. Nunca incluyen coordenadas, nombres de lugares, rutas de archivos, tus archivos multimedia ni los resultados devueltos por una herramienta. La política de privacidad en https://www.travelanimator.com/privacy-policy contiene todos los detalles.
¿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
