TravelAnimator

Travel Animator MCP

旅程を説明するだけで、動画を作成できます。

Travel Animator MCP を使うと、AI アシスタントがルートを計画し、アニメーションのスタイルを設定して、お使いのマシン上で MP4 にレンダリングできます。移動に合わせてルートが描画され、その上を 3D 車両が走り、地図ラベル、国旗、モバイルアプリが重ねて表示する距離バッジも追加されます。

あなた: 「Terrain マップを使って、リスボンからポルトを経由してブラガまで行く、赤い線と車の20秒動画を作ってください。」

アシスタント: プロジェクトを作成し、3か所の立ち寄り先を追加して、その間の実際の道路に沿ってルートを設定し、マップとルートのスタイルを指定してレンダリングし、MP4 の保存先を返します。

利用できるプロンプトの例と、できないことについては、examples/prompts.mdをご覧ください。

---

インストール

コマンドは2つです。2つ目は必須です。stdio MCP サーバーは認証情報の入力を求められないため、ご自身のターミナルで一度ログインしてください。

Claude Code

claude mcp add travel-animator -e TADA_SOURCE=readme -- uvx --from "travel-animator[mcp]@latest" travel-animator mcp
uvx travel-animator login

Claude Desktop、Cursor、VS Code、Codex、または JSON を受け付けるクライアント

{
  "mcpServers": {
    "travel-animator": {
      "command": "uvx",
      "args": ["--from", "travel-animator[mcp]@latest", "travel-animator", "mcp"],
      "env": { "TADA_SOURCE": "readme" }
    }
  }
}

…続いて、ターミナルでuvx travel-animator loginを実行します。

@latestを指定すると起動のたびに最新バージョンが再取得されるため、更新するにはクライアントを再起動するだけです。指定しない場合、uvxは最初にキャッシュしたバージョンを使い続けます。

TADA_SOURCEは、どの手順に従ったかを知らせるためのものです。任意なので、不要なら削除してください。

すでに Python をお使いですか？ pip install "travel-animator[mcp]"を実行し、commandにはtravel-animatorを指定してください。Python 3.12 以降が必要です。

各クライアントの設定手順と、「ターミナルでは動くのにデスクトップアプリでは動かない」場合のPATH修正方法は、docs/clients.mdをご覧ください。

必要なもの

Python	3.12 以降
アカウント	モバイルアプリと同じ Travel Animator アカウントが必要です。無料アカウントでログインし、カタログを閲覧してプロジェクトを作成できますが、レンダリングにはプレミアムアカウントが必要です。
プラットフォーム	macOS（Apple シリコン）、Linux（x86-64、arm64）、Windows（x64）。公開されているホイールはこの4種類です。Intel Mac を含むその他のプラットフォームはサポートされていません。
ディスク	ホイールのサイズは約85 MBです。Java ランタイムが同梱されており、macOS と Windows ではグラフィックスドライバーも同梱されているため、ほかにインストールするものはありません。Linux ではシステムの GLES ドライバー、またはソフトウェアレンダリング用の Mesa を使用します。
ネットワーク	レンダリングはオフラインでは実行できません。フレームの描画時にマップタイル、グリフ、スプライトを取得し、~/.cache/tada/renderにキャッシュします。

お使いのマシンでまったくレンダリングできない場合、完了できないプロジェクトを作成する前にサーバーがその旨を通知し、サーバー側でのレンダリングに切り替えることもできます。

作成できるもの

• 34種類のマップスタイル — Terrain、Satellite、Sketch、Glow、Comic、Winter、Pixel、Watercolor など（list_maps）。無料で使えるものは1種類で、残りはプレミアムが必要です。
• 355種類の3Dモデル — 陸上、空中、水上のモデルを収録。リアルな車や飛行機からゾウまであります（list_models）。無料で使えるものは11種類です。
• 7種類のルート線スタイル — 実線、破線、点線、ストライプ、グロー、透明、自動（list_line_styles）。
• 2種類の投影法 — 平面のMERCATOR、または星、太陽、月を表示する3DのGLOBE。
• 9～60秒の動画。アスペクト比と解像度を選べます。
• 区間ごとに、実際の道路または直線を選べます。
• 地点ラベル、国旗、距離バッジ、アバター、各地点のエフェクトを追加できます。

仕組み

create_project → create_route → update_animation_state → render_video → await_render → MP4

アシスタントの動作に影響するため、知っておくべきことが2つあります。

• 明示的に指定しない限り、何も編集されません。 すべてのツールで project_id を明示的に指定します。「現在のプロジェクト」はないため、アシスタントは混同することなく複数の旅行を同時に扱えます。
• プロジェクトはローカルに永続化されます。 $XDG_STATE_HOME/tada-render/projects/<id>/（未設定の場合は ~/.local/state/…）に保存されます。動画はそのプロジェクトの renders/ に保存され、プロジェクトごとに最新の5件が保持され、それより古い動画は削除されます。アシスタントを終了しても、プロジェクトは翌日も残っています。

ツール

ツールは30種類あります。パラメーターを含む完全なリファレンスは docs/tools.md をご覧ください。

