Alat MCP untuk kitab klasik Arab: daftar lengkap
15 alat hanya-baca server MCP Quran Gallery, plus 3 prompt dan satu sumber daya: pencarian, baca, kutipan, isnad, perawi, tafsir, katalog.
Di halaman ini
Lima belas alat, sama untuk semua klien, semuanya hanya-baca. Empat milik kami (shamela_search_library, search, fetch, shamela_verify_quote); sebelas berasal dari server perpustakaan itu sendiri. Sembilan dari sebelas itu adalah router: masing-masing menerima satu argumen mode (match, kind, unit, atau mode) yang menentukan apa yang dikerjakannya, dan tabel di bawah mencantumkan setiap mode pada barisnya sendiri. search dan fetch adalah pasangan standar yang diwajibkan ChatGPT deep research, dan semua klien melihatnya. Di samping alat-alat itu server menawarkan tiga prompt dan satu sumber daya.
Klien Anda menampilkannya untuk Anda. Halaman ini adalah peta, agar Anda tahu apa yang ada dan mana yang dipakai — setiap alat membawa dokumentasi parameternya sendiri dalam skema yang sudah diterima klien Anda.
Mulailah dengan
shamela_search_library. Ia mewajibkan cakupan dan melaporkan cara mencocokkannya, yang merupakan pilihan awal tepat untuk “carikan teks ini.” Gunakan alat mentahshamela_*bila Anda butuh sesuatu yang tidak bisa dilakukannya. Semua kueri harus berbahasa Arab.
Pencarian
| Alat | Gunakan bila |
|---|---|
shamela_search_library | Bawaan. Pencarian bercakupan dengan kutipan dan laporan kecocokan. Lihat referensinya. |
search | ChatGPT deep research dan company knowledge. Satu kueri atas seluruh perpustakaan; mengembalikan results berisi id, title, url. Rincian di bawah. |
shamela_search (match: 'words') | Anda ingin pencarian halaman mentah, termasuk tanpa cakupan. Mengurutkan berdasarkan frekuensi istilah — baca peringatan di bawah. |
shamela_search (match: 'phrase') | Anda butuh frasa berurutan persis, atau pencocokan kedekatan. |
shamela_search (match: 'exact') | Harakat (التشكيل) dan bentuk hamzah/alif harus cocok persis. |
shamela_search (match: 'boolean') | Anda butuh OR dan NOT, bukan hanya AND. |
shamela_find (kind: 'heading') | Anda mencari judul bab atau subbab, bukan teks isi. |
shamela_lookup_hadith (mode: 'search') | Anda punya redaksi sebuah hadis dan ingin tahu kitab-kitab yang memuatnya. |
shamela_search (match: 'batch') | Hingga 24 pencarian bercakupan dalam satu panggilan, digabung dan dideduplikasi. |
shamela_survey_topic | Sebelum mencari: seberapa banyak perpustakaan memuat sebuah istilah, dan di rak, abad, kitab, dan penulis mana? Secara bawaan menghitung kata sebagaimana tertulis; mode: 'morphological' menghitung semua bentuk akar katanya. |
shamela_search(match: 'words') bisa berjalan tanpa cakupan, dan biasanya sebaiknya tidak. Pengurutannya berdasarkan frekuensi istilah, yang tidak tahu apa-apa tentang otoritas keilmuan. Tanpa cakupan,التيممmengembalikan 26.098 hasil dengan antologi puisi tahun 710 H di puncaknya, danإنما الأعمال بالنياتmengembalikan 6.815 hasil yang di dalamnya Sahih al-Bukhari tidak muncul sama sekali. Berikan cakupan, atau gunakanshamela_search_library.
search dan fetch
ChatGPT deep research dan company knowledge mengharapkan dua alat dengan bentuk tetap. Keduanya ditampilkan kepada semua klien sebagai pasangan standar. Ini pintu masuk generik yang cepat: satu argumen, tanpa cakupan. Untuk hadis, tafsir, atau fikih, pilih shamela_search_library; gunakan shamela_search untuk cakupan, frasa persis, atau penomoran halaman.
| Alat | Masukan | Mengembalikan |
|---|---|---|
search | query (Arab) | results: hingga 10 { id, title, url }. id berbentuk bookId:pageId; url adalah halaman di pembaca Maktabah. |
fetch | id dari hasil search | { id, title, text, url, metadata }. text memisahkan teks utama dan catatan kaki, dengan catatan kaki di bawah labelnya sendiri. |
Keduanya mengembalikan konten terstruktur dan JSON yang sama sebagai teks. search tanpa cakupan, sehingga pengurutannya seperti shamela_search (match: 'words'); pilih shamela_search_library bila klien Anda tidak memerlukan bentuk ini.
Membaca
| Alat | Gunakan bila |
|---|---|
shamela_read (unit: 'page') | Anda punya book_id + page_id dan ingin halaman penuh — isi, catatan kaki, dan semuanya. |
shamela_read (unit: 'range') | Anda butuh hingga 20 halaman berurutan. |
shamela_read (unit: 'section') | Anda ingin semua halaman di bawah satu judul bab. |
shamela_read (unit: 'toc') | Daftar isi sebuah kitab. |
shamela_read (unit: 'parts') | Jilid-jilid karya multi-jilid. |
shamela_read (unit: 'services') | Ayat, kunci hadis, dan penanda isnad apa yang dimuat sebuah halaman. |
Kutipan
| Alat | Gunakan bila |
|---|---|
shamela_cite (mode: 'printed_page') | Memverifikasi kutipan. Ubah «jilid 4, hlm. 405» menjadi id halaman yang memuatnya. |
shamela_verify_quote | Memeriksa sebuah kutipan. Apakah kalimat Arab ini ada di perpustakaan, dan di mana: kitab, halaman cetak, teks utama atau catatan kaki. Lihat Verifikasi kutipan buatan AI. |
shamela_find (kind: 'work') | Petakan judul yang dikutip (beserta penulis dan edisi) ke entri katalog — atau tolak. |
shamela_cite (mode: 'citation') | Format kutipan dalam salah satu dari tiga gaya. |
shamela_find (kind: 'name') | Disambiguasi potongan nama Arab menjadi id kitab atau penulis. |
Dua yang pertama adalah alasan permukaan ini layak dimiliki. Klaim seperti “al-Mughni, 4/405” bisa diperiksa, bukan dipercaya begitu saja: petakan karyanya, petakan halamannya, bacalah.
Isnad dan perawi
| Alat | Gunakan bila |
|---|---|
shamela_lookup_rijal (mode: 'narrators') | Cari perawi menurut nama — 18.989 orang, tahun wafat 2–774 H. |
shamela_lookup_rijal (mode: 'narrator') | Dosir lengkap: nasab, tahun wafat, ṭabaqah, penilaian. |
shamela_lookup_rijal (mode: 'isnad_search') | Cari 45.220 rantai terindeks di sepuluh kitab hadis. |
shamela_lookup_rijal (mode: 'isnad') | Rantai yang tercetak pada satu halaman, dengan nama perawi yang sudah ditelusuri. |
shamela_lookup_hadith (mode: 'sources') | Setiap kitab yang mencatat hadis yang sama, lewat kunci bersamanya. |
Al-Qur’an dan tafsir
| Alat | Gunakan bila |
|---|---|
shamela_lookup_quran (mode: 'search') | Cari di 6.236 ayat (Hafs dari Ashim). |
shamela_lookup_quran (mode: 'aya') | Ambil ayat menurut nomor, atau menurut surah + ayat. |
shamela_lookup_tafsir (mode: 'coverage') | Kitab tafsir mana yang mengomentari ayat ini, dengan halaman masing-masing, dan status jujur untuk kitab yang tidak dicakup indeks. downloaded_only: false menambahkan kitab yang teksnya tidak ada di server. |
shamela_lookup_tafsir (mode: 'texts') | Teks komentar sebenarnya untuk satu ayat, lintas sumber, dalam satu panggilan. |
Katalog
| Alat | Gunakan bila |
|---|---|
shamela_find (kind: 'book') | Cari kitab menurut nama, penulis, atau deskripsi bibliografis. |
shamela_find (kind: 'author') | Cari penulis menurut nama atau biografi. |
shamela_get_details (kind: 'book') | Metadata lengkap satu kitab. |
shamela_get_details (kind: 'author') | Metadata lengkap satu penulis, opsional beserta kitab-kitabnya. |
shamela_find (kind: 'category') | Seluruh 41 kategori beserta jumlah kitabnya. |
shamela_find (kind: 'period') | Saring katalog menurut periode, dengan batasan digabung AND. |
shamela_get_brief | Ringkasan operasi milik server perpustakaan untuk pemanggil terprogram. |
Prompt
Prompt siap pakai yang mungkin ditampilkan klien Anda. Masing-masing berupa teks Inggris yang menyuruh model menjawab dalam bahasa Anda.
| Prompt | Argumen | Fungsinya |
|---|---|---|
takhrij_hadith | text | Menemukan hadis di berbagai kitab beserta isnadnya, dan tidak pernah menilai derajatnya. Lihat Takhrij hadis. |
cite_passage | text | Menemukan sebuah kutipan dan mengutipnya dengan edisi, jilid, dan halaman. |
compare_tafsir | surah, ayah | Membandingkan apa yang dikatakan kitab-kitab tafsir yang tersedia tentang satu ayat. |
Sumber daya
qurangallery://grounding-rules adalah sumber daya text/markdown yang memuat kontrak kutipan. Lihat Aturan grounding.
Yang tidak diekspos
Tiga alat server perpustakaan ditahan, bukan karena kuat. Alat-alat itu melaporkan mesin tempat server berjalan, sehingga pemanggil jarak jauh akan membaca fakta tentang infrastruktur kami sambil mengira membaca fakta tentang sebuah perpustakaan:
shamela_list_downloaded_books— apa yang diunduh di host. Gunakanshamela_find(kind: 'book'), yang membaca katalog, ataushamela_get_details(kind: 'book'), yang memberi tahu apakah teks sebuah kitab ada di server.shamela_check_health— versi server dan diagnostik internal.shamela_get_guide— panduan pengguna untuk ekstensi desktop Syamilah, yang menjelaskan antarmuka yang tidak Anda miliki.
Tidak ada yang ditahan dari korpusnya.
Nama alat lama
Server perpustakaan versi 1.4.0 menggabungkan 39 alat menjadi sembilan router. Nama lama masih berfungsi, tanpa ditampilkan, dan hasilnya membawa _meta.deprecated_alias yang menyebut alat barunya. Nama lama baru dihapus setelah 14 hari tanpa panggilan sama sekali. Tabel menunjukkan alat baru dan nilai mode yang harus dikirim untuk setiap nama lama:
| Nama lama | Sekarang |
|---|---|
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') |
Gunakan nama baru dan kirim argumen mode yang ditunjukkan di kolom kedua.
Langkah berikutnya
Pertanyaan
Berapa banyak alat di server MCP Quran Gallery?
15 alat hanya-baca, sama untuk setiap klien. Empat milik kami dan 11 berasal dari server perpustakaan.
Alat mana yang dipanggil pertama?
shamela_search_library. Alat ini mewajibkan cakupan dan melaporkan cara pencocokan, cocok untuk kebanyakan pertanyaan carikan teks ini.
Untuk apa search dan fetch?
Keduanya pasangan standar yang diharapkan deep research ChatGPT: search menerima satu kueri Arab di seluruh perpustakaan dan fetch membaca hasil berdasarkan id.
Apa arti alat bertipe router?
Satu nama alat mencakup beberapa operasi, dan argumen seperti match, kind, unit, atau mode memilih operasi yang dijalankan.
Apakah server menyediakan prompt atau resource?
Ya: tiga prompt, yaitu takhrij_hadith, cite_passage, dan compare_tafsir, serta satu resource, qurangallery://grounding-rules.
Bagaimana membaca satu halaman penuh atau memeriksa kutipan?
Pakai shamela_read dengan unit page untuk membaca halaman, dan shamela_verify_quote untuk memeriksa apakah kutipan Arab ada di perpustakaan.