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.
Escolha a sua forma de trabalhar
Quem deve usar MCP em vez da aplicação móvel?
Escolha MCP se já trabalha com um assistente de IA e quer descrever percursos, pedir alterações de estilo e criar vídeos no computador. Deve estar à vontade com a instalação de pacotes Python e a configuração das ferramentas do assistente.
Escolha a aplicação móvel se prefere explorar diretamente o percurso e a pré-visualização no ecrã. Para um filme mais longo com filmagens e narração, use o clip do mapa exportado num editor de vídeo.
Antes de decidir: confirme que o computador consegue renderizar, verifique a conta e o saldo de créditos e experimente um percurso curto. Reveja as paragens e o estilo antes de autorizar uma renderização. O comando CLI render-bundle precisa de um bundle preparado; use MCP para criar um projeto a partir de uma descrição.
Custos de renderização: são necessários uma conta premium e créditos. Cada vídeo custa um crédito. O crédito pode ser consumido mesmo que a renderização local falhe após a preparação.
Consulte os requisitos publicados do pacote e as regras de créditos antes de renderizar. A comparação móvel de Free e Pro descreve a aplicação; não representa uma atribuição de créditos MCP.
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
Instale Python 3.12 ou posterior antes de começar. O tempo de configuração depende do computador e do cliente MCP.
- 1
Instale o pacote com o extra
mcpInstale o extra
mcppara incluir o SDK MCP. As versões estáveis já não precisam da opção de pré-lançamento.Terminalpip install "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 pacote preparado em MP4. Os recursos dos mapas exigem ligação à Internet. Execute com --help para consultar todas as opções.
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
Os pacotes wheel de plataforma incluem Java e, em macOS e Windows, controladores gráficos. Linux precisa de um controlador GLES do sistema ou Mesa. A renderização obtém os recursos dos mapas online.
Plataformas
A renderização local suporta Macs com Apple silicon, Windows x64 e Linux x86-64 ou arm64. Macs Intel não podem renderizar localmente; MCP pode oferecer uma alternativa no servidor em máquinas não suportadas.
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. Inicie sessão com a conta Travel Animator. Contas gratuitas podem criar projetos, mas a renderização exige acesso premium e créditos.
Onde a renderização acontece?
Em computadores suportados, a renderização decorre localmente e obtém os recursos dos mapas online. MCP pode oferecer uma alternativa no servidor quando a renderização local não é suportada.
Por que o pip diz que não encontra uma versão compatível?
Use Python 3.12 ou posterior e confirme as instruções de instalação atuais no PyPI. As versões estáveis não exigem --pre.
É 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?
A análise MCP é opcional, mas está ativada por predefinição. Execute travel-animator analytics off para a desativar. Os eventos incluem utilização de ferramentas e definições de renderização; pedidos de ferramentas em falta podem incluir texto da tarefa. Leia a secção de análise no PyPI para conhecer todo o âmbito dos dados.
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
