Pianifica il percorso
Elenca le tappe in qualsiasi ordine e lascia che l’assistente organizzi il viaggio, da una città all’altra, da un sentiero all’altro.
Panoramica
Che cos’è il server MCP di Travel Animator?
Il server MCP di Travel Animator è un pacchetto Python — travel-animator su PyPI — che rende l’intero processo di creazione dei video di percorso accessibile agli assistenti IA tramite il Model Context Protocol. Installalo e accedi una volta: un assistente come Claude o Cursor potrà pianificare un percorso, personalizzare l’animazione e renderizzare un MP4 sul tuo computer, basandosi esclusivamente su ciò che scrivi in chat.
MCP è uno standard aperto che collega gli assistenti a strumenti esterni. Il client avvia il server con travel-animator mcp, individua gli strumenti disponibili e li richiama durante la conversazione. Non devi quindi imparare a usare un’app separata né configurare chiavi API: basta accedere a Travel Animator.
Renderizza gli stessi viaggi dell’app mobile, con lo stesso account: i percorsi animati, i modelli di veicoli 3D e gli stili di mappa alla base di Travel Animator. Se preferisci creare i video a mano, le app per iOS e Android offrono le stesse possibilità senza terminale. Aggiungere tappe, scegliere un veicolo ed esportare richiede quattro passaggi sul telefono.
Scegli come lavorare
A chi conviene MCP invece dell’app mobile?
Scegli MCP se lavori già con un assistente IA e vuoi descrivere percorsi, richiedere modifiche allo stile e creare video dal computer. Devi avere familiarità con l’installazione di pacchetti Python e la configurazione degli strumenti dell’assistente.
Scegli l’app mobile se preferisci interagire direttamente con il percorso e l’anteprima sullo schermo. Per un filmato più lungo con riprese e narrazione, usa la clip della mappa esportata in un editor video.
Prima di decidere: verifica che il computer possa eseguire il rendering, controlla account e saldo crediti e prova un percorso breve. Controlla tappe e stile prima di autorizzare il rendering. Il comando CLI render-bundle richiede un bundle preparato; usa MCP per creare un progetto da una descrizione.
Costi di rendering: servono un account premium e crediti. Ogni video costa un credito. Il credito può comunque essere consumato se il rendering locale fallisce dopo la preparazione.
Consulta i requisiti pubblicati del pacchetto e le regole sui crediti prima del rendering. Il confronto mobile tra Free e Pro descrive l’app; non rappresenta una dotazione di crediti MCP.
Cosa può fare il tuo assistente
Un server per l’intero lavoro
Il server MCP offre strumenti per l’intero processo, così un assistente può trasformare una frase in un video finito senza farti aprire un editor.
Regola l’animazione
Modifica l’aspetto e il movimento dell’animazione — veicolo, stile del percorso, ritmo — chiedendo i cambiamenti con parole tue.
Renderizza il video
Esporta un MP4 sul tuo hardware. libx264 funziona ovunque; usa h264_nvenc per la codifica NVIDIA.
Installazione
Operativo in tre passaggi
Installa Python 3.12 o successivo prima di iniziare. Il tempo di configurazione dipende da computer e client MCP.
- 1
Installa il pacchetto con l’extra
mcpInstalla il componente aggiuntivo
mcpper includere l’SDK MCP. Le versioni stabili non richiedono più l’opzione per le versioni preliminari.Terminalepip install "travel-animator[mcp]" - 2
Accedi al tuo account Travel Animator
Usa lo stesso account dell’app mobile. In un terminale interattivo l’accesso avviene tramite magic link: inserisci l’email e poi il codice a 6 cifre. Per la CI, passa invece un token bearer. Le credenziali sono salvate in
~/.config/tada/credentials.jsoncon permessi0600.Terminaletravel-animator login - 3
Collega il client IA al server
Aggiungi il server alla configurazione MCP del client e riavvia il client. Poi chiedi semplicemente un video: l’assistente può richiamare
auth_statusper verificare l’accesso prima di creare il viaggio.Configurazione client MCP{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
Compatibile con
- Claude Desktop
- Claude Code
- Cursor
- Qualsiasi client MCP su stdio
Provalo
Cosa chiedere dopo la connessione
Nessun comando da memorizzare: descrivi il viaggio e lo stile desiderato come faresti con una persona.
- Anima il mio viaggio Tokyo → Kyoto → Osaka come un percorso in aereo e renderizzalo in 1080p.
- Pianifica un viaggio in auto da Dubai a Mascate e dagli un look cinematografico.
- Renderizza di nuovo l’ultimo video con un ritmo più lento e un veicolo diverso.
- Controlla se ho effettuato l’accesso, poi renderizza il bundle preparato prima.
Riga di comando
La CLI di travel-animator
Il server MCP è un sottocomando di un piccolo script da console che puoi anche usare direttamente.
travel-animator loginAccedi tramite magic link o salva un token bearer per l’uso non interattivo.
travel-animator logoutRimuovi le credenziali salvate localmente. Vale solo sul computer: la revoca delle sessioni lato server non è ancora disponibile.
travel-animator render-bundleRenderizza un pacchetto preparato in MP4. Le risorse delle mappe richiedono Internet. Usa --help per l’elenco completo delle opzioni.
travel-animator mcpAvvia il server MCP stdio. Richiede l’extra mcp.
Prima di iniziare
Requisiti e informazioni utili
Grafica e video
I pacchetti wheel di piattaforma includono Java e, su macOS e Windows, i driver grafici. Linux richiede un driver GLES di sistema o Mesa. Il rendering recupera le risorse delle mappe online.
Piattaforme
Il rendering locale supporta Mac con Apple silicon, Windows x64 e Linux x86-64 o arm64. I Mac Intel non possono renderizzare localmente; MCP può offrire un’alternativa lato server sui computer non supportati.
Licenza
È una licenza d’uso limitato, non open source: puoi installare ed eseguire il pacchetto senza modificarlo per preparare e renderizzare contenuti Travel Animator. Non sono consentiti ridistribuzione, modifiche o servizi concorrenti. Contatta Lascade per ottenere ulteriori diritti.
Domande frequenti
Le risposte alle tue domande
Che cos’è il Model Context Protocol?
MCP è uno standard aperto che collega gli assistenti IA a strumenti e dati esterni. Un client — Claude Desktop, Claude Code o Cursor — avvia un server MCP, individua gli strumenti offerti e può richiamarli per conto tuo durante una conversazione. travel-animator include un server di questo tipo, così l’assistente può gestire direttamente il processo di creazione dei video di percorso.
Quali assistenti IA possono usarlo?
Qualsiasi client che supporti MCP su stdio, inclusi Claude Desktop, Claude Code e Cursor. Tutti usano lo stesso blocco di configurazione JSON, che punta al comando travel-animator con l’argomento mcp.
Serve un account Travel Animator?
Sì. Accedi con il tuo account Travel Animator. Gli account gratuiti possono creare progetti, ma il rendering richiede accesso premium e crediti.
Dove avviene il rendering?
Sui computer supportati, il rendering avviene localmente e recupera le risorse delle mappe online. MCP può offrire un’alternativa lato server quando il rendering locale non è supportato.
Perché pip dice che non trova una versione compatibile?
Usa Python 3.12 o successivo e controlla le istruzioni di installazione attuali su PyPI. Le versioni stabili non richiedono --pre.
È open source?
No. travel-animator è pubblicato con una licenza d’uso limitato: puoi installarlo ed eseguirlo senza modifiche per preparare e renderizzare contenuti Travel Animator, ma non ridistribuirlo, modificarlo o usarlo per creare un servizio concorrente. Le condizioni complete sono incluse nel pacchetto. I caratteri e le illustrazioni delle bandiere mantengono le rispettive licenze OFL e MIT.
Posso usare la codifica hardware?
Sì. Il codificatore predefinito è libx264, che funziona ovunque. Passa --encoder h264_nvenc a render-bundle per la codifica hardware NVIDIA.
Quali dati raccoglie il server MCP?
Le analisi MCP sono facoltative ma attive per impostazione predefinita. Esegui travel-animator analytics off per disattivarle. Gli eventi includono uso degli strumenti e impostazioni di rendering; le richieste di strumenti mancanti possono includere il testo dell’attività. Consulta la sezione sulle analisi di PyPI per l’intero ambito dei dati.
Preferisci toccare lo schermo anziché scrivere istruzioni?
Travel Animator nasce come app mobile: crea a mano gli stessi percorsi animati su iOS e Android, senza terminale.
Scarica l’app
