ربط وكلاء الذكاء الاصطناعي بـ Muse عبر Muse4AI

شنو هو Muse4AI؟

Muse4AI هو تطبيق محلي لنظام Windows كيخلّي وكلاء الذكاء الاصطناعي يشغّلو جلسة Muse ديالك من بعد ما كتسجّل الدخول. كيربط أدوات بحال ChatGPT وClaude وCursor وCodex وn8n والسكربتات المخصّصة مع Muse عبر REST أو MCP أو OAuth.

التطبيق كيخدم فالحاسوب ديالك وكيقدّم الواجهة البرمجية المحلية ديالو على http://127.0.0.1:47821. الطلبات ما كتدوزش عبر خدمة سحابية ديال Muse4AI. النتائج ديالك، ومفاتيح API، ورموز OAuth، والسجل، والمكتبة المحلية كيبقاو فـ %APPDATA%\MuseStudio.

الإمكانيات الرئيسية

• إنشاء الصور والفيديوهات: صيفط أوصاف نصية، وزيد صور مرجعية إلا بغيتي، واختار الحساب، وتبّع الخدمة فالطابور.
• مواصلة المحادثات: مهام الدردشة كترجّع معرّف المحادثة باش يقدر الوكيل يحافظ على السياق، ويطوّر الفكرة، ويرفق الملفات.
• تمديد الفيديوهات المكتملة: كمّل مقطع مولّد حتى ست خطوات وحوالي 60 ثانية فكل سلسلة.
• تعديل الفيديو باللغة الطبيعية: رفق ملف MP4 ووصف التغييرات المطلوبة بلا ما تهيّأ خط زمني تقليدي للتعديل.
• استعمال REST أو MCP: ربط برامج الوكلاء عبر أدوات MCP أو نادِ مباشرة على واجهة REST المحلية.
• التفويض بشكل آمن: استعمل مفتاح API محدود الصلاحيات أو كمّل مسار OAuth برمز موافقة من ستة أرقام.
• تدبير الخدمة محلياً: راجع المهام فالطابور، والمعاينات، والملفات المولّدة، وإعدادات الاتصال، والسجل القابل للبحث فالتطبيق المكتبي.

المتطلبات والقيود المهمة

التطبيق المجهّز مخصّص لـ Windows 10 أو Windows 11. إلا شغّلتي المشروع من المصدر، خاصك حتى Node.js 22 أو إصدار أحدث.

Muse4AI مشروع مستقل وغير رسمي، وما عندوش علاقة بـ Meta Platforms, Inc. وما مدعومش منها وما ممولش من طرفها. هو كيأتمت جلسة Muse ديالك، لذلك راجع شروط الخدمة المعمول بها قبل ما تعتمد عليه. التغييرات فـ Muse تقدر حتى هي تأثر على الأتمتة.

إصدارات macOS وLinux المجهّزة مازال ما تختبراتش وما متوفّراش حالياً. Muse4AI ما عندوش حساب سحابي، ولا خادم للتتبّع، ولا اشتراك.

تثبيت Muse4AI على Windows

الخيار 1: استعمل برنامج التثبيت

1. حل صفحة تحميل Muse4AI.
2. حمّل وشغّل برنامج تثبيت Windows.
3. إلا حذّرك Windows بأن التطبيق ما موقّعش، اختار More info ومن بعد Run anyway.
4. حل Muse4AI ومشِ لـ Accounts.
5. زيد حساب Muse ديالك وتأكد بأن الجلسة ديالو مسجّل فيها الدخول.

الخيار 2: شغّلو من المصدر

نسخ أو حمّل المستودع، حلّ الطرفية فالمجلد الجذر ديالو، وشغّل:

cd desktop
npm install
npm run build
npm start

من بعد التشغيل، كتتحل واجهة سطح المكتب وكتولي الواجهة البرمجية المحلية متاحة على http://127.0.0.1:47821.

ربط وكيل ذكاء اصطناعي باستعمال MCP وOAuth

MCP هو الخيار المباشر الأكثر توافقاً مع عملاء الوكلاء. فـ Muse4AI، حل Settings → API & agent. التطبيق كيقدّم مقطع جاهز لإعداد الاتصال. إعداد MCP أساسي كيوجّه العميل لنقطة النهاية المحلية:

