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.
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
Circa due minuti, se sul computer è già installato Python 3.12 o successivo.
- 1
Installa il pacchetto con l’extra
mcpL’extra aggiunge l’SDK MCP, escluso intenzionalmente dall’installazione di base. Il pacchetto è ancora in beta, quindi serve
--prefino alla prima versione stabile.Terminalepip install --pre "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 bundle preparato in MP4 senza accesso alla rete. Usa --help per consultare tutte le opzioni.
travel-animator mcpAvvia il server MCP stdio. Richiede l’extra mcp.
Prima di iniziare
Requisiti e informazioni utili
Grafica e video
Il rendering richiede un’implementazione OpenGL — un driver GPU in produzione o Mesa/llvmpipe su Linux con sola CPU — più le consuete librerie runtime di FFmpeg/PyAV.
Piattaforme
Sono supportati Linux, macOS e Windows. Su Windows il contesto GL viene creato da WGL, che richiede una sessione desktop interattiva. Un servizio non può crearlo e non è disponibile un’alternativa di rendering software.
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ì. Il pacchetto affianca il servizio Travel Animator, quindi esegui prima travel-animator login. Usa lo stesso sistema di account dell’app mobile. Senza accesso, gli strumenti che richiedono credenziali si interrompono con un messaggio chiaro che invita ad accedere.
Dove avviene il rendering?
Sul tuo computer. Il rendering usa l’implementazione OpenGL locale e le librerie FFmpeg. render-bundle renderizza un bundle preparato senza alcun accesso alla rete.
Perché pip dice che non trova una versione compatibile?
Il pacchetto è ancora in beta e pip ignora le versioni preliminari per impostazione predefinita. Installalo con l’opzione --pre: pip install --pre "travel-animator[mcp]".
È 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?
Progetti, percorsi e video renderizzati sono salvati sul tuo computer e non vengono mai caricati, a meno che tu non salvi esplicitamente un percorso nel tuo account. Le analisi sono facoltative e disattivate per impostazione predefinita: non viene raccolto nulla finché non esegui travel-animator analytics on; travel-animator analytics off revoca il consenso. Con il tuo consenso, gli eventi registrano quali strumenti sono stati eseguiti, in quale ordine, quanto tempo hanno richiesto e se sono falliti, oltre alle impostazioni di rendering e al numero di punti del percorso. Non includono mai coordinate, nomi di luoghi, percorsi di file, i tuoi contenuti multimediali o i risultati restituiti da uno strumento. Tutti i dettagli sono nell’informativa sulla privacy su https://www.travelanimator.com/privacy-policy.
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
