规划路线
以任意顺序说出停靠点，让助手安排旅程，从一座城市到另一座城市，从一条步道到下一条步道。
概览
什么是 Travel Animator MCP 服务器？
Travel Animator MCP 服务器是一个 Python 包，即 PyPI 上的 travel-animator。它通过 Model Context Protocol，让 AI 助手直接操作 Travel Animator 的路线视频制作流程。安装并登录一次后，Claude 或 Cursor 等助手就能根据你在聊天中输入的内容，在你的电脑上规划路线、设计动画风格并渲染 MP4。
MCP 是连接助手与外部工具的开放标准。客户端通过 travel-animator mcp 启动服务器，发现可用工具，并在对话中调用它们。因此，你不需要学习另一个应用，也不需要配置 API 密钥；登录 Travel Animator 即可。
它使用同一个账号，渲染与手机应用相同的旅程：路线动画、3D 载具模型和地图样式，这些都是 Travel Animator 的核心。如果你更喜欢亲手制作视频，iOS 和 Android 应用无需终端也能完成相同的工作。从添加停靠点、选择载具到导出，在手机上只需四步。
选择工作方式
谁更适合使用 MCP 而不是手机应用？
如果你已在使用 AI 助手，希望通过电脑描述路线、提出样式修改并创建视频，可以选择 MCP。你应熟悉 Python 软件包安装及助手工具配置。
如果更喜欢自己点击查看路线和预览，请选择手机应用。包含实拍和旁白的长影片，可在视频编辑器中使用导出的地图片段。
决定前：确认电脑能够渲染，检查账号和积分余额，然后测试一条短路线。授权渲染前检查停靠点和样式。CLI 的 render-bundle 命令需要已准备好的资源包；从描述建立项目请使用 MCP。
渲染费用：需要高级账号及积分。每个视频消耗 1 积分。准备完成后即使本地渲染失败，也可能扣除积分。
渲染前请查看已发布的软件包要求及积分规则。手机端 Free 与 Pro 对比说明的是应用功能，并不是 MCP 积分额度。
助手能做什么
一个服务器，完成整个流程
MCP 服务器将完整制作流程开放为工具。无需打开编辑器，助手就能把一句话变成成片。
调整动画
用日常语言提出修改要求，即可调整动画的外观和运动方式，包括载具、路线风格和节奏。
渲染视频
使用自己的硬件导出 MP4。libx264 可在各个平台运行；如需 NVIDIA 编码，请指定 h264_nvenc。
安装
三步即可开始
开始前，请安装 Python 3.12 或更新版本。设置时间取决于你的电脑和 MCP 客户端。
- 1
安装包时包含
mcp可选依赖安装
mcp可选依赖以包含 MCP SDK。稳定版本不再需要预发行版标志。终端pip install "travel-animator[mcp]" - 2
登录你的 Travel Animator 账号
使用与手机应用相同的账号。在交互式终端中，登录采用魔术链接流程：先输入邮箱，再输入 6 位验证码。在 CI 环境中，请改为传入 bearer 令牌。凭据保存在
~/.config/tada/credentials.json，文件权限为0600。终端travel-animator login - 3
将 AI 客户端连接到服务器
将服务器添加到客户端的 MCP 配置中，然后重启客户端。接下来直接请求制作视频即可。助手可以在开始创建旅程前调用
auth_status，确认你已登录。MCP 客户端配置{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
兼容客户端
- Claude Desktop
- Claude Code
- Cursor
- 任何使用 stdio 的 MCP 客户端
试试看
连接后，可以这样提要求
无需记忆命令。像对人说话一样，描述你的旅程和想要的风格即可。
- 把我的东京 → 京都 → 大阪之旅做成飞机路线动画，并渲染为 1080p。
- 规划一条从迪拜到马斯喀特的自驾路线，做出电影感。
- 把刚才的视频重新渲染一下，节奏放慢，再换一种载具。
- 检查我是否已登录，然后渲染你之前准备好的资源包。
命令行
travel-animator CLI
MCP 服务器是一个小型控制台脚本的子命令；你也可以直接手动使用这个脚本。
travel-animator login通过魔术链接登录，或保存 bearer 令牌以供非交互式使用。
travel-animator logout删除本地保存的凭据。此操作仅影响本地；目前还不支持撤销服务器端会话。
travel-animator render-bundle将准备好的资源包渲染为 MP4。地图素材需要互联网连接。使用 --help 运行，可查看完整的参数说明。
travel-animator mcp运行 stdio MCP 服务器。需要 mcp 可选依赖。
开始之前
运行要求与注意事项
图形与视频
各平台的 wheel 安装包包含 Java；macOS 和 Windows 版本还包含图形驱动。Linux 需要系统 GLES 驱动或 Mesa。渲染会在线获取地图素材。
平台
本地渲染支持 Apple silicon Mac、Windows x64，以及 Linux x86-64 或 arm64。Intel Mac 无法本地渲染；对于不支持的电脑，MCP 可提供服务器端备用方案。
许可证
这是有限使用许可证，而非开源许可证。你可以原样安装并运行此包，用于准备和渲染 Travel Animator 内容。不得再分发、修改或用它创建竞争服务。如需额外权利，请联系 Lascade。
常见问题
你的疑问，这里解答
什么是 Model Context Protocol？
MCP 是连接 AI 助手与外部工具和数据的开放标准。Claude Desktop、Claude Code、Cursor 等客户端会启动 MCP 服务器，发现它提供的工具，然后在对话中代你调用这些工具。travel-animator 内置了这样的服务器，让助手能够直接操作路线视频制作流程。
哪些 AI 助手可以使用？
任何支持通过 stdio 使用 MCP 的客户端都可以，包括 Claude Desktop、Claude Code 和 Cursor。它们使用相同的 JSON 配置块，指向带有 mcp 参数的 travel-animator 命令。
需要 Travel Animator 账号吗？
可以。使用你的 Travel Animator 账户登录。免费账户可创建项目，但渲染需要高级权限和点数。
渲染在哪里进行？
在受支持的电脑上，渲染在本地运行，并在线获取地图素材。不支持本地渲染时，MCP 可提供服务器端备用方案。
为什么 pip 提示找不到匹配版本？
使用 Python 3.12 或更新版本，并查看 PyPI 上的当前安装说明。稳定版本不需要 --pre。
它是开源的吗？
不是。travel-animator 根据有限使用许可证发布：你可以原样安装并运行它，用于准备和渲染 Travel Animator 内容，但不能再分发、修改或用它创建竞争服务。完整条款包含在包中。随附的字体和旗帜图案仍遵循各自的 OFL 和 MIT 许可证。
可以使用硬件编码吗？
可以。默认编码器是适用于各个平台的 libx264。如需 NVIDIA 硬件编码，请向 render-bundle 传入 --encoder h264_nvenc。
MCP 服务器会收集哪些数据？
MCP 分析功能可选，但默认启用。运行 travel-animator analytics off 可关闭。事件包含工具使用和渲染设置；缺失工具的请求可能包含任务文本。完整的数据范围，请阅读 PyPI 的分析功能章节。
更喜欢点按屏幕，而不是输入指令？
Travel Animator 首先是一款手机应用。你可以在 iOS 和 Android 上手动制作相同的路线动画，无需终端。
下载应用
