ক্লাসিক্যাল আরবি বইয়ের MCP টুল: পূর্ণ তালিকা

উনচল্লিশটি টুল, সবগুলো রিড-অনলি। তিনটি আমাদের নিজস্ব (search_library, search, fetch); ছত্রিশটি লাইব্রেরি সার্ভার থেকেই আসে এবং নিজ নামে, নিজ স্কিমাসহ প্রকাশিত। এগুলোর পাশাপাশি সার্ভার তিনটি প্রম্পট ও একটি রিসোর্স দেয়।

আপনার ক্লায়েন্ট সবগুলো তালিকাভুক্ত করবে। এই পৃষ্ঠাটি একটি মানচিত্র, যাতে আপনি জানেন কী আছে এবং কোনটি ধরতে হবে — প্রতিটি টুল তার নিজস্ব প্যারামিটার ডকুমেন্টেশন বহন করে, যে স্কিমা আপনার ক্লায়েন্ট ইতিমধ্যে পেয়েছে তাতে।

search_library দিয়ে শুরু করুন। এটি একটি স্কোপ চায় এবং কীভাবে মিলিয়েছে তা জানায়, যা “আমাকে এই পাঠ খুঁজে দাও”-র জন্য সঠিক ডিফল্ট। এটি যা পারে না তার জন্য কাঁচা shamela_* টুল ধরুন। সব কুয়েরি অবশ্যই আরবিতে হতে হবে।

সার্চ

টুল	কখন ব্যবহার করবেন
search_library	ডিফল্ট। উদ্ধৃতি ও মিলের বিবরণসহ স্কোপযুক্ত সার্চ। দেখুন এর রেফারেন্স।
search	ChatGPT deep research ও company knowledge। পুরো লাইব্রেরি জুড়ে একটি কুয়েরি; id, title, url-এর results ফেরত দেয়। বিস্তারিত নিচে।
shamela_search_pages	আপনি স্কোপ ছাড়া সহ কাঁচা পৃষ্ঠা সার্চ চান। টার্ম ফ্রিকোয়েন্সি দিয়ে র‍্যাঙ্ক করে — নিচের সতর্কতা পড়ুন।
shamela_search_phrase	আপনার একটি হুবহু পরপর বাক্যাংশ, বা নৈকট্য-মিল দরকার।
shamela_search_exact	হরকত (التشكيل) এবং হামযা/আলিফের রূপ হুবহু মিলতে হবে।
shamela_search_boolean	আপনার কেবল AND নয়, OR ও NOT দরকার।
shamela_search_titles	আপনি মূল পাঠ নয়, একটি অধ্যায় বা অংশের শিরোনাম খুঁজছেন।
shamela_search_hadith	আপনার কাছে একটি হাদীসের শব্দবিন্যাস আছে এবং সেটি বহনকারী সংকলনগুলো চান।
shamela_search_batch	এক কলে ১২টি পর্যন্ত স্কোপযুক্ত সার্চ, একত্র ও ডুপ্লিকেট-মুক্ত।
shamela_recon	সার্চের আগে: এই বিষয়ে লাইব্রেরিতে কত আছে, এবং কোন তাকগুলোতে?
shamela_root_stats	একটি আরবি মূল ধাতু লাইব্রেরি জুড়ে বিভাগ ও শতাব্দী অনুযায়ী কীভাবে ছড়িয়ে আছে।

shamela_search_pages স্কোপ ছাড়া চলবে, এবং সাধারণত চালানো উচিত নয়। র‍্যাঙ্কিং টার্ম ফ্রিকোয়েন্সি দিয়ে, যা পাণ্ডিত্যের কর্তৃত্ব সম্পর্কে কিছুই জানে না। স্কোপ ছাড়া التيمم ২৬,০৯৮টি ফলাফল দেয়, শীর্ষে ৭১০ হিজরির একটি কবিতা সংকলন, এবং إنما الأعمال بالنيات ৬,৮১৫টি ফলাফল দেয় যার মধ্যে সহীহ বুখারী কোথাও আসে না। একটি স্কোপ দিন, অথবা search_library ব্যবহার করুন।

