عن المشروع

يُقدَّم Mediabox MCP كحزمة خادم وسائط ذاتية الاستضافة يتم كشف طبقة إدارتها عبر بروتوكول سياق النموذج (MCP). يصف المستودع ثلاث طرق لتشغيله: تطبيق سطح مكتب Tauri لأنظمة Windows/macOS والتثبيتات المحلية أولاً؛ ومعالج سطر أوامر تفاعلي، npx create-mediabox، مخصص لخوادم Linux، والخوادم الافتراضية الخاصة (VPS)، والنشر بدون واجهة رسومية؛ وخادم MCP بدون واجهة رسومية يمكن اتصاله بـ Claude Desktop، ChatGPT، Gemini، عميل متوافق مع OpenAI، أو بوت تيليجرام اختياري عبر HTTP القابل للبث المحمي بـ OAuth. تشترك جميع الواجهات الثلاث في نفس حزمة Docker، وخط أنابيب التنسيق @mediabox/core، وأدوات MCP نفسها. تشمل أوضاع النشر وضع Local للشبكات المنزلية، ووضع VPS مع Caddy وHTTPS التلقائي، ووضع Cloudflare Tunnel للوصول العام دون فتح المنافذ. المتطلبات المذكورة هي Docker، وDocker Compose، وNode.js 20 أو أحدث. تتطلب إصدارات سطح المكتب أيضًا Rust لـ Tauri وBun لتجميع الجانب المساعد Node. يدعم سطر الأوامر أعلامًا مثل --generate-only لكتابة التكوين دون بدء تشغيل Docker، بينما يستهدف --local-build المساهمين الذين يعملون من مستودع مستنسخ. تركز الحزمة على Jellyfin، Sonarr، Radarr، qBittorrent، وPyLoad، مع ظهور Prowlarr وFlareSolverr أيضًا في البنية المعمارية. يعمل وكيل عكسي مثل Caddy أو nginx كواجهة أمامية للخدمات. يكشف خادم MCP عن /mcp، و/api/dashboard، و/api/chat، و/api/setup، وتدرج قائمة README 30 أداة MCP مجمعة في فئات Jellyfin، Library، Sonarr، Radarr، Downloads، وMaintenance. تشمل الأمثلة حالة الخادم وسجلات النشاط، والبحث عن الوسائط وتفاصيلها، وإدارة المكتبات والملفات، وإصلاح الترجمة، وإعادة التسمية الدفعية، والبحث عن المسلسلات والأفلات/الحالة/الإزالة/الإصدارات/الاستيلاء/الاستيراد/إعادة الفحص، والتنزيلات المباشرة عبر URL وPyLoad، وإدارة طوابير التنزيل، ومهام تحسين الوسائط أو التنظيف. يتم وصف تدفق الإعداد بأنه يحل محل حوالي خمسة عشر خطوة يدوية. يطلب وضع النشر، ومسارات الوسائط، وبيانات الاعتماد، والمنطقة الزمنية، والتكاملات الاختيارية؛ وينشئ .env، وdocker-compose.yml، وCaddyfile لـ VPS، وتكوين qBittorrent؛ ويبدأ حاويات Docker؛ ثم يهيئ الحزمة تلقائيًا عبر واجهات برمجة التطبيقات للخدمات. يشمل ذلك استخراج مفاتيح API لـ Sonarr/Radarr/Prowlarr، وتشغيل معالج إعداد Jellyfin، وإنشاء مستخدم مسؤول ومفتاح API، وتكوين qBittorrent كعميل تنزيل، وإضافة المجلدات الجذرية، ومزامنة فهارس Prowlarr، وإعداد FlareSolverr ومكتبات وسائط Jellyfin، وتعيين بيانات اعتماد واجهة الويب. يلاحظ المستودع أن إضافة فهارس التورنت في Prowlarr تظل خطوة يدوية. المشروع مرخص بموجب MIT وتتوفر قائمة README باللغتين الإنجليزية والإسبانية.