مواد پر جائیں

کلاسیکی عربی کتب کے MCP ٹولز: مکمل فہرست

قرآن گیلری MCP سرور کے 15 صرف پڑھنے والے ٹولز، نیز 3 پرامپٹس اور ایک ریسورس: تلاش، مطالعہ، حوالے، اسناد، راوی، تفسیر، فہرست۔

اس صفحے پر

پندرہ ٹولز، سب کلائنٹس کے لیے یکساں، سب صرف پڑھنے کے لیے۔ چار ہمارے اپنے ہیں (shamela_search_library، search، fetch، shamela_verify_quote)؛ گیارہ خود لائبریری سرور سے آتے ہیں۔ ان گیارہ میں سے نو راؤٹر ہیں: ہر ایک ایک موڈ آرگیومنٹ (match، kind، unit یا mode) لیتا ہے جو طے کرتا ہے کہ وہ کیا کرے، اور نیچے کے جدول ہر موڈ کو الگ قطار میں دیتے ہیں۔ search اور fetch وہ معیاری جوڑی ہے جو ChatGPT deep research کو درکار ہے، اور ہر کلائنٹ انہیں دیکھتا ہے۔ ٹولز کے ساتھ سرور تین پرامپٹس اور ایک ریسورس بھی پیش کرتا ہے۔

آپ کا کلائنٹ انہیں آپ کے لیے فہرست کرتا ہے۔ یہ صفحہ ایک نقشہ ہے، تاکہ آپ جان سکیں کہ کیا موجود ہے اور کس کی طرف رجوع کرنا ہے — ہر ٹول اپنی پیرامیٹر دستاویزات اس اسکیما میں رکھتا ہے جو آپ کے کلائنٹ کو پہلے ہی مل چکی ہے۔

shamela_search_library سے شروع کریں۔ اس میں دائرہ لازمی ہے اور یہ بتاتا ہے کہ مطابقت کیسے ہوئی، جو “مجھے یہ متن ڈھونڈ دو” کے لیے درست ڈیفالٹ ہے۔ جب وہ کام درکار ہو جو یہ نہیں کر سکتا تو خام shamela_* ٹولز استعمال کریں۔ تمام سوالات عربی میں ہونے چاہییں۔

تلاش

ٹولکب استعمال کریں
shamela_search_libraryڈیفالٹ۔ حوالوں اور مطابقت کی رپورٹ کے ساتھ دائرہ وار تلاش۔ اس کا حوالہ دیکھیں۔
searchChatGPT deep research اور company knowledge۔ پوری لائبریری میں ایک سوال؛ id، title، url پر مشتمل results لوٹاتا ہے۔ تفصیل نیچے۔
shamela_search (match: 'words')آپ کو خام صفحہ تلاش چاہیے، بغیر دائرے کے بھی۔ الفاظ کی تعداد کے لحاظ سے درجہ بندی کرتا ہے — نیچے دی گئی تنبیہ پڑھیں۔
shamela_search (match: 'phrase')آپ کو عین مسلسل عبارت چاہیے، یا قربت کی بنیاد پر مطابقت۔
shamela_search (match: 'exact')اعراب (التشكيل) اور ہمزہ/الف کی صورتیں بالکل مطابق ہونی چاہییں۔
shamela_search (match: 'boolean')آپ کو صرف AND نہیں، OR اور NOT بھی چاہییں۔
shamela_find (kind: 'heading')آپ کسی باب یا فصل کا عنوان ڈھونڈ رہے ہیں، متن نہیں۔
shamela_lookup_hadith (mode: 'search')آپ کے پاس کسی حدیث کے الفاظ ہیں اور وہ مجموعے چاہییں جن میں وہ ہے۔
shamela_search (match: 'batch')ایک کال میں چوبیس تک دائرہ وار تلاشیں، ضم شدہ اور تکرار سے پاک۔
shamela_survey_topicتلاش سے پہلے: لائبریری کسی لفظ پر کتنا رکھتی ہے، اور کن شیلفوں، صدیوں، کتابوں اور مصنفین کے ہاں؟ بطورِ طے شدہ لفظ کو ویسے ہی گنتا ہے جیسے لکھا گیا؛ mode: 'morphological' اس کے مادے کی ہر شکل گنتا ہے۔

shamela_search (match: 'words') بغیر دائرے کے بھی چل جاتا ہے، اور عموماً چلانا نہیں چاہیے۔ درجہ بندی الفاظ کی تعداد پر ہوتی ہے، جسے علمی اعتبار کی کوئی خبر نہیں۔ بغیر دائرے کے التيمم 26,098 نتائج دیتا ہے جن میں سب سے اوپر 710 ہجری کا ایک شعری مجموعہ ہے، اور إنما الأعمال بالنيات 6,815 نتائج دیتا ہے جن میں صحیح بخاری کہیں نظر نہیں آتی۔ دائرہ دیں، یا shamela_search_library استعمال کریں۔

