عن المشروع

GrooveSeek هو خادم MCP للبحث الهجين — الدلالي والنص الكامل — عبر قاعدة معرفة من ملفات Markdown، مع دعم اختياري للنصوص العادية وPDF ومستندات Office وكود المصدر. الأمر هو `groove`. بشكل افتراضي، بدون ملف إعدادات ومع النموذج الافتراضي، يفهرس Markdown الإنجليزي مع YAML frontmatter. المحتوى متعدد اللغات أو الياباني يتطلب `--model bge-m3`؛ كل صيغة ملف أخرى تُفعّل في `groove.toml`. كيف يعمل: يتم تحليل Markdown (واختياريًا .txt و.pdf و.docx و.xlsx و.pptx، بالإضافة إلى Rust منذ الإصدار 1.2.0 وPython منذ 1.3.0 وPHP منذ 1.5.0، والتي تُنزَّل قواعدها النحوية وتوضع يدويًا) مع YAML frontmatter وتقسيمه إلى أجزاء حسب العناوين — أو، لكود المصدر، جزء واحد لكل تعريف. يتم توليد التضمينات باستخدام FastEmbed افتراضيًا (BGE-small-en-v1.5، أو BGE-M3 لقواعد المعرفة متعددة اللغات) وتخزينها في SQLite مع sqlite-vec للبحث بالتشابه المتجهي. يمكن لإعداد موثوق اختيار نقطة نهاية تضمين متوافقة مع OpenAI. يتصل العملاء عبر stdio (افتراضيًا، عميل واحد) أو Streamable HTTP (عدة عملاء)، لذا يعمل مع Claude Code أو Cursor أو أي عميل متوافق مع MCP. مراقب ملفات بالمزامنة الحية يبقي الفهرس محدثًا عند التعديلات اليدوية و`git pull` والبرامج النصية الخارجية. يمكن لمخطط TOML اختياري التحقق من اصطلاحات frontmatter عبر `groove validate`، ومنذ الإصدار 1.9.0، تُخزَّن المفاتيح الإضافية التي يعلنها بواسطة `groove index` بحيث يمكن لـ `groove search --field` التصفية عليها. سطح MCP يعرض ست أدوات — `search` و`get_document` و`list_topics` و`get_connection_graph` و`get_best_practice` و`rebuild_index` — وأربعة مطالبات، وقاعدة المعرفة كموارد `kb://`. مع `--transport http`، يستجيب الخادم أيضًا على `/ui`، وهي واجهة مشغل تعرض الإصدار وعدد المستندات والأجزاء ونموذج التضمين وحالة المراقب ووقت التشغيل ومعرف العملية، مع بحث عبر نفس نقطة النهاية `/mcp` التي يستخدمها العملاء. التثبيت عبر ملفات ثنائية مُجمَّعة مسبقًا لأنظمة Linux x86_64 وaarch64 وmacOS Apple Silicon وWindows x86_64، مع مجاميع SHA-256 وإثباتات GitHub؛ يجب بناء إصدارات Intel Mac من المصدر. يتم ربط ONNX runtime وSQLite بشكل ثابت، وتُنزَّل نماذج التضمين من HuggingFace عند أول تشغيل. البناء من المصدر هو `cargo build --release`. البدء السريع هو `groove index --kb-path /path/to/knowledge-base`، ثم إدخال `.mcp.json` يشير إلى `groove serve --kb-path ...`، أو استعلامات مباشرة مع `groove search "..." --limit 3`. تغطي الوثائق الأوامر ومفاتيح الإعداد ووصفات العملاء وخط أنابيب الاسترجاع (RRF وإعادة الترتيب وMMR والمسترد الأصلي) والفلاتر والاستشهادات مع إزاحات البايت والتقييم مقابل مجموعة استعلامات ذهبية والبنية وضمانات الاستقرار؛ وتُقدَّم نسخة يابانية من كل صفحة، وتُنشر الصفحات كموقع. تتضمن وصفات النشر للإعدادات الشخصية عبر stdio والمشاركة عبر NAS وHTTP للإنترانت. الإصدارات قبل 1.0.0 هي نسخ تجريبية بدون ضمان توافق؛ من 1.0.0، توضح وثيقة الاستقرار ما هو مجمد وما هو غير مجمد عمدًا، بما في ذلك الواجهة البرمجية Rust. مرخص بموجب MIT أو Apache-2.0 بشكل مزدوج.