منصوبے کے بارے میں

GrooveSeek مارک ڈاؤن فائلوں کے نالج بیس پر ہائبرڈ سرچ — سیمنٹک اور فل ٹیکسٹ — کے لیے ایک MCP سرور ہے، جس میں پلین ٹیکسٹ، PDF، آفس دستاویزات اور سورس کوڈ بطور آپٹ-اِن دستیاب ہیں۔ کمانڈ `groove` ہے۔ بغیر کسی کنفگ فائل اور ڈیفالٹ ماڈل کے ساتھ، یہ YAML فرنٹ میٹر والے انگریزی مارک ڈاؤن کو انڈیکس کرتا ہے۔ کثیراللسانی یا جاپانی مواد کے لیے `--model bge-m3` درکار ہے؛ باقی تمام فائل فارمیٹس `groove.toml` میں فعال کیے جاتے ہیں۔ یہ کیسے کام کرتا ہے: مارک ڈاؤن (اور اختیاری طور پر .txt، .pdf، .docx، .xlsx، .pptx، نیز Rust سورس v1.2.0 سے، Python v1.3.0 سے اور PHP v1.5.0 سے، جن کے گرامر ڈاؤن لوڈ کر کے دستی طور پر رکھے جاتے ہیں) کو YAML فرنٹ میٹر کے ساتھ پارس کیا جاتا ہے اور ہیڈنگ پر مبنی چنکس میں تقسیم کیا جاتا ہے — یا سورس کوڈ کے لیے، فی تعریف ایک چنک۔ ایمبیڈنگز بطور ڈیفالٹ FastEmbed سے بنائی جاتی ہیں (BGE-small-en-v1.5، یا کثیراللسانی نالج بیسز کے لیے BGE-M3) اور ویکٹر مماثلت کی تلاش کے لیے sqlite-vec کے ساتھ SQLite میں محفوظ کی جاتی ہیں۔ ایک قابلِ اعتماد کنفگیشن اس کے بجائے OpenAI-کمپیٹیبل ایمبیڈنگ اینڈپوائنٹ کو آپٹ-اِن کر سکتی ہے۔ کلائنٹس stdio (ڈیفالٹ، ایک کلائنٹ) یا Streamable HTTP (کئی کلائنٹس) کے ذریعے جڑتے ہیں، اس لیے یہ Claude Code، Cursor یا کسی بھی MCP-کمپیٹیبل کلائنٹ کے ساتھ کام کرتا ہے۔ ایک لائیو-سنک فائل واچر دستی ترمیمات، `git pull` اور بیرونی اسکرپٹس پر انڈیکس کو تازہ رکھتا ہے۔ ایک اختیاری TOML اسکیما `groove validate` کے ذریعے فرنٹ میٹر کنونشنز کی توثیق کر سکتا ہے، اور 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 آرٹیفیکٹ اٹیسٹیشنز کے ساتھ؛ Intel Mac بلڈز سورس سے آنے چاہئیں۔ ONNX رن ٹائم اور SQLite اسٹیٹیکلی لنک ہیں، اور ایمبیڈنگ ماڈلز پہلی بار چلانے پر HuggingFace سے ڈاؤن لوڈ ہوتے ہیں۔ سورس سے بلڈ کرنا `cargo build --release` ہے۔ کوئیک اسٹارٹ `groove index --kb-path /path/to/knowledge-base` ہے، پھر `.mcp.json` میں ایک اندراج جو `groove serve --kb-path ...` کی طرف اشارہ کرتا ہے، یا `groove search "..." --limit 3` کے ساتھ براہِ راست استفسارات۔ دستاویزات کمانڈز، کنفگیشن کیز، کلائنٹ ریسیپیز، ریٹریول پائپ لائن (RRF، reranking، MMR، parent retriever)، فلٹرز، بائٹ آفسیٹس کے ساتھ حوالہ جات، گولڈن کوئری سیٹ کے خلاف جائزہ، آرکیٹیکچر اور استحکام کی ضمانتیں کا احاطہ کرتی ہیں؛ ہر صفحے کا جاپانی ورژن فراہم کیا گیا ہے، اور صفحات ایک سائٹ کے طور پر شائع کیے جاتے ہیں۔ ذاتی stdio، NAS-شیئرڈ اور انٹرانیٹ HTTP سیٹ اپس کے لیے ڈیپلائمنٹ ریسیپیز شامل ہیں۔ 1.0.0 سے پہلے کی ریلیزز بیٹا ہیں جن کی کوئی مطابقت کی ضمانت نہیں؛ 1.0.0 سے استحکام کا دستاویز بیان کرتا ہے کہ کیا منجمد ہے اور کیا جان بوجھ کر نہیں، بشمول ویب انٹرفیس اور Rust API۔ دوہری لائسنس MIT یا Apache-2.0۔