search اور fetch

ChatGPT deep research اور company knowledge دو ایسے ٹولز کی توقع کرتے ہیں جن کی شکل طے شدہ ہے۔ یہ معیاری جوڑی کے طور پر ہر کلائنٹ کو فہرست میں دکھائے جاتے ہیں۔ یہ ایک تیز، عمومی داخلہ ہے: ایک آرگیومنٹ، بغیر دائرے کے۔ حدیث، تفسیر یا فقہ کے لیے shamela_search_library کو ترجیح دیں، اور دائرے، عین عبارت یا صفحہ بندی کے لیے shamela_search استعمال کریں۔

ٹولان پٹکیا لوٹاتا ہے
searchquery (عربی)results: { id, title, url } کے دس تک۔ id یعنی bookId:pageId؛ url مکتبہ ریڈر میں وہ صفحہ ہے۔
fetchsearch کے نتیجے سے id{ id, title, text, url, metadata }۔ text میں متن اور حاشیہ الگ رہتے ہیں، حاشیہ اپنے الگ لیبل کے تحت۔

دونوں ساختہ مواد اور وہی JSON بطور متن لوٹاتے ہیں۔ search بغیر دائرے کے ہے، اس لیے اس کی درجہ بندی shamela_search (match: 'words') جیسی ہے؛ جب آپ کے کلائنٹ کو یہ شکل درکار نہ ہو تو shamela_search_library کو ترجیح دیں۔

مطالعہ

ٹولکب استعمال کریں
shamela_read (unit: 'page')آپ کے پاس book_id + page_id ہے اور پورا صفحہ چاہیے — متن، حواشی، سب کچھ۔
shamela_read (unit: 'range')آپ کو بیس تک مسلسل صفحات چاہییں۔
shamela_read (unit: 'section')آپ کو کسی ایک باب کے عنوان کے تحت تمام صفحات چاہییں۔
shamela_read (unit: 'toc')کسی کتاب کی فہرستِ مضامین۔
shamela_read (unit: 'parts')کثیر جلدی تصنیف کی جلدیں۔
shamela_read (unit: 'services')کسی صفحے میں کون سی آیات، حدیث کے کلیدی نمبر اور اسناد (إسناد) کے نشانات ہیں۔

حوالے

ٹولکب استعمال کریں
shamela_cite (mode: 'printed_page')حوالے کی تصدیق۔ «جلد 4، صفحہ 405» کو ان صفحاتی شناخت کنندگان میں بدلیں جن میں وہ ہے۔
shamela_verify_quoteاقتباس کی جانچ۔ کیا یہ عربی عبارت لائبریری میں آتی ہے، اور کہاں: کتاب، چھپا ہوا صفحہ، متن یا حاشیہ۔ دیکھیں اے آئی کے نقل کردہ اقتباس کو چھپے صفحے سے جانچیں۔
shamela_find (kind: 'work')حوالہ دیے گئے عنوان (اور مصنف، اور ایڈیشن) کو فہرست کے اندراج سے ملائیں — یا انکار کریں۔
shamela_cite (mode: 'citation')حوالے کو تین اسلوب میں سے کسی ایک میں ترتیب دیں۔
shamela_find (kind: 'name')عربی نام کے ٹکڑے کو کتاب یا مصنف کی شناختوں تک پہنچائیں۔

پہلے دو ٹولز ہی اس سطح کے ہونے کی وجہ ہیں۔ “المغني، 4/405” جیسے دعوے کو مان لینے کے بجائے جانچا جا سکتا ہے: تصنیف کو ملائیں، صفحے کو ملائیں، اسے پڑھیں۔

اسناد (إسناد) اور راوی

ٹولکب استعمال کریں
shamela_lookup_rijal (mode: 'narrators')نام سے راوی تلاش کریں — 18,989 راوی، سنِ وفات 2 تا 774 ہجری۔
shamela_lookup_rijal (mode: 'narrator')مکمل تعارف: نسب، سنِ وفات، طبقہ، تعدیل و جرح کے اقوال (gradings)۔
shamela_lookup_rijal (mode: 'isnad_search')دس کتبِ حدیث میں فہرست شدہ 45,220 اسناد میں تلاش کریں۔
shamela_lookup_rijal (mode: 'isnad')ایک صفحے پر چھپی سند(یں)، راویوں کے ناموں کی شناخت کے ساتھ۔
shamela_lookup_hadith (mode: 'sources')ایک ہی حدیث کو درج کرنے والے تمام مجموعے، اس کی مشترکہ کلید کے ذریعے۔

