ক্লাসিক্যাল আরবি বইয়ের MCP টুল: পূর্ণ তালিকা
Quran Gallery MCP সার্ভারের ১৫টি রিড-অনলি টুল, সঙ্গে ৩টি প্রম্পট ও একটি রিসোর্স: সার্চ, পড়া, উদ্ধৃতি, ইসনাদ, বর্ণনাকারী, তাফসীর, ক্যাটালগ।
এই পাতায়
পনেরোটি টুল, সব ক্লায়েন্টের জন্য একই, সবগুলো রিড-অনলি। চারটি আমাদের নিজস্ব (shamela_search_library, search, fetch, shamela_verify_quote); এগারোটি লাইব্রেরি সার্ভার থেকেই আসে। এই এগারোটির নয়টি রাউটার: প্রতিটি একটি মোড আর্গুমেন্ট (match, kind, unit বা mode) নেয়, যা ঠিক করে সেটি কী করবে, এবং নিচের টেবিলগুলোতে প্রতিটি মোড আলাদা সারিতে দেওয়া আছে। search ও fetch হলো ChatGPT deep research-এর দরকারি আদর্শ জোড়া, এবং সব ক্লায়েন্টই এগুলো দেখে। টুলগুলোর পাশাপাশি সার্ভার তিনটি প্রম্পট ও একটি রিসোর্স দেয়।
আপনার ক্লায়েন্ট এগুলো আপনার জন্য তালিকাভুক্ত করে। এই পৃষ্ঠাটি একটি মানচিত্র, যাতে আপনি জানেন কী আছে এবং কোনটি ধরতে হবে — প্রতিটি টুল তার নিজস্ব প্যারামিটার ডকুমেন্টেশন বহন করে, যে স্কিমা আপনার ক্লায়েন্ট ইতিমধ্যে পেয়েছে তাতে।
shamela_search_libraryদিয়ে শুরু করুন। এটি একটি স্কোপ চায় এবং কীভাবে মিলিয়েছে তা জানায়, যা “আমাকে এই পাঠ খুঁজে দাও”-র জন্য সঠিক ডিফল্ট। এটি যা পারে না তার জন্য কাঁচাshamela_*টুল ধরুন। সব কুয়েরি অবশ্যই আরবিতে হতে হবে।
সার্চ
| টুল | কখন ব্যবহার করবেন |
|---|---|
shamela_search_library | ডিফল্ট। উদ্ধৃতি ও মিলের বিবরণসহ স্কোপযুক্ত সার্চ। দেখুন এর রেফারেন্স। |
search | ChatGPT 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') স্কোপ ছাড়া চলবে, এবং সাধারণত চালানো উচিত নয়। র্যাঙ্কিং টার্ম ফ্রিকোয়েন্সি দিয়ে, যা পাণ্ডিত্যের কর্তৃত্ব সম্পর্কে কিছুই জানে না। স্কোপ ছাড়াالتيمم২৬,০৯৮টি ফলাফল দেয়, শীর্ষে ৭১০ হিজরির একটি কবিতা সংকলন, এবংإنما الأعمال بالنيات৬,৮১৫টি ফলাফল দেয় যার মধ্যে সহীহ বুখারী কোথাও আসে না। একটি স্কোপ দিন, অথবাshamela_search_libraryব্যবহার করুন।
search ও fetch
ChatGPT deep research ও company knowledge নির্দিষ্ট আকারের দুটি টুল প্রত্যাশা করে। এগুলো আদর্শ জোড়া হিসেবে সব ক্লায়েন্টকে তালিকায় দেখানো হয়। এটি দ্রুত, সাধারণ প্রবেশপথ: একটি আর্গুমেন্ট, স্কোপ ছাড়া। হাদিস, তাফসীর বা ফিকহের জন্য shamela_search_library ভালো, আর স্কোপ, হুবহু বাক্যাংশ বা পেজিং লাগলে shamela_search ব্যবহার করুন।
| টুল | ইনপুট | ফেরত দেয় |
|---|---|---|
search | query (আরবি) | results: { id, title, url }-এর সর্বোচ্চ ১০টি। id হলো bookId:pageId; url হলো মাকতাবাহ রিডারে পৃষ্ঠাটি। |
fetch | একটি search ফলাফল থেকে 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') | একটি উদ্ধৃতি যাচাই। «vol. 4, p. 405»-কে সেই পৃষ্ঠার আইডিতে রূপান্তর করুন। |
shamela_verify_quote | একটি উদ্ধৃতি যাচাই। এই আরবি বাক্য লাইব্রেরিতে আছে কি না, এবং কোথায়: বই, ছাপা পৃষ্ঠা, মূল পাঠ বা হাশিয়া। দেখুন এআই-এর উদ্ধৃতি ছাপা পৃষ্ঠার সঙ্গে মিলিয়ে যাচাই করুন। |
shamela_find (kind: 'work') | উদ্ধৃত একটি শিরোনামকে (এবং গ্রন্থকার, ও সংস্করণ) একটি ক্যাটালগ এন্ট্রিতে সমাধান করুন — অথবা প্রত্যাখ্যান করুন। |
shamela_cite (mode: 'citation') | তিনটি শৈলীর একটিতে একটি উদ্ধৃতি সাজান। |
shamela_find (kind: 'name') | একটি আরবি নামের অংশকে বই বা গ্রন্থকারের আইডিতে নির্দিষ্ট করুন। |
প্রথম দুটিই এই সারফেসকে মূল্যবান করে। “al-Mughni, 4/405”-র মতো একটি দাবি বিশ্বাস না করে যাচাই করা যায়: কাজটি সমাধান করুন, পৃষ্ঠাটি সমাধান করুন, পড়ুন।
ইসনাদ (إسناد) ও বর্ণনাকারী
| টুল | কখন ব্যবহার করবেন |
|---|---|
shamela_lookup_rijal (mode: 'narrators') | নাম দিয়ে একজন বর্ণনাকারী খুঁজুন — ১৮,৯৮৯ জন, মৃত্যুসন ২–৭৭৪ হিজরি। |
shamela_lookup_rijal (mode: 'narrator') | পূর্ণ ডসিয়ার: বংশপরিচয়, মৃত্যুসন, তবকা, মূল্যায়ন। |
shamela_lookup_rijal (mode: 'isnad_search') | দশটি হাদীস গ্রন্থ জুড়ে ৪৫,২২০টি ইনডেক্স করা সূত্রে খুঁজুন। |
shamela_lookup_rijal (mode: 'isnad') | একটি পৃষ্ঠায় ছাপা সূত্র(গুলো), বর্ণনাকারীদের নামসহ। |
shamela_lookup_hadith (mode: 'sources') | একই হাদীস লিপিবদ্ধকারী প্রতিটি সংকলন, তার শেয়ার্ড কী দিয়ে। |
কুরআন ও তাফসীর
| টুল | কখন ব্যবহার করবেন |
|---|---|
shamela_lookup_quran (mode: 'search') | ৬,২৩৬টি আয়াতে খুঁজুন (আসিম থেকে হাফস)। |
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') | বইয়ের সংখ্যাসহ সব ৪১টি বিভাগ। |
shamela_find (kind: 'period') | যুগ অনুযায়ী ক্যাটালগ ফিল্টার করুন, শর্তগুলো AND দিয়ে মিলিয়ে। |
shamela_get_brief | প্রোগ্রামেটিক কলকারীদের জন্য লাইব্রেরি সার্ভারের নিজস্ব অপারেটিং ব্রিফ। |
প্রম্পট
তৈরি প্রম্পট যা আপনার ক্লায়েন্ট তালিকাভুক্ত করতে পারে। প্রতিটি ইংরেজি পাঠ, যা মডেলকে আপনার ভাষায় উত্তর দিতে বলে।
| প্রম্পট | আর্গুমেন্ট | কী করে |
|---|---|---|
takhrij_hadith | text | সংকলনগুলোতে একটি হাদীস ইসনাদ (إسناد)সহ খুঁজে বের করে, এবং কখনো তার মান নির্ণয় করে না। দেখুন হাদীসের তাখরীজ। |
cite_passage | text | একটি অংশ খুঁজে সংস্করণ, খণ্ড ও পৃষ্ঠাসহ উদ্ধৃত করে। |
compare_tafsir | surah, 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 ৩৯টি টুলকে নয়টি রাউটারে একত্র করেছে। পুরোনো নামগুলো তালিকায় না থেকেও কাজ করে, এবং ফলাফলে _meta.deprecated_alias নতুন টুলের নাম জানায়। পুরোনো নামে ১৪ দিন কোনো কল না এলে তবেই সেগুলো সরানো হবে। নিচের টেবিলে প্রতিটি পুরোনো নামের জন্য নতুন টুল এবং পাঠানোর মোড-মান দেখানো হয়েছে:
| পুরোনো নাম | এখন |
|---|---|
shamela_books_by_period | shamela_find (kind: 'period') |
shamela_brief | shamela_get_brief |
shamela_get_author | shamela_get_details (kind: 'author') |
shamela_get_aya | shamela_lookup_quran (mode: 'aya') |
shamela_get_book | shamela_get_details (kind: 'book') |
shamela_get_book_parts | shamela_read (unit: 'parts') |
shamela_get_book_section | shamela_read (unit: 'section') |
shamela_get_books_for_hadith | shamela_lookup_hadith (mode: 'sources') |
shamela_get_citation | shamela_cite (mode: 'citation') |
shamela_get_isnad | shamela_lookup_rijal (mode: 'isnad') |
shamela_get_narrator | shamela_lookup_rijal (mode: 'narrator') |
shamela_get_page | shamela_read (unit: 'page') |
shamela_get_page_services | shamela_read (unit: 'services') |
shamela_get_pages_range | shamela_read (unit: 'range') |
shamela_get_tafseer_of_aya | shamela_lookup_tafsir (mode: 'coverage') |
shamela_get_tafseer_texts | shamela_lookup_tafsir (mode: 'texts') |
shamela_get_toc | shamela_read (unit: 'toc') |
shamela_guide | shamela_get_guide |
shamela_health | shamela_check_health |
shamela_list_books_by_period | shamela_find (kind: 'period') |
shamela_list_categories | shamela_find (kind: 'category') |
shamela_list_tafsirs_for_aya | shamela_lookup_tafsir (mode: 'coverage') |
shamela_recon | shamela_survey_topic (root → term) |
shamela_resolve | shamela_find (kind: 'name') |
shamela_resolve_name | shamela_find (kind: 'name') |
shamela_resolve_printed_page | shamela_cite (mode: 'printed_page') |
shamela_resolve_work | shamela_find (kind: 'work') |
shamela_root_stats | shamela_survey_topic (mode: 'morphological') (root → term) |
shamela_search_authors | shamela_find (kind: 'author') |
shamela_search_batch | shamela_search (match: 'batch') (probes → queries) |
shamela_search_books | shamela_find (kind: 'book') |
shamela_search_boolean | shamela_search (match: 'boolean') |
shamela_search_exact | shamela_search (match: 'exact') |
shamela_search_hadith | shamela_lookup_hadith (mode: 'search') |
shamela_search_isnad | shamela_lookup_rijal (mode: 'isnad_search') |
shamela_search_narrators | shamela_lookup_rijal (mode: 'narrators') |
shamela_search_pages | shamela_search (match: 'words') |
shamela_search_phrase | shamela_search (match: 'phrase' or 'near') (mode → match) |
shamela_search_quran | shamela_lookup_quran (mode: 'search') |
shamela_search_titles | shamela_find (kind: 'heading') |
নতুন নামগুলো ব্যবহার করুন এবং দ্বিতীয় কলামে দেখানো মোড আর্গুমেন্ট পাঠান।
পরবর্তী ধাপ
প্রশ্ন
Quran Gallery MCP সার্ভারে কয়টি টুল আছে?
১৫টি শুধু-পঠনযোগ্য টুল, প্রতিটি ক্লায়েন্টের জন্য একই। চারটি আমাদের নিজস্ব আর এগারোটি লাইব্রেরি সার্ভার থেকে আসে।
প্রথমে কোন টুল কল করব?
shamela_search_library। এটি স্কোপ বাধ্যতামূলক করে ও মিল কীভাবে হয়েছে জানায়, যা বেশির ভাগ এই পাঠ কোথায় আছে ধরনের প্রশ্নের জন্য উপযুক্ত।
search ও fetch কীসের জন্য?
এ দুটি ChatGPT deep research-এর প্রত্যাশিত মানক জোড়া: search পুরো লাইব্রেরিতে একটি আরবি কোয়েরি চালায় এবং fetch আইডি দিয়ে ফলাফল পড়ে।
টুল router হওয়ার মানে কী?
একটি টুল-নাম একাধিক অপারেশন ঢাকে, আর match, kind, unit বা mode-এর মতো একটি আর্গুমেন্ট ঠিক করে কোনটি চলবে।
সার্ভার কি প্রম্পট বা রিসোর্স দেয়?
হ্যাঁ: তিনটি প্রম্পট takhrij_hadith, cite_passage ও compare_tafsir, এবং একটি রিসোর্স qurangallery://grounding-rules।
পুরো পৃষ্ঠা পড়ব বা উদ্ধৃতি যাচাই করব কীভাবে?
পৃষ্ঠা পড়তে unit page দিয়ে shamela_read, আর কোনো আরবি উদ্ধৃতি লাইব্রেরিতে আছে কি না দেখতে shamela_verify_quote ব্যবহার করুন।