{
  "mcpServers": {
    "muse4ai": {
      "url": "http://127.0.0.1:47821/mcp"
    }
  }
}

زيد هاد الإعداد لعميل MCP اللي كيستعملو الوكيل ديالك. أثناء تفويض OAuth، Muse4AI كيعرض رمز من ستة أرقام. دخل داك الرمز فصفحة الموافقة باش توافق على الاتصال ويتصدر رمز وصول.

خادم OAuth كينشر بيانات التفويض الوصفية ديالو، وكيدعم التسجيل الديناميكي للعملاء، وكيوقّع الرموز ديالو بنفسو. معرفة رابط MCP المحلي بوحدها ما كافياش للموافقة على الوصول، حيث خاص المستخدم حتى هو يقدّم الرمز اللي كيعرضو التطبيق المكتبي.

باش تحيد الوصول من بعد، حل Settings → API & agent → Connected apps ولغِ التطبيق المعني.

الربط عبر REST API

بالنسبة للسكربتات والخدمات اللي كتستعمل HTTP مباشرة، صايب مفتاح API من Settings → API & agent. مفاتيح Muse4AI ككتبدا بـ msk_. صيفط المفتاح كرمز bearer فـ ترويسة Authorization.

إرسال مهمة لإنشاء فيديو

الطلب التالي كينشئ مهمة فيديو بوصف نصي:

curl -X POST http://127.0.0.1:47821/v1/jobs \
  -H "Authorization: Bearer msk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"video","prompt":"a coffee cup on an oak desk, warm morning light"}'

بدّل msk_YOUR_KEY بالمفتاح اللي صايبو التطبيق المكتبي. المهمة المرسلة كتبان فالطابور داخل التطبيق، ومن تما تقدر تتبّع الحالة ديالها وتعاين النتيجة.

عمليات REST وأدوات MCP المتاحة

• POST /v1/jobs كينشّط مهام ديال الصور ولا الفيديو. أداة MCP الموافقة هي muse_generate.
• POST /v1/jobs مع kind: "chat" كينشّط مهمة ديال الدردشة. أداة MCP الموافقة هي muse_chat.
• GET /v1/jobs كيعرض المهام عبر REST. عملاء MCP يقدرو يستعملو muse_list_jobs.
• GET /v1/jobs/{id} كيرجّع مهمة معيّنة. المقابل ديالها فـ MCP هو muse_get_job.
• POST /v1/jobs/{id}/cancel كيلغي مهمة. أداة MCP هي muse_cancel_job.
• POST /v1/assets/{id}/extend وPOST /v1/conversations/{id}/extend كيدعمو تمديد الفيديو. أدوات MCP المرتابطة كتشمل muse_extend_video وmuse_get_extend.
• GET /v1/status وGET /v1/health كيعطيو معلومات على الخدمة. عملاء MCP يقدرو يستعملو muse_status.

العقد الكامل ديال API بصيغة قابلة للقراءة الآلية متوفر فالتطبيق اللي خدام عبر GET /v1/openapi.json. الوكلاء اللي كيتعاملو مزيان مع توثيق Markdown يقدرو يقراو llms.txt.

مسارات العمل الأساسية للوكلاء

إنشاء صورة ولا فيديو

1. تأكّد باللي Muse4AI خدام، وباللي حساب Muse ديالك متوفر تحت Accounts.
2. طلب من الوكيل المرتابط ينشّط صورة ولا فيديو، وعطيه وصف واضح.
3. إلى كان ضروري، زيد صور مرجعية وحدّد شنو هو الحساب المهيّأ اللي خاصو يتستعمل.
4. حلّ قائمة الانتظار باش تتبّع المهمة، تشوف الحالة ديالها، وتعاين النتيجة.
5. لقا الخدمة اللي كملات فالمكتبة المحلية.

كمّل محادثة

استعمل muse_chat ولا أنشئ مهمة REST بـ kind: "chat". خَلّي معاك معرّف المحادثة اللي كيرجع، باش يقدر الوكيل يكمل نفس الموضوع بلا ما يفتح محادثة جديدة.

مدّد مقطع كمل

