Elérhető a PyPI-on · v0.2.0a4 béta

Travel Animator MCP: bízd bármelyik AI-ra az utazási videóid renderelését

A travel-animator MCP-szervert is tartalmaz. Csatlakoztasd a Claude-hoz, a Cursorhoz vagy bármely MCP-kompatibilis asszisztenshez, és írd le az utazást hétköznapi szavakkal. Az AI megtervezi az útvonalat, beállítja az animációt, és elkészíti az MP4-et a saját gépeden.

Terminál
pip install --pre "travel-animator[mcp]"
  • Python 3.12+
  • macOS · Windows · Linux
  • stdio MCP
  • Helyi renderelés
Valódi kimenet az MCP-szerverről, utólagos szerkesztés nélkül.

Áttekintés

Mi a Travel Animator MCP-szerver?

A Travel Animator MCP-szerver egy Python-csomag — a PyPI-on elérhető travel-animator —, amely a Model Context Protocol segítségével hozzáférést ad az AI-asszisztenseknek az útvonalvideók teljes készítési folyamatához. Telepítsd, és jelentkezz be egyszer. Ezután egy asszisztens, például a Claude vagy a Cursor megtervezheti az útvonalat, kialakíthatja az animáció stílusát és MP4-et renderelhet a gépeden, kizárólag a csevegésbe írt utasításaid alapján.

Az MCP nyílt szabvány, amely külső eszközökhöz kapcsolja az asszisztenseket. A kliens a travel-animator mcp paranccsal indítja a szervert, felderíti az elérhető eszközöket, és a beszélgetés során meghívja őket. Nem kell tehát külön alkalmazást megtanulnod vagy API-kulcsokat beállítanod; elég bejelentkezni a Travel Animatorba.

Ugyanazzal a fiókkal ugyanazokat az utazásokat rendereli, mint a mobilalkalmazás: az animált útvonalakat, a 3D-s járműmodelleket és a térképstílusokat, amelyekre a Travel Animator épül. Ha inkább kézzel készítenél videókat, az iOS- és Android-alkalmazások terminál nélkül kínálják ugyanezeket a lehetőségeket. A megállók hozzáadása, a jármű kiválasztása és az exportálás négy lépés a telefonon.

Mire képes az asszisztensed?

Egy szerver az egész folyamathoz

Az MCP-szerver a teljes folyamathoz eszközöket biztosít. Az asszisztens így egy mondatból kész videót alkothat anélkül, hogy szerkesztőt nyitnál.

Útvonaltervezés

Sorold fel a megállókat tetszőleges sorrendben, és hagyd, hogy az asszisztens összeállítsa az utazást, városról városra, ösvényről ösvényre.

Az animáció finomhangolása

Módosítsd az animáció megjelenését és mozgását — a járművet, az útvonal stílusát és a tempót — hétköznapi szavakkal megfogalmazott kérésekkel.

Videó renderelése

Exportálj MP4-et a saját hardvereden. A libx264 mindenhol működik; NVIDIA-kódoláshoz add meg a h264_nvenc értéket.

Telepítés

Három lépés, és indulhat

Körülbelül két perc, ha a Python 3.12 vagy újabb már telepítve van a gépeden.

  1. 1

    Telepítsd a csomagot az mcp kiegészítővel

    A kiegészítő hozzáadja az MCP SDK-t, amely szándékosan nem része az alaptelepítésnek. A csomag még béta állapotú, ezért az első stabil kiadásig szükséges a --pre kapcsoló.

    Terminál
    pip install --pre "travel-animator[mcp]"
  2. 2

    Jelentkezz be a Travel Animator-fiókodba

    Használd ugyanazt a fiókot, mint a mobilalkalmazásban. Interaktív terminálban a bejelentkezés belépési hivatkozattal történik: add meg az e-mail-címedet, majd a hatjegyű kódot. CI esetén helyette bearer tokent adj át. A hitelesítési adatok a ~/.config/tada/credentials.json fájlban, 0600 jogosultsággal tárolódnak.

    Terminál
    travel-animator login
  3. 3

    Kapcsold az AI-klienst a szerverhez

    Add hozzá a szervert a kliens MCP-konfigurációjához, majd indítsd újra a klienst. Ezután csak kérj egy videót. Az asszisztens az utazás összeállítása előtt az auth_status meghívásával ellenőrizheti, hogy be vagy-e jelentkezve.

    MCP-kliens konfigurációja
    {
      "mcpServers": {
        "travel-animator-mcp": {
          "command": "travel-animator",
          "args": ["mcp"]
        }
      }
    }
Kompatibilis kliensek
  • Claude Desktop
  • Claude Code
  • Cursor
  • Bármely stdio-alapú MCP-kliens

Próbáld ki

Mit kérhetsz a csatlakozás után?

Nincsenek bemagolandó parancsok. Úgy írd le az utazást és a kívánt stílust, mintha egy embernek magyaráznád.

  • Animáld a Tokió → Kiotó → Oszaka utamat repülőgépes útvonalként, és rendereld 1080p-ben.
  • Tervezz autós útvonalat Dubajból Maszkatba, és adj neki filmszerű megjelenést.
  • Rendereld újra az előző videót lassabb tempóval és másik járművel.
  • Ellenőrizd, hogy be vagyok-e jelentkezve, majd rendereld a korábban előkészített csomagot.

Parancssor