قرآن اور تفسیر

ٹولکب استعمال کریں
shamela_lookup_quran (mode: 'search')6,236 آیات میں تلاش کریں (حفص عن عاصم)۔
shamela_lookup_quran (mode: 'aya')آیات نمبر سے، یا سورت + آیت سے حاصل کریں۔
shamela_lookup_tafsir (mode: 'coverage')کون سی تفسیری کتب اس آیت پر کلام کرتی ہیں، ہر ایک کے صفحے کے ساتھ، اور ان کتب کی واضح حالت جو اشاریے میں شامل نہیں۔ downloaded_only: false وہ کتب بھی شامل کرتا ہے جن کا متن سرور پر نہیں۔
shamela_lookup_tafsir (mode: 'texts')ایک آیت کے اصل تفسیری متون، مختلف ذرائع سے، ایک ہی کال میں۔

فہرست

ٹولکب استعمال کریں
shamela_find (kind: 'book')نام، مصنف یا کتابیاتی وضاحت سے کتابیں تلاش کریں۔
shamela_find (kind: 'author')نام یا سوانح سے مصنفین تلاش کریں۔
shamela_get_details (kind: 'book')ایک کتاب کا مکمل میٹاڈیٹا۔
shamela_get_details (kind: 'author')ایک مصنف کا مکمل میٹاڈیٹا، چاہیں تو ان کی کتب کے ساتھ۔
shamela_find (kind: 'category')کتب کی تعداد کے ساتھ تمام 41 زمرے۔
shamela_find (kind: 'period')فہرست کو دور کے لحاظ سے چھانٹیں، شرائط کو AND کے ساتھ ملا کر۔
shamela_get_briefپروگرام کے ذریعے کال کرنے والوں کے لیے لائبریری سرور کا اپنا عملی خلاصہ۔

پرامپٹس

تیار پرامپٹس جو آپ کا کلائنٹ فہرست کر سکتا ہے۔ ہر ایک انگریزی متن ہے جو ماڈل کو آپ کی زبان میں جواب دینے کو کہتا ہے۔

پرامپٹآرگومنٹسکیا کرتا ہے
takhrij_hadithtextکسی حدیث کو مجموعوں میں اس کی اسناد (إسناد) کے ساتھ تلاش کرتا ہے، اور اس کا درجہ کبھی نہیں بتاتا۔ حدیث کی تخریج دیکھیں۔
cite_passagetextکوئی عبارت ڈھونڈتا ہے اور ایڈیشن، جلد اور صفحے کے ساتھ اس کا حوالہ دیتا ہے۔
compare_tafsirsurah، ayahایک آیت پر دستیاب تفسیری کتب کے اقوال کا موازنہ کرتا ہے۔

ریسورس

qurangallery://grounding-rules ایک text/markdown ریسورس ہے جس میں حوالے کا معاہدہ ہے۔ بنیادی اصول دیکھیں۔

جو ظاہر نہیں کیا گیا

لائبریری سرور کے تین ٹولز روکے گئے ہیں، اور اس لیے نہیں کہ وہ طاقتور ہیں۔ وہ اس مشین کے بارے میں بتاتے ہیں جس پر سرور چلتا ہے، چنانچہ ریموٹ کال کرنے والا ہمارے انفراسٹرکچر کے حقائق پڑھ رہا ہوتا جبکہ وہ سمجھتا کہ لائبریری کے حقائق پڑھ رہا ہے:

  • shamela_list_downloaded_books — میزبان پر کیا ڈاؤن لوڈ ہے۔ shamela_find (kind: 'book') استعمال کریں، جو فہرست پڑھتا ہے، یا shamela_get_details (kind: 'book')، جو بتاتا ہے کہ کسی کتاب کا متن سرور پر ہے یا نہیں۔
  • shamela_check_health — سرور کا ورژن اور اندرونی تشخیص۔
  • shamela_get_guide — شاملہ ڈیسک ٹاپ ایکسٹینشن کی صارف گائیڈ، جو ایک ایسے انٹرفیس کو بیان کرتی ہے جو آپ کے پاس نہیں۔

مجموعۂ کتب کے بارے میں کچھ بھی روکا نہیں گیا۔

پرانے ٹول نام

لائبریری سرور کے ورژن 1.4.0 نے 39 ٹولز کو نو راؤٹرز میں ضم کر دیا۔ پرانے نام فہرست میں آئے بغیر اب بھی کام کرتے ہیں، اور نتیجے میں _meta.deprecated_alias نئے ٹول کا نام بتاتا ہے۔ انہیں اسی وقت ہٹایا جائے گا جب ان پر 14 دن تک کوئی کال نہ آئے۔ جدول ہر پرانے نام کے لیے نیا ٹول اور بھیجی جانے والی موڈ ویلیو دکھاتا ہے:

