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

Vault Cortex एक स्टैंडअलोन MCP (Model Context Protocol) सर्वर है जो AI एजेंट्स को हाइब्रिड सर्च, टास्क मैनेजमेंट, संरचित मेमोरी और Obsidian वॉल्ट तक पढ़ने/लिखने की सुविधा प्रदान करता है। यह डिस्क पर मौजूद `.md` फ़ाइलों पर सीधे काम करता है, इसके लिए किसी Obsidian प्लगइन या चल रहे इंस्टेंस की जरूरत नहीं होती। सर्वर एक ही Docker कंटेनर में चलता है और इसे लोकल, VPS पर सेल्फ-होस्टेड, या रिमोट एक्सेस के लिए Railway या Render पर वन-क्लिक डिप्लॉयमेंट के जरिए तैनात किया जा सकता है। **मुख्य विशेषताएं:** - **हाइब्रिड सर्च**: Reciprocal Rank Fusion (RRF) के जरिए FTS5 कीवर्ड मैचिंग को वेक्टर सेमांटिक समानता के साथ जोड़ता है, और इंटेंट-भारी क्वेरीज़ के लिए क्रॉस-एनकोडर रीरैंकिंग से इसे परिष्कृत करता है। सभी मॉडल लोकल चलते हैं (कुल ~45MB, कोई बाहरी API नहीं)। - **संरचित मेमोरी**: सादे Markdown फ़ाइलों में संग्रहीत एक अपेंड-ओनली, दिनांकित एंट्री सिस्टम (डिफ़ॉल्ट `About Me/` फ़ोल्डर)। टॉपिक रिकॉल सभी मेमोरी फ़ाइलों में प्रासंगिक एंट्रीज़ प्राप्त करता है, वर्तमान स्थिति और ऐतिहासिक विकास दिखाता है। प्रून करने योग्य वर्तमान-स्थिति एंट्रीज़ के लिए `entry-policy: living` का समर्थन करता है। - **टास्क मैनेजमेंट**: Kanban-जागरूक टास्क क्वेरीज़ और अपडेट। स्टेटस, तारीखों, प्राथमिकता, फ़ोल्डर या लेन के आधार पर फ़िल्टरिंग का समर्थन करता है। Tasks प्लगइन इमोजी साइनिफायर और Dataview इनलाइन-फ़ील्ड फ़ॉर्मेट दोनों को संभालता है। आवर्ती टास्क पूरा करने पर अगली घटनाएं बनती हैं; "On completion" क्रियाओं का समर्थन करता है। - **फ़ाइल एक्सेस**: नॉन-मार्कडाउन फ़ाइलें पढ़ता है, जिनमें इमेज (सर्वर-साइड डाउनस्केल), PDF (टेक्स्ट एक्सट्रैक्शन या रेंडर किए गए पेज), कैनवास (पठनीय आउटलाइन), और डेटा फ़ाइलें (TXT, SVG, JSON, XML, CSV, YAML, लॉग, Bases) शामिल हैं। - **लिंक ग्राफ**: पूरे वॉल्ट में बैकलिंक, आउटगोइंग लिंक और ऑर्फन डिटेक्शन। - **Obsidian-नेटिव**: फ्रंटमैटर, विकिलिंक, टैग, हेडिंग और डेली नोट्स को समझता है। - **गाइडेड वर्कफ़्लो**: वॉल्ट हेल्थ, मेमोरी रिव्यू और डेली रिकंसिलिएशन के लिए बिल्ट-इन प्रॉम्प्ट, जो लाइव वॉल्ट डेटा से तैयार होते हैं। **प्रमाणीकरण**: कंसेंट पेजों के साथ रिमोट एक्सेस के लिए OAuth 2.1 का समर्थन करता है, साथ ही OAuth रहित क्लाइंट के लिए Bearer टोकन भी। OAuth क्लाइंट के लिए टोकन नवीनीकरण स्वचालित रूप से होता है। **डिप्लॉयमेंट विकल्प**: - लोकल: Docker + वॉल्ट फ़ोल्डर, `npx vault-cortex@latest init` के जरिए सेटअप - रिमोट: Railway या Render पर वन-क्लिक डिप्लॉय, या Docker के साथ किसी भी Linux VPS पर सेल्फ-होस्टेड - रिमोट डिप्लॉयमेंट डिवाइसों में वॉल्ट को अद्यतन रखने के लिए Obsidian Sync का उपयोग करते हैं **सेटअप**: CLI सर्वर लाइफसाइकल (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`) को प्रबंधित करता है। मैनुअल Docker Compose सेटअप भी उपलब्ध है। `/setup` पर एक सेटअप पेज रिमोट डिप्लॉयमेंट के लिए Obsidian Sync साइन-इन को संभालता है। **सुरक्षा**: इसमें Gitleaks और Trivy स्कैन के साथ CI, OpenSSF Scorecard और Best Practices बैज शामिल हैं। वॉल्ट सादे Markdown में सत्य का स्रोत बना रहता है; कंटेनर केवल एक प्रति रखता है। **उपयोग के मामले**: यूरोप की 15-दिवसीय यात्रा में एक फ़ोन से 30+ सेशन, 216 टूल कॉल, शून्य लैपटॉप एक्सेस के साथ परीक्षण किया गया। एक सेशन में किए गए लेखन अगले सेशन में शहरों और दिनों के पार तुरंत उपलब्ध थे।