প্রকল্প সম্পর্কে

GrooveSeek হলো Markdown ফাইলের একটি নলেজ বেসের উপর হাইব্রিড সার্চ — সেমান্টিক প্লাস ফুল-টেক্সট — এর জন্য একটি MCP সার্ভার, যেখানে প্লেইন টেক্সট, PDF, Office ডকুমেন্ট এবং সোর্স কোড ঐচ্ছিকভাবে চালু করা যায়। কমান্ডটি হলো `groove`। কোনো কনফিগ ফাইল ছাড়া এবং ডিফল্ট মডেল দিয়ে, এটি YAML frontmatter সহ ইংরেজি Markdown ইনডেক্স করে। বহুভাষিক বা জাপানি কনটেন্টের জন্য `--model bge-m3` প্রয়োজন; অন্য প্রতিটি ফাইল ফরম্যাট `groove.toml`-এ চালু করতে হয়। এটি কীভাবে কাজ করে: Markdown (এবং ঐচ্ছিকভাবে .txt, .pdf, .docx, .xlsx, .pptx, সাথে v1.2.0 থেকে Rust সোর্স, v1.3.0 থেকে Python এবং v1.5.0 থেকে PHP, যাদের গ্রামার ডাউনলোড করে ম্যানুয়ালি রাখতে হয়) YAML frontmatter সহ পার্স করা হয় এবং হেডিং-ভিত্তিক চাংকে ভাগ করা হয় — অথবা সোর্স কোডের ক্ষেত্রে প্রতি ডেফিনিশনে একটি চাংক। এমবেডিং ডিফল্টভাবে FastEmbed দিয়ে তৈরি হয় (BGE-small-en-v1.5, বা বহুভাষিক নলেজ বেসের জন্য BGE-M3) এবং ভেক্টর সাদৃশ্য অনুসন্ধানের জন্য sqlite-vec সহ SQLite-এ সংরক্ষণ করা হয়। একটি বিশ্বস্ত কনফিগারেশন পরিবর্তে একটি OpenAI-সামঞ্জস্যপূর্ণ এমবেডিং এন্ডপয়েন্ট ব্যবহার করতে পারে। ক্লায়েন্টরা stdio (ডিফল্ট, একটি ক্লায়েন্ট) বা Streamable HTTP (অনেক ক্লায়েন্ট) দিয়ে সংযুক্ত হয়, তাই এটি Claude Code, Cursor বা যেকোনো MCP-সামঞ্জস্যপূর্ণ ক্লায়েন্টের সাথে কাজ করে। একটি লাইভ-সিঙ্ক ফাইল ওয়াচার ম্যানুয়াল সম্পাদনা, `git pull` এবং বাহ্যিক স্ক্রিপ্টে ইনডেক্স সতেজ রাখে। একটি ঐচ্ছিক TOML স্কিমা `groove validate`-এর মাধ্যমে frontmatter কনভেনশন যাচাই করতে পারে, এবং v1.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`-তেও উত্তর দেয়, যা একটি অপারেটর ভিউ যেখানে ভার্সন, ডকুমেন্ট ও চাংক সংখ্যা, এমবেডিং মডেল, ওয়াচার অবস্থা, আপটাইম এবং pid দেখানো হয়, সাথে ক্লায়েন্টরা যে একই `/mcp` এন্ডপয়েন্ট ব্যবহার করে সেটির মাধ্যমে সার্চ। ইনস্টলেশন Linux x86_64 ও aarch64, macOS Apple Silicon এবং Windows x86_64-এর জন্য প্রি-বিল্ট বাইনারির মাধ্যমে, সাথে SHA-256 চেকসাম এবং GitHub artifact attestations; Intel Mac বিল্ড সোর্স থেকে করতে হবে। ONNX রানটাইম এবং SQLite স্ট্যাটিকভাবে লিংক করা, এবং এমবেডিং মডেল প্রথম রানে HuggingFace থেকে ডাউনলোড হয়। সোর্স থেকে বিল্ড করতে `cargo build --release`। কুইক স্টার্ট হলো `groove index --kb-path /path/to/knowledge-base`, তারপর `groove serve --kb-path ...`-এর দিকে ইঙ্গিত করা একটি `.mcp.json` এন্ট্রি, অথবা `groove search "..." --limit 3` দিয়ে সরাসরি কোয়েরি। ডকুমেন্টেশন কভার করে কমান্ড, কনফিগারেশন কী, ক্লায়েন্ট রেসিপি, রিট্রিভাল পাইপলাইন (RRF, রির্যাংকিং, MMR, parent retriever), ফিল্টার, বাইট অফসেট সহ সাইটেশন, একটি গোল্ডেন কোয়েরি সেটের বিরুদ্ধে মূল্যায়ন, আর্কিটেকচার এবং স্থিতিশীলতার গ্যারান্টি; প্রতিটি পৃষ্ঠার একটি জাপানি সংস্করণ প্রদান করা হয়, এবং পৃষ্ঠাগুলো একটি সাইট হিসেবে প্রকাশিত হয়। ব্যক্তিগত stdio, NAS-শেয়ারড এবং ইন্ট্রানেট HTTP সেটআপের জন্য ডিপ্লয়মেন্ট রেসিপি অন্তর্ভুক্ত। 1.0.0-এর আগের রিলিজগুলো বিটা, কোনো সামঞ্জস্যতার গ্যারান্টি নেই; 1.0.0 থেকে স্থিতিশীলতা ডকুমেন্ট বলে দেয় কী ফ্রোজেন এবং কী ইচ্ছাকৃতভাবে নয়, যার মধ্যে ওয়েব ইন্টারফেস এবং Rust API অন্তর্ভুক্ত। দ্বৈত-লাইসেন্স MIT বা Apache-2.0।