グループ	ツール
最初に確認	get_capabilities · auth_status
プロジェクト	create_project · list_projects · get_project · delete_project · import_project · export_project
ルート	create_route · get_route · add_point · update_point · remove_point · clear_route · set_real_route
外観	get_animation_state · update_animation_state · list_maps · list_models · list_line_styles
レンダリング	estimate_render · render_video · await_render · get_render_progress · get_render_result · cancel_render
アカウント同期	list_account_routes · save_project_to_account · load_account_route · delete_account_route

レンダリングの進行状況は随時通知されます。 render_video はセッション ID をすぐに返します。await_render はそのセッションを待機し、レンダリングがまだ続いている場合は、アシスタントが読み上げる進捗情報の行を返します。完了したフレーム数、進捗率、残り時間が含まれ、再び待機します。10分間のレンダリング中に10分間無言になることはありません。

ルートはスマートフォンと同期します。 save_project_to_account を使うと、モバイルアプリの「保存済みルート」にルートが保存されます。保存されるのはウェイポイントのみです。返信の dropped リストには、保存されなかったもの（アバター、エフェクト、追加モデル枠、ローカルメディア、アニメーション設定）が示されます。アシスタントは、問題なく保存できたと伝えるのではなく、その旨を伝える必要があります。

プライバシーポリシー

アプリ、ウェブサイト、およびこのパッケージを対象とする完全なポリシーは travelanimator.com/privacy-policy にあります。MCP サーバーと CLI 専用のセクションもあります。以下はそのセクションの概要です。

使用状況の分析はオプトイン方式で、ユーザーが有効にするまではオフです。有効にするまでは何も収集されず、MCP サーバーの外部では一切収集されません。

travel-animator analytics status   # what is set, and what it covers
travel-animator analytics on       # grant consent
travel-animator analytics off      # revoke, effective immediately

同意の内容にかかわらず、決して収集されない情報： ルートの座標、場所のラベル、ルートの注釈、ファイルパス、メディア、保存または読み込むルートの内容、プロジェクトに付けた名前、ツールの返答。ルートには、実際に誰かが訪れた場所が記録されています。

同意した場合に収集される情報： 呼び出されたツールとその順序、所要時間、失敗したかどうか、レンダリング設定（解像度、長さ、アニメーションスタイル、マップ、乗り物）、ルート上のポイント数、およびルートが通過する国の一覧。

自由記述に関する例外が1つあります： アシスタントがこのサーバーにないツールを求めた場合、何をしようとしていたかを説明するために書いた文が、そのリクエストとともに収集されます（最大2048文字）。サーバーが不足している機能を把握する方法はこれだけです。この文が通常のツール呼び出しに付随することはありません。分析データは、米国でサードパーティのプロバイダーによって処理されます。

コマンドライン

MCP サーバーは2つあるフロントエンドのうちの1つです。もう1つは CLI です。

travel-animator login           # log in: magic link, or a bearer token for CI
travel-animator logout          # remove credentials stored on this machine
travel-animator analytics       # show, grant or revoke analytics consent
travel-animator render-bundle   # render a prepared render bundle to MP4
travel-animator mcp             # run the MCP server (needs the mcp extra)

render-bundle は Travel Animator サービスが生成したバンドルをレンダリングします。バンドルを作成する機能はありません。何もない状態から完成した動画を作成できるのは MCP サーバーだけです。

トラブルシューティング

症状	原因	対処方法
ツールが「ログインしてください」というメッセージとともに失敗する	このマシンに認証情報がないか、有効期限が切れています	ターミナルで travel-animator login を実行してから、もう一度お試しください
ログインできるのに、レンダリングが拒否される	無料アカウントです	レンダリングにはプレミアムが必要です
デスクトップアプリからサーバーが起動しない	GUI アプリはシェルの PATH を引き継ぎません	which uvx で確認できる絶対パスを使用してください
Mac で pip install が失敗する	Intel 版 macOS 用のホイールがありません	Apple silicon、Linux、または Windows のみ対応しています
GPU のないマシンでレンダリングが失敗する	使用可能な GL がありません	最初に get_capabilities を呼び出し、サーバー側のフォールバックを使用してください
2 回目のレンダリングが拒否される	プロジェクトごと、プロセスごとに、一度に実行できるレンダリングは 1 つです	待機するか、cancel_render を実行してください

エラーコードなどの詳細は、docs/troubleshooting.md をご覧ください。

サポート

issue を作成してください。ご利用の OS、travel-animator --version の実行結果、お使いの MCP クライアント、失敗したツール、およびその error_code を記載してください。または、 [email protected] までメールでお問い合わせください。

ライセンス

これはオープンソースソフトウェアではありません。 travel-animator パッケージは限定的な使用ライセンスのもとで提供されています。変更を加えずにインストールおよび実行し、Travel Animator のコンテンツの作成とレンダリング、および Lascade のサービスとの通信に使用できます。再配布、改変、または本パッケージを使った競合サービスの構築は禁止されています。完全な利用規約はパッケージ内の tada_render/LICENSE に収録されています。

同梱されているフォント、旗の画像、およびレンダラー内のライブラリは、それぞれ独自のライセンスに基づくサードパーティ製の著作物です。ライセンスの一覧は tada_render/THIRD-PARTY-NOTICES.md をご覧ください。再配布または改変の権利については、Lascade にお問い合わせください。

このリポジトリ内の ドキュメントとサンプルは MIT ライセンスです。LICENSE をご覧ください。

---

PyPI · travelanimator.com · プライバシー · iOS · Android