A travel-animator CLI

Az MCP-szerver egy kis konzolszkript alparancsa. A szkriptet közvetlenül is használhatod.

travel-animator login

Bejelentkezés belépési hivatkozással, vagy bearer token mentése nem interaktív használathoz.

travel-animator logout

A helyben tárolt hitelesítési adatok törlése. Csak helyi művelet: a szerveroldali munkamenetek visszavonása még nem érhető el.

travel-animator render-bundle

Előkészített csomag renderelése MP4-be hálózati hozzáférés nélkül. A kapcsolók teljes listájához használd a --help lehetőséget.

travel-animator mcp

Az stdio MCP-szerver indítása. Az mcp kiegészítő szükséges hozzá.

Mielőtt elkezded

Követelmények és tudnivalók

Grafika és videó

A rendereléshez OpenGL-megvalósítás szükséges — éles környezetben GPU-illesztőprogram, csak CPU-t használó Linuxon pedig Mesa/llvmpipe —, valamint az FFmpeg/PyAV szokásos futásidejű könyvtárai.

Platformok

A Linux, a macOS és a Windows egyaránt támogatott. Windowson a GL-környezetet a WGL hozza létre, amely interaktív asztali munkamenetet igényel. Egy szolgáltatás nem tud ilyen környezetet létrehozni, és nincs tartalék szoftveres renderelési mód.

Licenc

Korlátozott felhasználású licenc, nem nyílt forráskódú. Változtatás nélkül telepítheted és futtathatod a Travel Animator-tartalmak előkészítéséhez és rendereléséhez. Továbbterjesztés, módosítás és versengő szolgáltatások létrehozása nem engedélyezett. További jogokért keresd a Lascade csapatát.

Gyakori kérdések

Válaszok a kérdéseidre

Mi a Model Context Protocol?

Az MCP nyílt szabvány, amely AI-asszisztenseket kapcsol külső eszközökhöz és adatokhoz. Egy kliens — például a Claude Desktop, a Claude Code vagy a Cursor — elindít egy MCP-szervert, felderíti az eszközeit, majd a beszélgetés során meghívhatja őket a nevedben. A travel-animator ilyen szervert tartalmaz, így az asszisztens közvetlenül vezérelheti az útvonalvideók készítését.

Mely AI-asszisztensek használhatják?

Bármely kliens, amely támogatja az MCP-t stdio-n keresztül, köztük a Claude Desktop, a Claude Code és a Cursor. Mindegyik ugyanazt a JSON-konfigurációs blokkot használja, amely a travel-animator parancsra mutat az mcp argumentummal.

Szükségem van Travel Animator-fiókra?

Igen. A csomag a Travel Animator szolgáltatás kiegészítője, ezért először futtasd a travel-animator login parancsot. Ugyanazt a fiókrendszert használja, mint a mobilalkalmazás. Bejelentkezés hiányában a hitelesítést igénylő eszközök egyértelmű, bejelentkezésre kérő üzenettel leállnak.

Hol történik a renderelés?

A saját gépeden. A renderelés a helyi OpenGL-megvalósítást és FFmpeg-könyvtárakat használja. A render-bundle hálózati hozzáférés nélkül renderel egy előkészített csomagot.

Miért jelzi a pip, hogy nem talál megfelelő verziót?

A csomag még béta állapotú, a pip pedig alapértelmezés szerint kihagyja az előzetes kiadásokat. Telepítsd a --pre kapcsolóval: pip install --pre "travel-animator[mcp]".

Nyílt forráskódú?

Nem. A travel-animator korlátozott felhasználású licenccel jelenik meg. Változtatás nélkül telepítheted és futtathatod Travel Animator-tartalmak előkészítéséhez és rendereléséhez, de nem terjesztheted tovább, nem módosíthatod, és nem építhetsz rá versengő szolgáltatást. A teljes feltételeket a csomag tartalmazza. A mellékelt betűtípusokra és zászlóképekre továbbra is a saját OFL- és MIT-licencük vonatkozik.

Használhatok hardveres kódolást?

Igen. Az alapértelmezett kódoló a mindenhol működő libx264. NVIDIA hardveres kódoláshoz add át a render-bundle parancsnak a --encoder h264_nvenc beállítást.

Milyen adatokat gyűjt az MCP-szerver?

A projektek, útvonalak és renderelt videók a saját gépedre kerülnek. Soha nem töltődnek fel, kivéve, ha kifejezetten elmentesz egy útvonalat a fiókodba. Az analitika önkéntes és alapértelmezés szerint kikapcsolt: a travel-animator analytics on futtatásáig semmi nem kerül gyűjtésre, a travel-animator analytics off pedig visszavonja a hozzájárulást. Hozzájárulás esetén az események rögzítik, mely eszközök futottak, milyen sorrendben, mennyi ideig és hibáztak-e, továbbá a renderelési beállításokat és az útvonal pontjainak számát. Koordinátákat, helyneveket, fájlútvonalakat, saját médiádat vagy az eszközök kimenetét soha nem rögzítik. A teljes tájékoztató itt található: https://www.travelanimator.com/privacy-policy.

Inkább a képernyőt érintenéd, mint utasításokat írnál?

A Travel Animator elsősorban mobilalkalmazás. Készítsd el ugyanazokat az animált útvonalakat kézzel iOS-en és Androidon, terminál nélkül.

Az alkalmazás letöltése