इस प्रोजेक्ट के बारे में

मीडियाबॉक्स MCP को एक स्व-होस्ट किया गया मीडिया सर्वर स्टैक के रूप में प्रस्तुत किया गया है जिसका प्रबंधन परत मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) के माध्यम से उपलब्ध कराई गई है। रिपॉजिटरी में इसे चलाने के तीन तरीके बताए गए हैं: विंडोज/मैकओएस के लिए Tauri डेस्कटॉप ऐप और स्थानीय-प्रथम इंस्टॉलेशन के लिए यह; लिनक्स सर्वर, VPS और हेडलेस डिप्लॉयमेंट के लिए निर्दिष्ट इंटरैक्टिव CLI विज़ार्ड npx create-mediabox; और हेडलेस MCP सर्वर जिसे OAuth-संरक्षित Streamable HTTP के माध्यम से क्लॉड डेस्कटॉप, ChatGPT, जेमिनी, OpenAI-संगत क्लाइंट या वैकल्पिक टेलीग्राम बॉट से कनेक्ट किया जा सकता है। इन तीनों इंटरफेस का उपयोग समान Docker स्टैक, @mediabox/core ऑर्केस्ट्रेशन पाइपलाइन और समान MCP टूल्स से होता है। डिप्लॉयमेंट मोड में घरेलू नेटवर्क के लिए लोकल, Caddy और स्वचालित HTTPS के साथ VPS, और पोर्ट खोले बिना सार्वजनिक एक्सेस के लिए क्लाउडफ्लेयर टनल शामिल है। निर्दिष्ट आवश्यकताएं Docker, Docker Compose और Node.js 20 या उससे नया संस्करण है। डेस्कटॉप बिल्ड के लिए अतिरिक्त रूप से Tauri के लिए Rust और Node साइडकार को कंपाइल करने के लिए Bun की आवश्यकता होती है। CLI --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, लाइब्रेरी, Sonarr, Radarr, डाउनलोड और मेन्टेनेंस श्रेणियों में वर्गीकृत की गई है। उदाहरणों में सर्वर स्टेटस और एक्टिविटी लॉग, मीडिया खोज और विवरण, लाइब्रेरी और फाइल प्रबंधन, सबटाइटल फिक्सिंग, बैच रिनेमिंग, सीरीज और फिल्म की खोज/स्टेटस/हटाना/रिलीज/ग्रैब/इंपोर्ट/रीस्कैन, डायरेक्ट URL और PyLoad से डाउनलोड, डाउनलोड क्यू प्रबंधन और मीडिया ऑप्टिमाइज़ेशन या क्लीनअप जॉब शामिल हैं। सेटअप फ्लो को लगभग पंद्रह मैन्युअल स्टेप्स को बदलने वाला बताया गया है। इसमें डिप्लॉयमेंट मोड, मीडिया पाथ, क्रेडेंशियल, टाइमज़ोन और वैकल्पिक इंटीग्रेशन पूछा जाता है; .env, docker-compose.yml, VPS के लिए Caddyfile और qBittorrent कॉन्फ़िगरेशन जेनरेट किया जाता है; Docker कंटेनर शुरू किए जाते हैं; फिर सर्विस APIs के माध्यम से स्टैक का ऑटो-कॉन्फ़िगरेशन किया जाता है। इसमें Sonarr/Radarr/Prowlarr API keys निकालना, Jellyfin सेटअप विज़ार्ड चलाना, एडमिन यूजर और API key बनाना, qBittorrent को डाउनलोड क्लाइंट के रूप में कॉन्फ़िगर करना, रूट फोल्डर जोड़ना, Prowlarr इंडेक्सर सिंक करना, FlareSolverr और Jellyfin मीडिया लाइब्रेरी सेट करना और वेब UI क्रेडेंशियल सेट करना शामिल है। रिपॉजिटरी में नोट किया गया है कि Prowlarr में टोरेंट इंडेक्सर जोड़ना अभी भी एक मैन्युअल स्टेप है। यह प्रोजेक्ट MIT लाइसेंस के तहत है और README अंग्रेजी और स्पेनिश भाषाओं में उपलब्ध है।