تخطَّ إلى المحتوى

أدوات MCP للكتب العربية التراثية: القائمة الكاملة

أدوات خادم MCP لمعرض القرآن الـ15 للقراءة فقط، مع 3 موجّهات ومورد: بحث وقراءة وتوثيق وإسناد ورواة وتفسير وفهرس.

في هذه الصفحة

خمس عشرة أداة، هي نفسها لكل العملاء، كلها للقراءة فقط. أربع منها منا (shamela_search_library وsearch وfetch وshamela_verify_quote)؛ وإحدى عشرة من خادم المكتبة نفسه. تسع من هذه الإحدى عشرة أدوات موجِّهة: تأخذ كل واحدة منها وسيطًا واحدًا للنمط (match أو kind أو unit أو mode) يحدد ما تفعله، وتعرض الجداول أدناه كل نمط في صف مستقل. وsearch وfetch هما الزوج القياسي الذي يشترطه البحث المعمّق في ChatGPT، ويراهما كل عميل. وبجانب الأدوات يقدم الخادم ثلاثة موجّهات وموردًا واحدًا.

سيعرضها عميلك لك. وهذه الصفحة خريطة، لتعرف ما الموجود وأيّها تتناول — فكل أداة تحمل توثيق معاملاتها في المخطط الذي تلقاه عميلك فعلًا.

ابدأ بـshamela_search_library. فهي تشترط نطاقًا وتبلّغ عن كيفية المطابقة، وهذا الافتراض الصحيح لطلب «اعثر لي على هذا النص». وتناول أدوات shamela_* الخام حين تحتاج ما تعجز عنه. وكل الاستعلامات يجب أن تكون بالعربية.

البحث

الأداةاستعملها حين
shamela_search_libraryالافتراضية. بحث بنطاق مع توثيق وإبلاغ عن المطابقة. انظر مرجعها.
searchالبحث المعمّق ومعرفة الشركة في ChatGPT. استعلام واحد في المكتبة كلها؛ يعيد results من id وtitle وurl. التفاصيل أدناه.
shamela_search (match: 'words')تريد بحث الصفحات الخام، بما فيه بلا نطاق. يرتّب بحسب تكرار المصطلح — اقرأ التحذير أدناه.
shamela_search (match: 'phrase')تحتاج عبارة متتابعة بنصها، أو مطابقة بالتقارب.
shamela_search (match: 'exact')يجب أن يطابق التشكيل وصور الهمزة والألف تمامًا.
shamela_search (match: 'boolean')تحتاج OR وNOT لا AND فقط.
shamela_find (kind: 'heading')تبحث عن عنوان فصل أو باب لا عن نص المتن.
shamela_lookup_hadith (mode: 'search')لديك لفظ حديث وتريد المجاميع التي تحمله.
shamela_search (match: 'batch')حتى 24 بحثًا بنطاق في استدعاء واحد، مدموجة ومنزوعة التكرار.
shamela_survey_topicقبل البحث: كم تحوي المكتبة في مصطلح ما، وعلى أي رفوف وقرون وكتب ومؤلفين؟ يعدّ الكلمة كما كُتبت افتراضيًا؛ وmode: 'morphological' يعدّ كل صيغ جذرها.

تعمل shamela_search (match: 'words') بلا نطاق، وغالبًا لا ينبغي ذلك. فالترتيب بحسب تكرار المصطلح، وهو لا يعرف شيئًا عن مرجعية العلماء. فبلا نطاق يعيد التيمم 26,098 نتيجة يتصدرها ديوان شعر من 710 هـ، ويعيد إنما الأعمال بالنيات 6,815 نتيجة لا يظهر فيها صحيح البخاري. فمرّر نطاقًا، أو استعمل shamela_search_library.

search وfetch

يتوقع البحث المعمّق ومعرفة الشركة في ChatGPT أداتين بشكلين ثابتين. وتُعرضان لكل العملاء بوصفهما الزوج القياسي. وهما مدخل عام سريع: وسيط واحد وبلا نطاق. وفي الحديث والتفسير والفقه يُفضَّل shamela_search_library، وتُستعمل shamela_search عند الحاجة إلى نطاق أو عبارة مطابقة أو ترقيم الصفحات.

الأداةالمدخلما تعيده
searchquery (بالعربية)results: حتى 10 من { id, title, url }. وid هو bookId:pageId؛ وurl هو الصفحة في قارئ المكتبة.
fetchid من نتيجة search{ 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')تحتاج حتى 20 صفحة متتالية.
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')الترجمة كاملة: النسب وسنة الوفاة والطبقة وأقوال النقاد.
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')

استعمل الأسماء الجديدة وأرسل وسيط النمط المبيّن في العمود الثاني.

الخطوات التالية

أسئلة

كم أداة في خادم MCP لمعرض القرآن؟

15 أداة للقراءة فقط، وهي نفسها لكل عميل: أربع منها من عندنا وإحدى عشرة من خادم المكتبة نفسه.

بأي أداة أبدأ؟

shamela_search_library. تشترط نطاقًا وتبيّن كيف وقعت المطابقة، وهذا يناسب أكثر أسئلة «أين يوجد هذا النص».

ما فائدة search وfetch؟

هما الزوج المعياري الذي يتوقعه البحث العميق في ChatGPT: search يأخذ استعلامًا عربيًا واحدًا عبر المكتبة كلها، وfetch يقرأ نتيجة بمعرّفها.

ماذا يعني أن الأداة موجِّهة (router)؟

يغطي اسم أداة واحد عدة عمليات، ووسيط مثل match أو kind أو unit أو mode يحدد العملية المنفَّذة.

هل يقدّم الخادم موجّهات أو موارد؟

نعم: ثلاثة موجّهات هي takhrij_hadith وcite_passage وcompare_tafsir، ومورد واحد هو qurangallery://grounding-rules.

كيف أقرأ صفحة كاملة أو أتحقق من اقتباس؟

استعمل shamela_read مع unit بقيمة page لقراءة صفحة، وshamela_verify_quote لمعرفة هل يرد نص عربي في المكتبة.

عدّل هذه الصفحة على GitHub