Planejar a rota
Diga quais são suas paradas, em qualquer ordem, e deixe o assistente montar a viagem — de cidade em cidade, de trilha em trilha.
Visão geral
O que é o servidor MCP do Travel Animator?
O servidor MCP do Travel Animator é um pacote Python — travel-animator no PyPI — que disponibiliza todo o processo de criação de vídeos de rotas do Travel Animator para assistentes de IA por meio do Model Context Protocol. Instale o pacote e faça login uma vez. Depois, um assistente como Claude ou Cursor poderá planejar uma rota, personalizar a animação e renderizar um MP4 no seu computador, seguindo apenas o que você escrever na conversa.
MCP é um padrão aberto que conecta assistentes a ferramentas externas. Seu cliente inicia o servidor com travel-animator mcp, identifica as ferramentas disponíveis e as chama durante a conversa. Assim, você não precisa aprender a usar outro aplicativo nem configurar chaves de API: basta entrar na sua conta do Travel Animator.
Ele renderiza as mesmas viagens do aplicativo móvel, usando a mesma conta: as rotas animadas, os modelos de veículos 3D e os estilos de mapa que definem o Travel Animator. Se preferir criar os vídeos manualmente, os aplicativos para iOS e Android oferecem as mesmas possibilidades sem terminal. Adicionar paradas, escolher um veículo e exportar é um processo de quatro passos no celular.
O que seu assistente pode fazer
Um servidor para todo o processo
O servidor MCP disponibiliza ferramentas para todas as etapas do processo. Assim, um assistente pode transformar uma frase em um vídeo pronto sem que você precise abrir um editor.
Ajustar a animação
Altere a aparência e o movimento da animação — veículo, estilo da rota e ritmo — pedindo as mudanças com suas próprias palavras.
Renderizar o vídeo
Exporte um MP4 usando seu próprio hardware. libx264 funciona em todas as plataformas; use h264_nvenc para codificação NVIDIA.
Instalação
Pronto em três passos
Cerca de dois minutos, desde que Python 3.12 ou uma versão mais recente já esteja instalado no seu computador.
- 1
Instale o pacote com o extra
mcpO extra adiciona o SDK do MCP, que fica intencionalmente de fora da instalação básica. O pacote ainda está em beta, então
--preé necessário até o lançamento da primeira versão estável.Terminalpip install --pre "travel-animator[mcp]" - 2
Entre na sua conta do Travel Animator
Use a mesma conta do aplicativo móvel. Em um terminal interativo, o login usa um link mágico: digite seu e-mail e depois o código de 6 dígitos. Para CI, forneça um token bearer em vez disso. As credenciais são armazenadas em
~/.config/tada/credentials.jsoncom as permissões0600.Terminaltravel-animator login - 3
Conecte seu cliente de IA ao servidor
Adicione o servidor à configuração MCP do seu cliente e reinicie o cliente. Depois, basta pedir um vídeo. O assistente pode chamar
auth_statuspara confirmar que você está conectado antes de começar a montar a viagem.Configuração do cliente MCP{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
Compatível com
- Claude Desktop
- Claude Code
- Cursor
- Qualquer cliente MCP que use stdio
Experimente
O que pedir depois de conectar
Sem comandos para memorizar: descreva a viagem e o visual desejado como explicaria a outra pessoa.
- Anime minha viagem Tóquio → Quioto → Osaka como uma rota de avião e renderize em 1080p.
- Planeje uma rota de viagem de carro de Dubai a Mascate e dê a ela um visual cinematográfico.
- Renderize novamente o último vídeo com um ritmo mais lento e outro veículo.
- Confira se estou conectado e depois renderize o bundle que você preparou antes.
Linha de comando
A CLI do travel-animator
O servidor MCP é um subcomando de um pequeno script de console que você também pode usar diretamente.
travel-animator loginFaça login por link mágico ou armazene um token bearer para uso não interativo.
travel-animator logoutRemova as credenciais armazenadas localmente. A ação é apenas local: ainda não há revogação de sessões no servidor.
travel-animator render-bundleRenderize um bundle preparado em MP4 sem acesso à rede. Execute com --help para consultar todas as opções disponíveis.
travel-animator mcpExecute o servidor MCP stdio. Requer o extra mcp.
Antes de começar
Requisitos e informações úteis
Gráficos e vídeo
A renderização exige uma implementação de OpenGL — um driver de GPU em produção ou Mesa/llvmpipe no Linux com processamento apenas por CPU — e as bibliotecas de execução habituais do FFmpeg/PyAV.
Plataformas
Linux, macOS e Windows são compatíveis. No Windows, o contexto GL é criado pelo WGL, que exige uma sessão de desktop interativa. Um serviço não consegue criar esse contexto, e não há alternativa de renderização por software.
Licença
É uma licença de uso limitado, não de código aberto: você pode instalar e executar o pacote sem modificações para preparar e renderizar conteúdo do Travel Animator. Redistribuição, modificações e serviços concorrentes não são permitidos. Entre em contato com a Lascade para obter direitos adicionais.
Perguntas frequentes
Respostas às suas dúvidas
O que é o Model Context Protocol?
MCP é um padrão aberto que conecta assistentes de IA a ferramentas e dados externos. Um cliente — Claude Desktop, Claude Code ou Cursor — inicia um servidor MCP, identifica as ferramentas disponíveis e pode chamá-las em seu nome durante uma conversa. travel-animator inclui um servidor desse tipo, permitindo que um assistente controle diretamente o processo de criação de vídeos de rotas.
Quais assistentes de IA podem usá-lo?
Qualquer cliente que ofereça suporte a MCP por stdio, incluindo Claude Desktop, Claude Code e Cursor. Todos usam o mesmo bloco de configuração JSON, que aponta para o comando travel-animator com o argumento mcp.
Preciso de uma conta do Travel Animator?
Sim. O pacote complementa o serviço Travel Animator, então execute travel-animator login primeiro. Ele usa o mesmo sistema de contas do aplicativo móvel. Se você não estiver conectado, as ferramentas que exigem credenciais falham com uma mensagem clara pedindo que faça login.
Onde a renderização acontece?
No seu próprio computador. A renderização usa sua implementação local de OpenGL e as bibliotecas FFmpeg. O comando render-bundle renderiza um bundle preparado sem nenhum acesso à rede.
Por que o pip diz que não encontra uma versão compatível?
O pacote ainda está em beta, e o pip ignora versões de pré-lançamento por padrão. Instale com a opção --pre: pip install --pre "travel-animator[mcp]".
É de código aberto?
Não. travel-animator é publicado sob uma licença de uso limitado: você pode instalá-lo e executá-lo sem modificações para preparar e renderizar conteúdo do Travel Animator, mas não pode redistribuí-lo, modificá-lo nem usá-lo para criar um serviço concorrente. Os termos completos acompanham o pacote, e as fontes e ilustrações de bandeiras incluídas continuam sob suas próprias licenças OFL e MIT.
Posso usar codificação por hardware?
Sim. O codificador padrão é libx264, que funciona em todas as plataformas. Passe --encoder h264_nvenc para render-bundle para usar a codificação por hardware da NVIDIA.
Quais dados o servidor MCP coleta?
Projetos, rotas e vídeos renderizados são gravados no seu computador e nunca são enviados, a menos que você salve explicitamente uma rota na sua conta. As análises são opcionais e ficam desativadas por padrão: nada é coletado até você executar travel-animator analytics on, e travel-animator analytics off revoga o consentimento. Com sua autorização, os eventos registram quais ferramentas foram executadas, em que ordem, quanto tempo levaram e se falharam, além das configurações de renderização e do número de pontos de uma rota. Nunca incluem coordenadas, nomes de lugares, caminhos de arquivos, suas mídias nem os resultados retornados por uma ferramenta. A política de privacidade em https://www.travelanimator.com/privacy-policy traz todos os detalhes.
Prefere tocar na tela a escrever instruções?
O Travel Animator é, antes de tudo, um aplicativo móvel: crie as mesmas rotas animadas manualmente no iOS e no Android, sem precisar de um terminal.
Baixar o aplicativo
