Có trên PyPI · v0.2.0a4 beta

Travel Animator MCP: để AI bạn chọn kết xuất video hành trình

travel-animator tích hợp máy chủ MCP. Kết nối với Claude, Cursor hoặc bất kỳ trợ lý nào hỗ trợ MCP, rồi mô tả chuyến đi bằng ngôn ngữ tự nhiên. AI sẽ lên lộ trình, chỉnh hoạt ảnh và kết xuất MP4, ngay trên máy tính của bạn.

Terminal
pip install --pre "travel-animator[mcp]"
  • Python 3.12+
  • macOS · Windows · Linux
  • stdio MCP
  • Kết xuất trên máy
Kết quả thực tế do máy chủ MCP kết xuất, chưa qua chỉnh sửa.

Tổng quan

Máy chủ MCP của Travel Animator là gì?

Máy chủ MCP của Travel Animator là gói Python travel-animator trên PyPI, cho phép trợ lý AI điều khiển toàn bộ quy trình tạo video lộ trình của Travel Animator thông qua Model Context Protocol. Cài đặt và đăng nhập một lần, sau đó trợ lý như Claude hay Cursor có thể lên lộ trình, tạo phong cách hoạt ảnh và kết xuất MP4 trên máy tính của bạn, hoàn toàn dựa trên những gì bạn nhập trong cuộc trò chuyện.

MCP là tiêu chuẩn mở để kết nối trợ lý với các công cụ bên ngoài. Ứng dụng khách khởi chạy máy chủ bằng travel-animator mcp, tìm các công cụ được cung cấp và gọi chúng trong lúc trò chuyện. Vì vậy, bạn không cần học thêm ứng dụng riêng hay cấu hình khóa API; chỉ cần đăng nhập Travel Animator.

Máy chủ kết xuất những hành trình giống ứng dụng di động, bằng cùng tài khoản: lộ trình chuyển động, mô hình phương tiện 3Dkiểu bản đồ làm nên Travel Animator. Nếu muốn tự tay tạo video, ứng dụng iOS và Android có những khả năng tương tự mà không cần terminal. Thêm điểm dừng, chọn phương tiện và xuất video là quy trình bốn bước trên điện thoại.

Trợ lý có thể làm gì

Một máy chủ cho toàn bộ quy trình

Máy chủ MCP cung cấp công cụ cho mọi công đoạn. Trợ lý có thể biến một câu mô tả thành video hoàn chỉnh mà bạn không cần mở trình biên tập.

Lên lộ trình

Kể tên các điểm dừng theo thứ tự bất kỳ và để trợ lý sắp xếp hành trình, từ thành phố này sang thành phố khác, từ cung đường này sang cung đường khác.

Điều chỉnh hoạt ảnh

Thay đổi hình thức và chuyển động của hoạt ảnh — phương tiện, kiểu lộ trình, nhịp độ — bằng cách diễn đạt yêu cầu theo ngôn ngữ tự nhiên.

Kết xuất video

Xuất MP4 bằng phần cứng của bạn. libx264 chạy trên mọi nền tảng; chọn h264_nvenc để mã hóa bằng NVIDIA.

Cài đặt

Sẵn sàng sau ba bước

Khoảng hai phút, nếu máy tính đã cài Python 3.12 trở lên.

  1. 1

    Cài gói kèm phần phụ thuộc tùy chọn mcp

    Phần tùy chọn này bổ sung MCP SDK, vốn được chủ động loại khỏi bản cài cơ bản. Gói vẫn đang ở giai đoạn beta, nên cần --pre cho đến khi có bản ổn định đầu tiên.

    Terminal
    pip install --pre "travel-animator[mcp]"
  2. 2

    Đăng nhập tài khoản Travel Animator

    Dùng cùng tài khoản với ứng dụng di động. Trong terminal tương tác, quy trình đăng nhập dùng liên kết đăng nhập nhanh: nhập email, rồi mã 6 chữ số. Với CI, hãy truyền token bearer thay thế. Thông tin xác thực được lưu tại ~/.config/tada/credentials.json với quyền truy cập 0600.

    Terminal
    travel-animator login
  3. 3

    Kết nối ứng dụng khách AI với máy chủ

    Thêm máy chủ vào cấu hình MCP của ứng dụng khách rồi khởi động lại ứng dụng. Sau đó, chỉ cần yêu cầu tạo video. Trợ lý có thể gọi auth_status để xác nhận bạn đã đăng nhập trước khi bắt đầu dựng hành trình.

    Cấu hình ứng dụng khách MCP
    {
      "mcpServers": {
        "travel-animator-mcp": {
          "command": "travel-animator",
          "args": ["mcp"]
        }
      }
    }
Tương thích với
  • Claude Desktop
  • Claude Code
  • Cursor
  • Mọi ứng dụng khách MCP dùng stdio

Thử ngay

Những yêu cầu có thể thử sau khi kết nối

Không cần nhớ lệnh. Hãy mô tả chuyến đi và phong cách mong muốn như khi bạn nói với một người.

  • Tạo hoạt ảnh chuyến đi Tokyo → Kyoto → Osaka của tôi thành tuyến bay và kết xuất ở 1080p.
  • Lên lộ trình đi ô tô từ Dubai đến Muscat và tạo phong cách điện ảnh.
  • Kết xuất lại video vừa rồi với nhịp độ chậm hơn và phương tiện khác.
  • Kiểm tra xem tôi đã đăng nhập chưa, rồi kết xuất gói tài nguyên bạn chuẩn bị trước đó.

Dòng lệnh

CLI travel-animator