search ও fetch

ChatGPT deep research ও company knowledge নির্দিষ্ট আকারের দুটি টুল প্রত্যাশা করে। অন্য ক্লায়েন্টও এগুলো ব্যবহার করতে পারে।

টুল	ইনপুট	ফেরত দেয়
search	query (আরবি)	results: { id, title, url }-এর সর্বোচ্চ ১০টি। id হলো bookId:pageId; url হলো shamela.ws-এ পৃষ্ঠাটি।
fetch	একটি search ফলাফল থেকে id	{ id, title, text, url, metadata }। text মূল পাঠ ও হাশিয়াকে আলাদা রাখে, হাশিয়া নিজস্ব লেবেলের অধীনে।

দুটিই কাঠামোবদ্ধ কনটেন্ট এবং টেক্সট হিসেবে একই JSON ফেরত দেয়। search স্কোপহীন, তাই shamela_search_pages-এর মতো র‍্যাঙ্ক করে; আপনার ক্লায়েন্টের এই আকার দরকার না হলে search_library পছন্দ করুন।

পড়া

টুল	কখন ব্যবহার করবেন
shamela_get_page	আপনার কাছে book_id + page_id আছে এবং পূর্ণ পৃষ্ঠা চান — মূল পাঠ, হাশিয়া, সব।
shamela_get_pages_range	আপনার পরপর ২০টি পর্যন্ত পৃষ্ঠা দরকার।
shamela_get_book_section	আপনি একটি অধ্যায়ের শিরোনামের অধীনে প্রতিটি পৃষ্ঠা চান।
shamela_get_toc	একটি বইয়ের সূচিপত্র।
shamela_get_book_parts	একটি বহু-খণ্ড গ্রন্থের খণ্ডগুলো।
shamela_get_page_services	একটি পৃষ্ঠা কোন আয়াত, হাদীসের কী এবং ইসনাদ (إسناد) চিহ্ন বহন করে।

উদ্ধৃতি

টুল	কখন ব্যবহার করবেন
shamela_resolve_printed_page	একটি উদ্ধৃতি যাচাই। «vol. 4, p. 405»-কে সেই পৃষ্ঠার আইডিতে রূপান্তর করুন।
shamela_resolve_work	উদ্ধৃত একটি শিরোনামকে (এবং গ্রন্থকার, ও সংস্করণ) একটি ক্যাটালগ এন্ট্রিতে সমাধান করুন — অথবা প্রত্যাখ্যান করুন।
shamela_get_citation	তিনটি শৈলীর একটিতে একটি উদ্ধৃতি সাজান।
shamela_resolve	একটি আরবি নামের অংশকে বই বা গ্রন্থকারের আইডিতে নির্দিষ্ট করুন।

প্রথম দুটিই এই সারফেসকে মূল্যবান করে। “al-Mughni, 4/405”-র মতো একটি দাবি বিশ্বাস না করে যাচাই করা যায়: কাজটি সমাধান করুন, পৃষ্ঠাটি সমাধান করুন, পড়ুন।

ইসনাদ (إسناد) ও বর্ণনাকারী

টুল	কখন ব্যবহার করবেন
shamela_search_narrators	নাম দিয়ে একজন বর্ণনাকারী খুঁজুন — ১৮,৯৮৯ জন, মৃত্যুসন ২–৭৭৪ হিজরি।
shamela_get_narrator	পূর্ণ ডসিয়ার: বংশপরিচয়, মৃত্যুসন, তবকা, মূল্যায়ন।
shamela_search_isnad	দশটি হাদীস গ্রন্থ জুড়ে ৪৫,২২০টি ইনডেক্স করা সূত্রে খুঁজুন।
shamela_get_isnad	একটি পৃষ্ঠায় ছাপা সূত্র(গুলো), বর্ণনাকারীদের নামসহ।
shamela_get_books_for_hadith	একই হাদীস লিপিবদ্ধকারী প্রতিটি সংকলন, তার শেয়ার্ড কী দিয়ে।

কুরআন ও তাফসীর