من بعد ما يكمل الفيديو، استعمل نقطة تمديد الأصل ولا المحادثة، ولا طلب من وكيل MCP يعيّط على muse_extend_video. التمديدات كاتبقى فالمحادثة اللي تخلق فيها المقطع الأصلي. السلسلة تقدر تحتوي حتى لستة ديال خطوات التمديد وتوصل تقريباً لـ 60 ثانية.

عدّل فيديو موجود

رفق ملف MP4 وشرح التغيير اللي بغيتي بلغة عادية. Muse4AI كيدوز الطلب عبر جلسة Muse ديالك بلا ما تحتاج تحدد إعدادات الخط الزمني ولا التصيير.

نصائح متقدمة

استعمل طريقة التفويض المناسبة

اختار OAuth إلا كان عميل MCP ديالك كيدعم التفويض التفاعلي وما بغيتيش تنسخ مفتاح. اختار مفتاح API لأدوات سطر الأوامر، والأتمتة المحلية، والأنظمة اللي كترسل رموز bearer. مفاتيح API عندها نطاقات محددة، ومحدودة فمعدل الطلبات، وتقدر تلغي كل مفتاح بوحدو.

حمي بيانات الاعتماد المحلية

ما تنشرش مفتاح msk_ فمستودع الكود، ولا فلقطات الشاشة، ولا فالمطالبات المشتركة، ولا فسجل الأوامر. من الأحسن تنشئ مفاتيح مختلفة لكل عميل، ومن بعد تلغي غير المفتاح المتأثر إلا ما بقاتش الحاجة للصلاحية.

حافظ على معرّفات المحادثات

ملي كتبيّن تكامل، خزّن معرّف المحادثة اللي كيرجع فمسارات الدردشة وإنشاء المحتوى. إعادة استعمالو كتخلي الوكيل يكمل نفس الموضوع، يرفق الملفات فالسياق، ويمدّد الفيديو فالمحادثة الأصلية ديالو.

عاين عقد API

بلا ما تخمّن حقول الطلب والجواب، قرا http://127.0.0.1:47821/v1/openapi.json من التطبيق اللي خدام. هاد الشي مفيد خصوصاً ملي كتولّد عميلاً مكتوباً بنوع محدد ولا كتهيّأ منصة أتمتة.

راقب الحالة قبل ما ترسل الخدمة

استعمل GET /v1/status أو GET /v1/health أو أداة MCP muse_status باش تتأكد من الخدمة المحلية قبل ما تبدا مسار طويل. استعمل عمليات العرض والاسترجاع لمراقبة المهام، ولغي الخدمة اللي ما بقاتش مطلوبة.

طوّر المشروع واختبرو

المستودع كيفصل بين تطبيق سطح المكتب، والمحتوى المشترك، وتعليمات الوكلاء:

• desktop/ فيه العملية الرئيسية، والواجهة، وواجهات REST وMCP وOAuth، والاختبارات، وكود التثبيت.
• content/ فيه نصوص الأدلة والوكلاء وحالات الاستعمال اللي كيتشاركوها التطبيق والموقع.
• agent-kit/ فيه Skill ديال Muse4AI اللي يقدرو الوكلاء يقراوه باش يتعلمو كيفاش يستعملو الأداة.

من مجلد desktop، شغّل فحوصات المشروع وأمر إعداد حزمة Windows:

cd desktop
npm test
npm run typecheck
npm run package:win

أمر الاختبار كيشغّل مجموعة اختبارات المستودع، وnpm run typecheck كيفحص TypeScript الصارم، وnpm run package:win كيحضّر ملف ZIP ديال Windows ومدخلات المثبّت.

الخلاصة

Muse4AI كيوفّر جسر محلي بين Muse ووكلاء الذكاء الاصطناعي اللي كيفهمو REST أو MCP أو OAuth. منين كيكون تطبيق Windows خدام وحساب Muse ديالك مربوط، تقدر تنشئ الوسائط، وتحافظ على المحادثات، وتمدّد الفيديوهات، وتعدّل ملفات MP4 بطلبات باللغة الطبيعية، وتدبّر النتائج بلا وسيط سحابي ديال Muse4AI.

لمزيد من لقطات الشاشة والإرشادات، زُر الدليل الرسمي. Muse4AI متوفر بموجب رخصة MIT.