Máy chủ MCP là một lệnh con của tập lệnh console nhỏ mà bạn cũng có thể tự sử dụng.

travel-animator login

Đăng nhập bằng liên kết nhanh hoặc lưu token bearer để dùng trong môi trường không tương tác.

travel-animator logout

Xóa thông tin xác thực lưu trên máy. Chỉ áp dụng cục bộ; hiện chưa hỗ trợ thu hồi phiên ở phía máy chủ.

travel-animator render-bundle

Kết xuất gói tài nguyên đã chuẩn bị thành MP4 mà không truy cập mạng. Chạy với --help để xem đầy đủ các tùy chọn.

travel-animator mcp

Chạy máy chủ MCP stdio. Cần phần tùy chọn mcp.

Trước khi bắt đầu

Yêu cầu và điều cần biết

Đồ họa và video

Kết xuất cần một triển khai OpenGL — trình điều khiển GPU trong môi trường sản xuất hoặc Mesa/llvmpipe trên Linux chỉ dùng CPU — cùng các thư viện thời gian chạy thông thường của FFmpeg/PyAV.

Nền tảng

Hỗ trợ Linux, macOS và Windows. Trên Windows, ngữ cảnh GL được tạo bởi WGL và cần phiên desktop tương tác. Một dịch vụ không thể tạo ngữ cảnh này, và không có phương án dự phòng kết xuất bằng phần mềm.

Giấy phép

Đây là giấy phép sử dụng hạn chế, không phải giấy phép mã nguồn mở. Bạn có thể cài đặt và chạy gói nguyên trạng để chuẩn bị và kết xuất nội dung Travel Animator. Không được phân phối lại, chỉnh sửa hay tạo dịch vụ cạnh tranh. Liên hệ Lascade để xin thêm quyền sử dụng.

Câu hỏi thường gặp

Giải đáp thắc mắc

Model Context Protocol là gì?

MCP là tiêu chuẩn mở để kết nối trợ lý AI với công cụ và dữ liệu bên ngoài. Ứng dụng khách như Claude Desktop, Claude Code hoặc Cursor khởi chạy máy chủ MCP, tìm các công cụ máy chủ cung cấp và có thể gọi chúng thay bạn trong cuộc trò chuyện. travel-animator tích hợp máy chủ như vậy, giúp trợ lý trực tiếp điều khiển quy trình tạo video lộ trình.

Trợ lý AI nào có thể sử dụng?

Bất kỳ ứng dụng khách nào hỗ trợ MCP qua stdio, bao gồm Claude Desktop, Claude Code và Cursor. Tất cả dùng cùng một khối cấu hình JSON, trỏ tới lệnh travel-animator với đối số mcp.

Tôi có cần tài khoản Travel Animator không?

Có. Gói này bổ trợ cho dịch vụ Travel Animator, nên hãy chạy travel-animator login trước. Nó sử dụng cùng hệ thống tài khoản với ứng dụng di động. Nếu chưa đăng nhập, các công cụ cần thông tin xác thực sẽ dừng và hiển thị thông báo rõ ràng yêu cầu đăng nhập.

Quá trình kết xuất diễn ra ở đâu?

Trên máy tính của bạn. Kết xuất sử dụng triển khai OpenGL cục bộ và thư viện FFmpeg. Lệnh render-bundle kết xuất gói tài nguyên đã chuẩn bị mà hoàn toàn không truy cập mạng.

Tại sao pip báo không tìm thấy phiên bản phù hợp?

Gói vẫn đang ở giai đoạn beta, trong khi pip mặc định bỏ qua bản phát hành trước. Cài với tùy chọn --pre: pip install --pre "travel-animator[mcp]".

Đây có phải mã nguồn mở không?

Không. travel-animator được phát hành theo giấy phép sử dụng hạn chế: bạn có thể cài đặt và chạy nguyên trạng để chuẩn bị, kết xuất nội dung Travel Animator, nhưng không được phân phối lại, chỉnh sửa hoặc dùng nó để tạo dịch vụ cạnh tranh. Điều khoản đầy đủ được kèm trong gói. Phông chữ và hình quốc kỳ đi kèm vẫn tuân theo các giấy phép OFL và MIT tương ứng.

Tôi có thể dùng mã hóa phần cứng không?

Có. Bộ mã hóa mặc định là libx264, chạy trên mọi nền tảng. Truyền --encoder h264_nvenc cho render-bundle để dùng mã hóa phần cứng NVIDIA.

Máy chủ MCP thu thập dữ liệu gì?

Dự án, lộ trình và video đã kết xuất được lưu trên máy tính của bạn và không bao giờ tải lên, trừ khi bạn chủ động lưu lộ trình vào tài khoản. Phân tích là tùy chọn và mặc định tắt: không thu thập gì cho đến khi bạn chạy travel-animator analytics on; travel-animator analytics off sẽ thu hồi sự đồng ý. Khi được cho phép, các sự kiện ghi nhận công cụ đã chạy, thứ tự, thời gian thực hiện và có lỗi hay không, cùng thiết lập kết xuất và số điểm trong lộ trình. Dữ liệu tuyệt đối không gồm tọa độ, tên địa điểm, đường dẫn tệp, nội dung đa phương tiện của bạn hay kết quả công cụ trả về. Chính sách quyền riêng tư tại https://www.travelanimator.com/privacy-policy có đầy đủ chi tiết.

Thích chạm màn hình hơn là nhập yêu cầu?

Travel Animator trước hết là ứng dụng di động. Tự tạo những lộ trình chuyển động tương tự trên iOS và Android, không cần terminal.

Tải ứng dụng