টুল	কখন ব্যবহার করবেন
shamela_search_quran	৬,২৩৬টি আয়াতে খুঁজুন (আসিম থেকে হাফস)।
shamela_get_aya	নম্বর দিয়ে, বা সূরা + আয়াত দিয়ে আয়াত আনুন।
shamela_get_tafseer_of_aya	কোন তাফসীর গ্রন্থ এই আয়াতের ব্যাখ্যা করে।
shamela_list_tafsirs_for_aya	আয়াতভিত্তিক তাফসীর কভারেজ রিপোর্ট।
shamela_get_tafseer_texts	একটি আয়াতের জন্য প্রকৃত ব্যাখ্যার পাঠ, একাধিক উৎস থেকে, এক কলে।

ক্যাটালগ

টুল	কখন ব্যবহার করবেন
shamela_search_books	নাম, গ্রন্থকার, বা গ্রন্থপঞ্জি বিবরণ দিয়ে বই খুঁজুন।
shamela_search_authors	নাম বা জীবনী দিয়ে গ্রন্থকার খুঁজুন।
shamela_get_book	একটি বইয়ের পূর্ণ মেটাডেটা।
shamela_get_author	একজন গ্রন্থকারের পূর্ণ মেটাডেটা, ঐচ্ছিকভাবে তাঁর বইসহ।
shamela_list_categories	বইয়ের সংখ্যাসহ সব ৪১টি বিভাগ।
shamela_books_by_period	যুগ অনুযায়ী ক্যাটালগ ফিল্টার করুন, শর্তগুলো AND দিয়ে মিলিয়ে।
shamela_brief	প্রোগ্রামেটিক কলকারীদের জন্য লাইব্রেরি সার্ভারের নিজস্ব অপারেটিং ব্রিফ।

প্রম্পট

তৈরি প্রম্পট যা আপনার ক্লায়েন্ট তালিকাভুক্ত করতে পারে। প্রতিটি ইংরেজি পাঠ, যা মডেলকে আপনার ভাষায় উত্তর দিতে বলে।

প্রম্পট	আর্গুমেন্ট	কী করে
takhrij_hadith	text	সংকলনগুলোতে একটি হাদীস ইসনাদ (إسناد)সহ খুঁজে বের করে, এবং কখনো তার মান নির্ণয় করে না। দেখুন হাদীসের তাখরীজ।
cite_passage	text	একটি অংশ খুঁজে সংস্করণ, খণ্ড ও পৃষ্ঠাসহ উদ্ধৃত করে।
compare_tafsir	surah, ayah	একটি আয়াতে উপলব্ধ তাফসীর গ্রন্থগুলো কী বলে তা তুলনা করে।

রিসোর্স

qurangallery://grounding-rules একটি text/markdown রিসোর্স, যা উদ্ধৃতি-চুক্তি ধারণ করে। দেখুন গ্রাউন্ডিং নিয়ম।

যা প্রকাশ করা হয় না

লাইব্রেরি সার্ভারের তিনটি টুল আটকে রাখা হয়েছে, এবং সেগুলো শক্তিশালী বলে নয়। এগুলো সার্ভার যে মেশিনে চলে তার সম্পর্কে রিপোর্ট করে, তাই একজন দূরবর্তী কলকারী আমাদের অবকাঠামো সম্পর্কে তথ্য পড়ত, অথচ ভাবত যে লাইব্রেরি সম্পর্কে তথ্য পড়ছে:

• shamela_list_downloaded_books — হোস্টে কী ডাউনলোড করা আছে। ক্যাটালগ পড়া shamela_search_books ব্যবহার করুন।
• shamela_health — সার্ভারের সংস্করণ ও অভ্যন্তরীণ ডায়াগনস্টিক্স।
• shamela_guide — শামেলা ডেস্কটপ এক্সটেনশনের ব্যবহার-নির্দেশিকা, এমন একটি ইন্টারফেস বর্ণনা করে যা আপনার নেই।

গ্রন্থভাণ্ডার সম্পর্কে কিছুই আটকে রাখা হয়নি।