Releases: alhoqbani/shamela-mcp
Release list
v1.3.0 — أربعٌ وثلاثون أداة، وبحثٌ يجري داخل المحرّك
إصدارٌ واحدٌ جامع: أربع أدوات جديدة ترفع العدد من ثلاثين إلى أربعٍ وثلاثين، وبحثُ العبارة والمنطق صار يجري داخل محرك الشاملة نفسه بدل أن يُرشَّح من نافذةٍ صغيرة، وثمانيةٌ وخمسون إصلاحًا في ما تقوله الأدوات لا فيما تحسبه. والإضافة تقرأ كتبك من ملفات المكتبة الشاملة الموجودة على جهازك نفسه.
ماذا يعني التحديث لك باختصار؟
- تتحقَّق من نصٍّ منقول: أثابتٌ هو في الصفحة المعزوّ إليها بحروفه، أم بفروقٍ مسمّاة، أم غير موجود.
- تحرِّر محل النزاع في مسألة: أين نُقل الإجماع وأين نُقل الخلاف، بالشواهد لا بالحكم.
- تعرف تغطية المذاهب الأربعة بصفوف الصفر: أسكوتٌ هو أم لم تُقرأ كتبه أصلًا.
- بحث العبارة صار من المكتبة كلها لا من أول مئة نتيجة.
- وأسئلةٌ كانت تعود بصفرٍ صامت صارت تعود بنتائج.
الأدوات الأربع الجديدة
١. التحقُّق من نصٍّ منقول في الصفحة المعزوّ إليها، مع بيان أفي المتن هو أم في حاشية المحقِّق — shamela_verify_quote
٢. مسح المسألة على صيغ الإجماع وصيغ الخلاف بشواهدها وانتشارها في المذاهب — shamela_scan_consensus
٣. إيصال تغطية المذاهب الأربعة، وفيه صفٌّ لكل مذهب ولو كان صفرًا — shamela_research_scope
٤. إرشادٌ إلى كتابٍ لا تجده: أمنزَّلٌ هو عندك، أم متاحٌ للتنزيل، أم في الفهرس دون إتاحة — shamela_suggest_download
ما تغيّر في الأعداد نفسها — اقرأه قبل أن تقارن بنتائجك القديمة
الإضافة متوافقةٌ مع ما قبلها: لم تُحذف أداة، ولا غُيّر اسمُ أداة، ولا حُذف حقلٌ من المخرجات ولا تغيّر نوعُه. فما بُني على ١٫٢٫٠ يعمل على ١٫٣٫٠.
لكنّ الجواب على السؤال نفسه تغيّر — لا لأن شيئًا فسد، بل لأن ما كان يُحجب صار يظهر. فمن قيّد أعدادًا من ١٫٢٫٠ في بحثٍ أو ورقة، فليعد قياسها:
| السؤال | في ١٫٢٫٠ | في ١٫٣٫٠ |
|---|---|---|
| بحثٌ فيه همزة («شيء»، «بريء») | صفرٌ في مواضع كثيرة | نتائج — بمطابقة جدول محلّل الشاملة نفسه |
| كتبٌ معرِّفها ينتهي بأقلّ من ١٠٠ | ٨٪ من المكتبة غير مقروءة | تُقرأ كلُّها |
| بحثٌ من ست كلماتٍ فأكثر | صفرٌ صامت بلا خطأ ولا تنبيه | نتائج، مع بيان الكلمة التي أُسقطت |
| «كتاب منزَّل عندي؟» | علامةٌ في الفهرس قد تكذب | وجودُ الملف نفسه هو الحكم |
| بحث العبارة والمنطق | من أول مئة مرشَّحة | من المكتبة كلِّها داخل المحرّك |
| تفسير آية | فهرس الشاملة المنتقى وحده | فهرسٌ يُبنى من عناوين كتبك، فيبلغ أكثر تفاسيرك |
وأثقلُ هذه في أثره: الصفر الصامت. فبحثٌ يعيد صفرًا يُقرأ «ليس في التراث»، وكان في ثلاث حالاتٍ منها يعني «الإضافة لم تنظر».
البحث صار يجري داخل المحرّك
كانت أدواتُ العبارة والتقارب والمنطق تعمل على مرحلتين: تجلب نافذةً من مئة صفحة، ثم تُرشِّحها. فعبارةٌ في ألوف الصفحات يُحكم عليها من أول مئة. وصار السؤال يُطرح على الفهرس نفسه: «خيار المجلس» من مئة مرشَّحة إلى ١٬٩٥٩ نتيجة في ٣٠٩ كتب في نصف ثانية. ومعه إحصاءُ انتشار الجذر العربي في المكتبة بالتصنيف والقرن والكتاب والمؤلف.
التفسير
بُني فهرسُ «آية ⟵ صفحة» من عناوين كتبك المنزَّلة، فبلغ ما لا يبلغه فهرس الشاملة المنتقى. ونصّ التفسير صار يبدأ عند الآية لا عند رأس الصفحة، ويُكمل إلى الصفحة التالية إذا انقطع.
أبرز الإصلاحات
- كلُّ إحالةٍ تحمل الآن عنوانًا يُفتح (
shamela.ws/book/{id}/{page})، مبنيًّا على معرِّف الصفحة لا على رقمها المطبوع. - كلُّ نتيجةٍ تقول كم كتابًا بُحث فيه، لا كم وُجد فقط.
- ويمكن وسمُ النتائج أصلًا أو نقلًا: أهي من كتب صاحب القول أم من كتابٍ ناقلٍ عنه.
- ومقتطفٌ حول عبارةٍ بعينها داخل الصفحة، بدل تصفّح المتن كلِّه.
- المتن والحاشية لا يختلطان في بحث الحديث، وسنةُ تأريخ الكتاب لم تعد تُسمَّى سنةَ تأليف.
- أداة تغطية التفاسير تعمل على المكتبات الكبيرة: كانت تُخرج صفًّا لكل كتابٍ في رفوف التفسير دفعةً واحدة — سبعَ مئةٍ وثمانيةً وثلاثين صفًّا على مكتبةٍ كاملة — فيتجاوز الجوابُ الحدَّ المسموح ويُرفض كلُّه. صارت تُصفَّح، والإحصاءُ يشمل الرفَّ كلَّه كما كان.
لغة الإضافة
تتكلم الإضافة العربية افتراضًا، وتقبل الإنجليزية لمن يقرأ المصادر العربية ولا يقرأ واجهةً عربية — ويشمل ذلك الدليل المدمج كلَّه. ومن عرف الكتاب باسم Mughni والمؤلف باسم Ibn Qudama كتبها فتبلغه «المغني» و«ابن قدامة»، يُبنى ذلك من بيانات الشاملة نفسها بلا نموذجٍ ولا تنزيلٍ ولا شبكة.
طريقة التثبيت
١. إن كانت عندك نسخة سابقة من الإضافة فاحذفها أولًا من Settings → Extensions ثم Uninstall.
٢. نزّل الملف المرفق أسفل هذه الصفحة: shamela-mcp-1.3.0.mcpb، وافتحه بتطبيق Claude Desktop.
٣. المطلوب فقط: تطبيق المكتبة الشاملة ٤ مثبت على جهازك وفيه كتب منزلة.
الخصوصية
الإضافة تقرأ ملفات الشاملة من جهازك قراءةً فقط ولا تغير فيها شيئًا، ومن دون أي خادم وسيط خاص بها. وما يُعرض داخل تطبيق كلود يخضع لسياسة التطبيق المعتادة.
أرقام: أربعٌ وثلاثون أداة · ٩٠٧ اختبارات آلية · فهرس الشاملة ٨٬٥٩٨ كتابًا.
ما سُحب: أداةُ تصدير الكتاب كاملًا، بُنيت في هذا الإصدار ثم سُحبت قبل شحنه: مصبُّها الوحيد هو المحادثة، والمقيس على «الروض المربع» (١٬٦٠٧ صفحات) سبعةٌ وستون استدعاءً ونحو ١٫٢ مليون حرف — فهي تدعو إلى دورةٍ تموت في ثلثها. والتصديرُ موطنه سكربتٌ محليّ يكتب ملفًا.
ملاحظات الإصدار الكاملة في docs/release-1.3.0.md، وسجلُّ ما رُوجع قبل الدمج في docs/review-1.3.0.md.
v1.2.0 — ثلاثون أداة بحثٍ وقراءة ودليل استخدام مدمج
تحديث كبير للإضافة: عشر أدوات جديدة ترفع عدد الأدوات من عشرين إلى ثلاثين، ودليل استخدام مدمج يظهر متى سألت كلود عن قدرات الإضافة. والإضافة تقرأ كتبك من ملفات المكتبة الشاملة الموجودة على جهازك نفسه.
ماذا يعني التحديث لك باختصار؟
- تبحث بطرق لم تكن ممكنة: عبارة كاملة بنصها، أو لفظ بضبطه وهمزاته، أو حديث لا تعرف إلا طرفه.
- تسأل عن آية فتعرف أيَّ تفاسيرك المنزلة تناولها، وتقرأ كلامها من عدة تفاسير معًا منسوبًا لأصحابه.
- تُحصي ورود كلمة أو جذر عبر القرون والتصنيفات، وتستعرض الكتب بحسب زمنها.
- أول استخدام أسرع، والتعامل مع المكتبات الكبيرة أثبت.
الأدوات العشر الجديدة
١. البحث عن عبارة كاملة بنصها كما هي («إنما الأعمال بالنيات») — shamela_search_phrase
٢. بحث دقيق يفرق بين الهمزات والتشكيل والأرقام لمن أراد اللفظ بعينه — shamela_search_exact
٣. بحث يجمع كلمات أو يستبعد أخرى: هذه أو تلك، هذه دون تلك — shamela_search_boolean
٤. البحث عن حديث ببعض لفظه، مع تخريجه حيث توفرت بياناته — shamela_search_hadith
٥. إحصاء ورود كلمة أو جذر عبر القرون والتصنيفات والكتب والمؤلفين — shamela_root_stats
٦. استعراض الكتب بحسب زمن تأليفها أو زمن وفاة مؤلفيها — shamela_books_by_period
٧. معرفة أي تفاسيرك المنزلة تناول آية بعينها، بجواب صريح لا تخمين فيه — shamela_list_tafsirs_for_aya
٨. قراءة تفسير الآية من عدة تفاسير دفعة واحدة مع نسبة كل قول لقائله — shamela_get_tafseer_texts
٩. فحص فوري يطمئنك أن الإضافة متصلة بمكتبتك وتعمل — shamela_health
١٠. دليل استخدام كامل بالعربية يظهر متى سألت: «ماذا تستطيع هذه الإضافة؟» — shamela_guide
قريبًا: منهجيات بحثٍ موجَّهة في «مهارة الشاملة»
تُعدُّ الآن «مهارة الشاملة» المستقلة: منهجياتٌ بحثية جاهزة (دراسة مسألة فقهية، مقارنة المذاهب، تخريج حديث، مقارنة تفاسير آية، دراسة نازلة معاصرة، إعداد خطة بحث) تُرشد كلود خطوةً خطوة بأدوات الإضافة الثلاثين على منهجٍ علميٍّ مرتَّب، ويُعلَن عنها عند جاهزيتها.
وإلى حينها، اكتب طلبك بالعربية بأسلوبك الحر؛ وكلَّما وصفت مرادك ومصادرك دقَّ الجواب وعزوُه، ودليلُ الاستخدام المدمج يعرّفك بكل أداة بمثالها (اسأل: «ماذا تستطيع أدوات الشاملة؟»).
أبرز الإصلاحات والتحسينات
- أول استخدام أسرع وأثبت: كان أول سؤال بعد فتح التطبيق يتأخر نحو اثنتي عشرة ثانية وربما انقطع برسالة خطأ — الآن يتجهز المحرك مسبقًا فور التشغيل.
- بحث القرآن يجد ما كان يفوته: كلمة مثل «الصبر» كانت ترجع صفر نتيجة لاختلاف «أل» التعريف وحروف الجر — أصبح يبحث بجميع الصور ويخبرك أن النتائج مكتملة.
- النصوص الطويلة تصل أجزاءً مرتبة بدل أن تُقتطع أو تُغرق الشاشة.
- بيانات الكتاب أصدق وأوفى: تعرف هل الكتاب مقروء فعلًا أم منزل بلا صفحات، ويظهر محقق الكتاب وناشره متى وُجدا في اسمه — من غير اختراع أي معلومة.
- الكتب التي لا يُعرف تاريخها تظهر بوسم «غير مؤرَّخ» بدل نسبتها إلى قرن غير صحيح.
- إصلاح توقف كان يحدث عند استعراض أعداد كبيرة من الكتب المنزلة.
- توافق مع تثبيتات الشاملة الأحدث التي تغير أسماء مجلداتها الداخلية.
- ضوابط أمانة مدمجة: كلود لا يكمل النصوص من عنده، ويميز كلام المؤلف من حاشية المحقق، ويعرض أقوال المذاهب بحياد من غير ترجيح إلا أن تطلبه، ويصرح متى كان ترقيم الصفحات آليًّا من الشاملة.
طريقة التثبيت
١. نزّل الملف المرفق أسفل هذه الصفحة: shamela-mcp-1.2.0.mcpb.
٢. افتحه بتطبيق Claude Desktop — وإن كانت عندك نسخة سابقة فستُستبدل تلقائيًا.
٣. المطلوب فقط: تطبيق المكتبة الشاملة ٤ مثبت على جهازك وفيه كتب منزلة.
الخصوصية
الإضافة تقرأ ملفات الشاملة من جهازك قراءةً فقط ولا تغير فيها شيئًا، ومن دون أي خادم وسيط خاص بها. وما يُعرض داخل تطبيق كلود يخضع لسياسة التطبيق المعتادة.
تفاصيل تقنية أوفى في طلب الدمج #30. يعالج هذا الإصدار ما رُصد في التقارير #11–#27، وأسبابًا مرجحة لبلاغات التثبيت في #3 و#4 و#6–#8.
v1.0.2 — ASCII display name (Claude Desktop Chat fix)
ما الجديد
إصلاح مشكلة عدم عمل الأدوات في «شات» تطبيق كلود: الاسم الظاهر للإضافة أصبح بالإنجليزية (Search and Study in the Shamela Library)، لأن واجهة الشات تعجز بصمت عن تنفيذ أدوات أي إضافة اسمها الظاهر بغير الحروف اللاتينية — التفاصيل والأدلة في #10 و#28. الوصف العربي للإضافة لم يتغير.
تنبيه بعد التحديث: سيظهر الموصل باسم جديد في قائمة أدوات المحادثة ويكون معطلًا افتراضيًا — فعّلوه مرة واحدة من قائمة الأدوات في صندوق الكتابة.
What's new
display_nameis now ASCII so Claude Desktop Chat can execute the tools (#10, fixed in #28). The Arabicdescriptionis unchanged.- The in-code version constant now matches the release:
serverInforeports 1.0.2 (it previously announced 1.0.0 — the mismatch noted in #27).
Post-update note: chat connector toggles are keyed by display name, so the connector re-registers under the new name and defaults to OFF in chats — enable it once.
التثبيت / Install
Download shamela-mcp-1.0.2.mcpb below, then: Claude Desktop → Settings → Extensions → Install from file.
v1.0.1
What's Changed
- fix: probe arm64/x86_64 JRE paths on macOS by @ziedhajsalah in #1
- docs: add macOS JRE workaround to troubleshooting by @ziedhajsalah in #2
New Contributors
- @ziedhajsalah made their first contribution in #1
Full Changelog: v1.0.0...v1.0.1