پرانا ناماب
shamela_books_by_periodshamela_find (kind: 'period')
shamela_briefshamela_get_brief
shamela_get_authorshamela_get_details (kind: 'author')
shamela_get_ayashamela_lookup_quran (mode: 'aya')
shamela_get_bookshamela_get_details (kind: 'book')
shamela_get_book_partsshamela_read (unit: 'parts')
shamela_get_book_sectionshamela_read (unit: 'section')
shamela_get_books_for_hadithshamela_lookup_hadith (mode: 'sources')
shamela_get_citationshamela_cite (mode: 'citation')
shamela_get_isnadshamela_lookup_rijal (mode: 'isnad')
shamela_get_narratorshamela_lookup_rijal (mode: 'narrator')
shamela_get_pageshamela_read (unit: 'page')
shamela_get_page_servicesshamela_read (unit: 'services')
shamela_get_pages_rangeshamela_read (unit: 'range')
shamela_get_tafseer_of_ayashamela_lookup_tafsir (mode: 'coverage')
shamela_get_tafseer_textsshamela_lookup_tafsir (mode: 'texts')
shamela_get_tocshamela_read (unit: 'toc')
shamela_guideshamela_get_guide
shamela_healthshamela_check_health
shamela_list_books_by_periodshamela_find (kind: 'period')
shamela_list_categoriesshamela_find (kind: 'category')
shamela_list_tafsirs_for_ayashamela_lookup_tafsir (mode: 'coverage')
shamela_reconshamela_survey_topic (root → term)
shamela_resolveshamela_find (kind: 'name')
shamela_resolve_nameshamela_find (kind: 'name')
shamela_resolve_printed_pageshamela_cite (mode: 'printed_page')
shamela_resolve_workshamela_find (kind: 'work')
shamela_root_statsshamela_survey_topic (mode: 'morphological') (root → term)
shamela_search_authorsshamela_find (kind: 'author')
shamela_search_batchshamela_search (match: 'batch') (probes → queries)
shamela_search_booksshamela_find (kind: 'book')
shamela_search_booleanshamela_search (match: 'boolean')
shamela_search_exactshamela_search (match: 'exact')
shamela_search_hadithshamela_lookup_hadith (mode: 'search')
shamela_search_isnadshamela_lookup_rijal (mode: 'isnad_search')
shamela_search_narratorsshamela_lookup_rijal (mode: 'narrators')
shamela_search_pagesshamela_search (match: 'words')
shamela_search_phraseshamela_search (match: 'phrase' or 'near') (mode → match)
shamela_search_quranshamela_lookup_quran (mode: 'search')
shamela_search_titlesshamela_find (kind: 'heading')

نئے نام استعمال کریں اور دوسرے کالم میں دکھایا گیا موڈ آرگیومنٹ بھیجیں۔

اگلے مراحل

سوالات

Quran Gallery MCP سرور میں کتنے ٹولز ہیں؟

15 صرف پڑھنے والے ٹولز، ہر کلائنٹ کے لیے یکساں۔ چار ہمارے اپنے ہیں اور 11 لائبریری سرور سے آتے ہیں۔

پہلے کون سا ٹول کال کروں؟

shamela_search_library۔ یہ اسکوپ لازمی کرتا ہے اور مطابقت کا طریقہ بتاتا ہے، جو زیادہ تر یہ متن کہاں ہے جیسے سوالوں کے لیے مناسب ہے۔

search اور fetch کس کام کے ہیں؟

یہ وہ معیاری جوڑی ہے جس کی ChatGPT کی گہری تحقیق توقع کرتی ہے: search پوری لائبریری میں ایک عربی سوال چلاتا ہے اور fetch کسی نتیجے کو اس کی id سے پڑھتا ہے۔

ٹول کے راؤٹر ہونے کا کیا مطلب ہے؟

ایک ہی ٹول نام کئی کارروائیاں سنبھالتا ہے، اور match، kind، unit یا mode جیسا آرگیومنٹ طے کرتا ہے کہ کون سی چلے۔

کیا سرور پرامپٹس یا ریسورسز دیتا ہے؟

جی ہاں: تین پرامپٹس takhrij_hadith، cite_passage اور compare_tafsir، اور ایک ریسورس qurangallery://grounding-rules۔

پورا صفحہ کیسے پڑھوں یا اقتباس کی تصدیق کیسے کروں؟

صفحہ پڑھنے کے لیے unit کو page رکھ کر shamela_read، اور یہ دیکھنے کے لیے کہ عربی اقتباس لائبریری میں ہے یا نہیں shamela_verify_quote استعمال کریں۔

اس صفحے کو GitHub پر ایڈٹ کریں