تخطيط المسار
اذكر محطاتك بأي ترتيب ودع المساعد يرتب الرحلة، من مدينة إلى أخرى ومن درب إلى آخر.
على PyPI · v1.3.0
تتضمن حزمة travel-animator خادم MCP. اربطه بـ Claude أو Cursor أو أي مساعد يدعم MCP، ثم صِف رحلتك بكلماتك. سيتولى الذكاء الاصطناعي تخطيط المسار وضبط الحركة وإنتاج ملف MP4، وكل ذلك على جهازك.
pip install "travel-animator[mcp]"نظرة عامة
خادم MCP من Travel Animator هو حزمة Python — travel-animator على PyPI — تتيح لمساعدي الذكاء الاصطناعي تشغيل مراحل إنشاء فيديوهات المسارات في Travel Animator عبر Model Context Protocol. ثبّت الحزمة وسجّل الدخول مرة واحدة، ثم يستطيع مساعد مثل Claude أو Cursor تخطيط مسار وتنسيق حركته وإنتاج ملف MP4 على جهازك، اعتمادًا بالكامل على ما تكتبه في المحادثة.
MCP معيار مفتوح يربط المساعدين بالأدوات الخارجية. يشغّل برنامج العميل الخادم بالأمر travel-animator mcp، ويتعرف على الأدوات المتاحة ثم يستدعيها أثناء المحادثة. لن تحتاج إلى تعلّم تطبيق منفصل أو إعداد مفاتيح API؛ يكفي تسجيل الدخول إلى Travel Animator.
ينتج الخادم الرحلات نفسها التي ينشئها تطبيق الهاتف، باستخدام الحساب نفسه: المسارات المتحركة ونماذج المركبات ثلاثية الأبعاد وأنماط الخرائط التي يقوم عليها Travel Animator. وإذا كنت تفضل إنشاء الفيديوهات يدويًا، فإن تطبيقي iOS وAndroid يقدمان الإمكانات نفسها دون الحاجة إلى الطرفية. إضافة المحطات واختيار المركبة والتصدير عملية تتم في أربع خطوات على الهاتف.
اختر طريقة عملك
اختر MCP إذا كنت تعمل أصلًا مع مساعد ذكاء اصطناعي وتريد وصف المسارات وطلب تغييرات التصميم وإنشاء الفيديوهات من الكمبيوتر. ينبغي أن تكون مرتاحًا لتثبيت حزم Python وإعداد أدوات مساعدك.
اختر تطبيق الهاتف إذا كنت تفضّل مراجعة المسار والمعاينة بنفسك عبر اللمس. ولفيلم أطول يتضمن لقطات وتعليقًا صوتيًا، استخدم مقطع الخريطة المصدّر في محرر فيديو.
قبل اتخاذ القرار: تأكد من قدرة الكمبيوتر على التصيير، وتحقق من حسابك ورصيدك، ثم جرّب مسارًا قصيرًا. راجع المحطات والتنسيق قبل السماح بالتصيير. يحتاج أمر CLI المسمى render-bundle إلى حزمة جاهزة؛ استخدم MCP لبناء مشروع انطلاقًا من وصف.
تكاليف التصيير: يلزم حساب مميز ووحدات رصيد. يكلف كل فيديو وحدة واحدة. قد تُستهلك الوحدة حتى إذا فشل التصيير المحلي بعد التحضير.
راجع متطلبات الحزمة المنشورة وقواعد الرصيد قبل التصيير. تصف مقارنة Free وPro للهاتف التطبيق؛ وليست مخصصًا لرصيد MCP.
ما الذي يستطيع مساعدك فعله؟
يوفر خادم MCP أدوات لجميع مراحل العمل، بحيث يستطيع المساعد تحويل جملة إلى فيديو جاهز دون أن تضطر إلى فتح محرر.
اذكر محطاتك بأي ترتيب ودع المساعد يرتب الرحلة، من مدينة إلى أخرى ومن درب إلى آخر.
عدّل مظهر الحركة وطريقتها — المركبة وشكل المسار والإيقاع — بطلب التغييرات بلغة طبيعية.
صدّر ملف MP4 باستخدام عتاد جهازك. يعمل libx264 على جميع المنصات؛ استخدم h264_nvenc للترميز باستخدام NVIDIA.
التثبيت
ثبّت Python 3.12 أو أحدث قبل البدء. يعتمد وقت الإعداد على الكمبيوتر وعميل MCP.
mcpثبّت الإضافة mcp لتضمين SDK الخاص بـMCP. لم تعد الإصدارات المستقرة تحتاج إلى خيار الإصدارات التجريبية.
pip install "travel-animator[mcp]"استخدم الحساب نفسه الذي تستخدمه في تطبيق الهاتف. في طرفية تفاعلية، تتم عملية الدخول عبر رابط تسجيل دخول: أدخل بريدك الإلكتروني ثم الرمز المكوّن من 6 أرقام. في بيئات CI، مرّر رمز bearer بدلًا من ذلك. تُحفظ بيانات الاعتماد في ~/.config/tada/credentials.json بأذونات 0600.
travel-animator loginأضف الخادم إلى إعدادات MCP في برنامج العميل وأعد تشغيل البرنامج. ثم اطلب فيديو ببساطة. يستطيع المساعد استدعاء auth_status للتحقق من تسجيل دخولك قبل البدء في إنشاء الرحلة.
{
"mcpServers": {
"travel-animator-mcp": {
"command": "travel-animator",
"args": ["mcp"]
}
}
}جرّبه
لا حاجة إلى حفظ الأوامر. صِف الرحلة والمظهر الذي تريده كما لو كنت تتحدث إلى شخص.
سطر الأوامر
travel-animatorخادم MCP هو أحد الأوامر الفرعية في برنامج نصي صغير يعمل عبر الطرفية، ويمكنك أيضًا تشغيله بنفسك.
travel-animator loginتسجيل الدخول عبر رابط، أو حفظ رمز bearer للاستخدام غير التفاعلي.
travel-animator logoutحذف بيانات الاعتماد المحفوظة محليًا. يقتصر ذلك على جهازك؛ إلغاء الجلسات على الخادم غير متاح بعد.
travel-animator render-bundleصيّر حزمة مجهزة إلى MP4. تتطلب موارد الخرائط اتصالًا بالإنترنت. شغّل باستخدام --help لمرجع الخيارات الكامل.
travel-animator mcpتشغيل خادم MCP عبر stdio. يتطلب الإضافة الاختيارية mcp.
قبل البدء
تضم حزم wheel الخاصة بالمنصات Java، وعلى macOS وWindows تضم أيضًا برامج تشغيل الرسومات. يحتاج Linux إلى برنامج تشغيل GLES للنظام أو Mesa. يجلب التصيير موارد الخرائط عبر الإنترنت.
يدعم التصيير المحلي أجهزة Mac بمعالجات Apple silicon وWindows x64 وLinux x86-64 أو arm64. لا تستطيع أجهزة Mac بمعالجات Intel التصيير محليًا؛ ويمكن لـMCP تقديم بديل على الخادم للأجهزة غير المدعومة.
هذا ترخيص استخدام محدود، وليس ترخيصًا مفتوح المصدر: يمكنك تثبيت الحزمة وتشغيلها دون تعديل لإعداد محتوى Travel Animator وإنتاجه. لا يُسمح بإعادة التوزيع أو التعديل أو إنشاء خدمات منافسة. تواصل مع Lascade للحصول على حقوق إضافية.
الأسئلة الشائعة
MCP معيار مفتوح يربط مساعدي الذكاء الاصطناعي بالأدوات والبيانات الخارجية. يشغّل عميل مثل Claude Desktop أو Claude Code أو Cursor خادم MCP، ويتعرف على الأدوات التي يقدمها، ثم يستطيع استدعاءها نيابة عنك أثناء المحادثة. تتضمن travel-animator خادمًا من هذا النوع، مما يتيح للمساعد التحكم مباشرة في عملية إنشاء فيديوهات المسارات.
أي عميل يدعم MCP عبر stdio، بما في ذلك Claude Desktop وClaude Code وCursor. يستخدم كل منها كتلة إعدادات JSON نفسها، التي تشير إلى الأمر travel-animator مع الوسيط mcp.
نعم. سجّل الدخول بحساب Travel Animator. تستطيع الحسابات المجانية إنشاء المشاريع، لكن التصيير يحتاج إلى وصول مميز وأرصدة.
على أجهزة الكمبيوتر المدعومة، يعمل التصيير محليًا ويجلب موارد الخرائط عبر الإنترنت. يستطيع MCP تقديم بديل على الخادم عندما لا يكون التصيير المحلي مدعومًا.
استخدم Python 3.12 أو أحدث وافحص تعليمات التثبيت الحالية على PyPI. لا تحتاج الإصدارات المستقرة إلى --pre.
لا. تُنشر travel-animator بموجب ترخيص استخدام محدود: يمكنك تثبيتها وتشغيلها دون تعديل لإعداد محتوى Travel Animator وإنتاجه، لكن لا يمكنك إعادة توزيعها أو تعديلها أو استخدامها لإنشاء خدمة منافسة. تتضمن الحزمة الشروط كاملة، وتظل الخطوط ورسومات الأعلام المرفقة خاضعة لتراخيص OFL وMIT الخاصة بها.
نعم. المرمّز الافتراضي هو libx264، ويعمل على جميع المنصات. مرّر --encoder h264_nvenc إلى render-bundle لاستخدام الترميز العتادي من NVIDIA.
تحليلات MCP اختيارية لكنها مفعلة افتراضيًا. شغّل travel-animator analytics off لتعطيلها. تتضمن الأحداث استخدام الأدوات وإعدادات التصيير؛ وقد تتضمن طلبات الأدوات الناقصة نص المهمة. اقرأ قسم التحليلات في PyPI لمعرفة النطاق الكامل للبيانات.
Travel Animator تطبيق هاتف في المقام الأول. أنشئ المسارات المتحركة نفسها يدويًا على iOS وAndroid، دون الحاجة إلى الطرفية.
نزّل التطبيق