规划路线
以任意顺序说出停靠点，让助手安排旅程，从一座城市到另一座城市，从一条步道到下一条步道。
概览
什么是 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 服务器将完整制作流程开放为工具。无需打开编辑器，助手就能把一句话变成成片。
调整动画
用日常语言提出修改要求，即可调整动画的外观和运动方式，包括载具、路线风格和节奏。
渲染视频
使用自己的硬件导出 MP4。libx264 可在各个平台运行；如需 NVIDIA 编码，请指定 h264_nvenc。
安装
三步即可开始
如果电脑上已安装 Python 3.12 或更高版本，整个过程约需两分钟。
- 1
安装包时包含
mcp可选依赖该可选依赖会添加 MCP SDK；基础安装有意不包含它。此包仍处于测试阶段，因此在首个稳定版发布前必须使用
--pre。终端pip install --pre "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 可选依赖。
开始之前
运行要求与注意事项
图形与视频
渲染需要 OpenGL 实现：生产环境使用 GPU 驱动，仅使用 CPU 的 Linux 环境可用 Mesa/llvmpipe。此外，还需要 FFmpeg/PyAV 常用的运行时库。
平台
支持 Linux、macOS 和 Windows。在 Windows 上，GL 上下文由 WGL 创建，需要交互式桌面会话。服务进程无法创建该上下文，也没有软件渲染的备用方案。
许可证
这是有限使用许可证，而非开源许可证。你可以原样安装并运行此包，用于准备和渲染 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 服务的配套工具，请先运行 travel-animator login。它与手机应用使用同一套账号系统。如果尚未登录，需要凭据的工具会停止运行，并显示明确的登录提示。
渲染在哪里进行？
在你自己的电脑上。渲染使用本地 OpenGL 实现和 FFmpeg 库；render-bundle 可以在完全不访问网络的情况下渲染准备好的资源包。
为什么 pip 提示找不到匹配版本？
此包仍处于测试阶段，而 pip 默认跳过预发布版本。请添加 --pre 选项安装：pip install --pre "travel-animator[mcp]"。
它是开源的吗？
不是。travel-animator 根据有限使用许可证发布：你可以原样安装并运行它，用于准备和渲染 Travel Animator 内容，但不能再分发、修改或用它创建竞争服务。完整条款包含在包中。随附的字体和旗帜图案仍遵循各自的 OFL 和 MIT 许可证。
可以使用硬件编码吗？
可以。默认编码器是适用于各个平台的 libx264。如需 NVIDIA 硬件编码，请向 render-bundle 传入 --encoder h264_nvenc。
MCP 服务器会收集哪些数据？
项目、路线和渲染后的视频保存在你自己的电脑上，除非你明确将路线保存到账号，否则不会上传。分析功能需主动同意，默认关闭：在运行 travel-animator analytics on 之前不会收集任何数据，运行 travel-animator analytics off 即可撤回同意。获得同意后，事件记录会包含运行了哪些工具、运行顺序、耗时、是否失败，以及渲染设置和路线点数。绝不包含坐标、地点名称、文件路径、你的媒体文件或工具返回的内容。完整说明见 https://www.travelanimator.com/privacy-policy 的隐私政策。
更喜欢点按屏幕，而不是输入指令？
Travel Animator 首先是一款手机应用。你可以在 iOS 和 Android 上手动制作相同的路线动画，无需终端。
下载应用
