تخطيط المسار
اذكر محطاتك بأي ترتيب ودع المساعد يرتب الرحلة، من مدينة إلى أخرى ومن درب إلى آخر.
نظرة عامة
ما هو خادم MCP من Travel Animator؟
خادم 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 أدوات لجميع مراحل العمل، بحيث يستطيع المساعد تحويل جملة إلى فيديو جاهز دون أن تضطر إلى فتح محرر.
ضبط الحركة
عدّل مظهر الحركة وطريقتها — المركبة وشكل المسار والإيقاع — بطلب التغييرات بلغة طبيعية.
إنتاج الفيديو
صدّر ملف MP4 باستخدام عتاد جهازك. يعمل libx264 على جميع المنصات؛ استخدم h264_nvenc للترميز باستخدام NVIDIA.
التثبيت
جاهز للعمل في ثلاث خطوات
نحو دقيقتين، إذا كان Python 3.12 أو إصدار أحدث مثبتًا بالفعل على جهازك.
- 1
ثبّت الحزمة مع الإضافة الاختيارية
mcpتضيف هذه الإضافة SDK الخاص بـ MCP، الذي لا يتضمنه التثبيت الأساسي عمدًا. لا تزال الحزمة تجريبية، لذا يلزم استخدام
--preحتى صدور أول إصدار مستقر.الطرفيةpip install --pre "travel-animator[mcp]" - 2
سجّل الدخول إلى حسابك في Travel Animator
استخدم الحساب نفسه الذي تستخدمه في تطبيق الهاتف. في طرفية تفاعلية، تتم عملية الدخول عبر رابط تسجيل دخول: أدخل بريدك الإلكتروني ثم الرمز المكوّن من 6 أرقام. في بيئات CI، مرّر رمز bearer بدلًا من ذلك. تُحفظ بيانات الاعتماد في
~/.config/tada/credentials.jsonبأذونات0600.الطرفيةtravel-animator login - 3
اربط برنامج الذكاء الاصطناعي بالخادم
أضف الخادم إلى إعدادات MCP في برنامج العميل وأعد تشغيل البرنامج. ثم اطلب فيديو ببساطة. يستطيع المساعد استدعاء
auth_statusللتحقق من تسجيل دخولك قبل البدء في إنشاء الرحلة.إعدادات عميل MCP{ "mcpServers": { "travel-animator-mcp": { "command": "travel-animator", "args": ["mcp"] } } }
يعمل مع
- Claude Desktop
- Claude Code
- Cursor
- أي عميل MCP يستخدم stdio
جرّبه
طلبات يمكنك تجربتها بعد الاتصال
لا حاجة إلى حفظ الأوامر. صِف الرحلة والمظهر الذي تريده كما لو كنت تتحدث إلى شخص.
- حوّل رحلتي طوكيو → كيوتو → أوساكا إلى مسار طائرة متحرك وأنتج الفيديو بدقة 1080p.
- خطط لمسار رحلة برية من دبي إلى مسقط وأضف إليه طابعًا سينمائيًا.
- أعد إنتاج الفيديو الأخير بإيقاع أبطأ ومركبة مختلفة.
- تحقق مما إذا كنت قد سجلت الدخول، ثم أنتج الفيديو من الحزمة التي أعددتها سابقًا.
سطر الأوامر
واجهة سطر أوامر travel-animator
خادم MCP هو أحد الأوامر الفرعية في برنامج نصي صغير يعمل عبر الطرفية، ويمكنك أيضًا تشغيله بنفسك.
travel-animator loginتسجيل الدخول عبر رابط، أو حفظ رمز bearer للاستخدام غير التفاعلي.
travel-animator logoutحذف بيانات الاعتماد المحفوظة محليًا. يقتصر ذلك على جهازك؛ إلغاء الجلسات على الخادم غير متاح بعد.
travel-animator render-bundleإنتاج ملف MP4 من حزمة مُعدّة مسبقًا دون اتصال بالشبكة. استخدم --help للاطلاع على جميع الخيارات.
travel-animator mcpتشغيل خادم MCP عبر stdio. يتطلب الإضافة الاختيارية mcp.
قبل البدء
المتطلبات ومعلومات مهمة
الرسومات والفيديو
يتطلب إنتاج الفيديو تنفيذًا لـ OpenGL — برنامج تشغيل GPU في بيئة الإنتاج، أو Mesa/llvmpipe على Linux عند استخدام CPU فقط — إضافة إلى مكتبات التشغيل المعتادة لـ FFmpeg/PyAV.
المنصات
يدعم Linux وmacOS وWindows. في Windows، يُنشأ سياق GL عبر WGL الذي يتطلب جلسة سطح مكتب تفاعلية. لا تستطيع خدمة تعمل في الخلفية إنشاء هذا السياق، ولا يتوفر بديل لإنتاج الفيديو برمجيًا.
الترخيص
هذا ترخيص استخدام محدود، وليس ترخيصًا مفتوح المصدر: يمكنك تثبيت الحزمة وتشغيلها دون تعديل لإعداد محتوى Travel Animator وإنتاجه. لا يُسمح بإعادة التوزيع أو التعديل أو إنشاء خدمات منافسة. تواصل مع Lascade للحصول على حقوق إضافية.
الأسئلة الشائعة
إجابات عن أسئلتك
ما هو Model Context Protocol؟
MCP معيار مفتوح يربط مساعدي الذكاء الاصطناعي بالأدوات والبيانات الخارجية. يشغّل عميل مثل Claude Desktop أو Claude Code أو Cursor خادم MCP، ويتعرف على الأدوات التي يقدمها، ثم يستطيع استدعاءها نيابة عنك أثناء المحادثة. تتضمن travel-animator خادمًا من هذا النوع، مما يتيح للمساعد التحكم مباشرة في عملية إنشاء فيديوهات المسارات.
ما مساعدو الذكاء الاصطناعي الذين يمكنهم استخدامه؟
أي عميل يدعم MCP عبر stdio، بما في ذلك Claude Desktop وClaude Code وCursor. يستخدم كل منها كتلة إعدادات JSON نفسها، التي تشير إلى الأمر travel-animator مع الوسيط mcp.
هل أحتاج إلى حساب 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، ويعمل على جميع المنصات. مرّر --encoder h264_nvenc إلى render-bundle لاستخدام الترميز العتادي من NVIDIA.
ما البيانات التي يجمعها خادم MCP؟
تُحفظ المشاريع والمسارات والفيديوهات المنتَجة على جهازك، ولا تُرفع أبدًا إلا إذا حفظت مسارًا في حسابك صراحةً. التحليلات اختيارية ومعطلة افتراضيًا: لا تُجمع أي بيانات حتى تشغّل travel-animator analytics on، ويلغي الأمر travel-animator analytics off هذه الموافقة. بعد موافقتك، تشمل الأحداث الأدوات التي شُغّلت وترتيبها ومدة تشغيلها وما إذا كانت قد فشلت، إضافة إلى إعدادات إنتاج الفيديو وعدد النقاط في المسار. ولا تشمل أبدًا الإحداثيات أو أسماء الأماكن أو مسارات الملفات أو وسائطك أو مخرجات الأدوات. تتوفر التفاصيل كاملة في سياسة الخصوصية على https://www.travelanimator.com/privacy-policy.
تفضل لمس الشاشة على كتابة التعليمات؟
Travel Animator تطبيق هاتف في المقام الأول. أنشئ المسارات المتحركة نفسها يدويًا على iOS وAndroid، دون الحاجة إلى الطرفية.
نزّل التطبيق
