استخدم MCP للوصول إلى نص القرآن الكريم والصوت والاختلافات في الروايات وهيكل المصحف في تطبيقاتك.

📖 خادم QuranHub MCP

يوفر خادم QuranHub MCP مجموعة غنية من الأدوات للوصول إلى القرآن الكريم واستكشافه برمجيًا.
يمكنك استخدام هذه الأدوات داخل Cursor أو أي client آخر متوافق مع MCP.

⚙️ الإعداد

أضف الخادم إلى ملف إعدادات MCP لديك:

{
  "servers": {
    "quranhub": {
      "type": "http",
      "url": "https://api.qurani.ai/gw/mcp"
    }
  }
}

🤖 الاستخدام مع Claude وChatGPT

يعمل الخادم نفسه كموصّل مخصص في Claude وكتطبيق في ChatGPT (وضع المطوّر). لا حاجة إلى حساب أو مفتاح API.

Claude: انتقل إلى Customize → Connectors → Add custom connector، والصق https://api.qurani.ai/gw/mcp، واختر No sign-in ثم اضغط Add. فعّله من قائمة + في المحادثة.
ChatGPT: انتقل إلى Settings → Apps → Advanced settings وفعّل Developer mode، ثم Create موصّلًا بالرابط أعلاه مع No authentication. اختره من قائمة + في المحادثة.

التعليمات خطوة بخطوة وأمثلة الأوامر وأزرار الإضافة في صفحة الربط. انظر أيضًا سياسة الخصوصية وشروط الخدمة والدعم.

🕌 أدوات القرآن الأساسية

أدوات أساسية لجلب محتوى القرآن الكريم بحسب هيكله.

الأداة	الوصف	مثال إدخال
`get_complete_quran`	جلب القرآن الكريم كاملًا بالنسخة الافتراضية	(بدون إدخال)
`get_complete_quran_by_edition`	جلب القرآن كاملًا في نسخة محددة	`"quran-uthmani"`
`get_surah`	جلب سورة كاملة مع جميع الآيات	`2` (البقرة)
`get_surah_by_edition`	جلب سورة في نسخة محددة	`surah: 1, edition: "en.sahih"`
`get_surah_by_multiple_editions`	جلب سورة في عدة نسخ	`surah: 1, editions: "quran-uthmani,en.sahih"`
`get_ayah`	جلب آية محددة بالمرجع	`"2:255"`
`get_ayah_by_edition`	جلب آية في نسخة محددة	`ref: "2:255", edition: "en.sahih"`
`get_ayah_by_multiple_editions`	جلب آية في عدة نسخ	`ref: "2:255", editions: "quran-uthmani,en.sahih"`
`get_juz`	جلب جزء كامل (1-30)	`3`
`get_juz_by_edition`	جلب جزء في نسخة محددة	`juz: 1, edition: "en.sahih"`
`get_page`	جلب صفحة قرآنية محددة (1-604)	`255`
`get_page_by_edition`	جلب صفحة في نسخة محددة	`page: 1, edition: "quran-uthmani"`
`get_hizb`	جلب حزب (1-60)	`15`
`get_hizb_by_edition`	جلب حزب في نسخة محددة	`hizb: 1, edition: "quran-uthmani"`
`get_hizb_quarter`	جلب ربع حزب (1-240)	`120`
`get_hizb_quarter_by_edition`	جلب ربع حزب في نسخة محددة	`quarter: 1, edition: "quran-uthmani"`
`get_manzil`	جلب منزل للقراءة الأسبوعية (1-7)	`5`
`get_manzil_by_edition`	جلب منزل في نسخة محددة	`manzil: 1, edition: "quran-uthmani"`
`get_ruku`	جلب ركوع	`40`
`get_ruku_by_edition`	جلب ركوع في نسخة محددة	`ruku: 1, edition: "quran-uthmani"`

🔍 البحث والاكتشاف

أدوات للبحث والاستكشاف واكتشاف المحتوى القرآني.

الأداة	الوصف	مثال إدخال
`search_quran`	البحث في النص العربي والترجمات	`"mercy"`
`get_random_ayah`	جلب آية عشوائية	(بدون إدخال)
`get_random_ayah_by_edition`	جلب آية عشوائية في نسخة محددة	`"en.sahih"`
`get_random_ayah_by_multiple_editions`	جلب آية عشوائية في عدة نسخ	`"quran-uthmani,en.sahih"`
`get_similar_ayahs_hafs`	إيجاد آيات مشابهة لآية معينة (حفص)	`surah: 1, ayah: 1`
`get_similar_ayahs_by_edition`	إيجاد آيات مشابهة حسب النسخة	`surah: 1, ayah: 1, edition: "quran-uthmani"`
`get_mutashabihat_phrases_hafs`	إيجاد عبارات متشابهة (حفص)	`surah: 2, ayah: 255`
`get_mutashabihat_phrases_by_edition`	إيجاد عبارات متشابهة حسب النسخة	`surah: 2, ayah: 255, edition: "quran-uthmani"`
`get_ayah_themes`	عرض جميع المواضيع المتاحة	(بدون إدخال)
`get_themes_for_ayah`	جلب المواضيع لآية محددة	`surah: 1, ayah: 1`

📚 النسخ والترجمات

إدارة وجلب نسخ القرآن الكريم والترجمات والصيغ المختلفة.

الأداة	الوصف	مثال إدخال
`get_all_editions`	عرض جميع النسخ مع الفلاتر	`language: "en", type: "translation"`
`get_all_languages`	جلب جميع اللغات المدعومة	(بدون إدخال)
`get_editions_by_language`	جلب النسخ حسب اللغة	`"ar"` أو `"en"`
`get_all_types`	جلب أنواع النسخ	(بدون إدخال)
`get_editions_by_type`	جلب النسخ حسب النوع	`"translation"`
`get_all_formats`	جلب جميع الصيغ	(بدون إدخال)
`get_editions_by_format`	جلب النسخ حسب الصيغة	`"audio"` أو `"text"`
`get_editions_by_format_and_type`	جلب النسخ حسب الصيغة والنوع	`format: "text", type: "narration"`
`get_editions_analysis`	نظرة إحصائية عامة على النسخ	(بدون إدخال)

🎵 التلاوة والصوت

الوصول إلى التلاوات الصوتية ومعلومات القراء.

الأداة	الوصف	مثال إدخال
`get_distinct_audio_editions`	عرض جميع القراء الصوتيين	(بدون إدخال)
`get_all_narrator_identifiers`	جلب جميع معرفات القراء	(بدون إدخال)
`get_audio_editions_by_narrator`	جلب تلاوة لقارئ محدد	`"quran-warsh"`

📖 ميزات خاصة

ميزات متقدمة لدراسة وفهم القرآن.

الأداة	الوصف	مثال إدخال
`get_tajweed_rules`	قواعد التجويد لكلمات محددة	`"1:1:2"`
`get_word_line_number`	رقم السطر لموقع الكلمة	`"1:1:2"`
`get_word_image`	صور كلمة بكلمة	`location: "1:1:2", type: "v4"`
`get_all_sajdas`	جلب جميع آيات السجود	(بدون إدخال)
`get_sajdas_by_edition`	آيات السجود في نسخة محددة	`"quran-uthmani"`
`get_narrations_differences`	مقارنة بين القراءات المختلفة	`page: 1, source: "hafs", target: "warsh"`

📊 البيانات الوصفية والبنية

المعلومات التنظيمية والبنيوية للقرآن الكريم.

الأداة	الوصف	مثال إدخال
`get_quran_metadata`	البيانات الوصفية الكاملة لبنية القرآن	(بدون إدخال)
`get_all_surahs`	قائمة بجميع السور (114) مع التفاصيل	`revelationOrder: false`
`get_surahs_by_revelation_city`	السور حسب مكة/المدينة	(بدون إدخال)
`get_surahs_by_juz`	السور حسب الأجزاء	(بدون إدخال)
`get_all_pages_metadata`	البيانات الوصفية لجميع الصفحات (604)	(بدون إدخال)
`get_pages_metadata_by_edition`	بيانات الصفحات لنسخة محددة	`"quran-uthmani"`
`get_all_juzs_metadata`	البيانات الوصفية لجميع الأجزاء (30)	(بدون إدخال)
`get_juzs_metadata_by_edition`	بيانات الأجزاء في نسخة محددة	`"quran-uthmani"`
`get_all_hizbs_metadata`	البيانات الوصفية لجميع الأحزاب (60)	(بدون إدخال)
`get_hizbs_metadata_by_edition`	بيانات الأحزاب لنسخة محددة	`"quran-uthmani"`

🖋️ الخطوط والعرض

موارد الخطوط ومعلومات تخطيط الصفحات.

الأداة	الوصف	مثال إدخال
`get_font_kinds`	عرض جميع أنواع الخطوط	(بدون إدخال)
`get_font_formats`	عرض جميع صيغ الخطوط	(بدون إدخال)
`get_font_archives`	عرض جميع أنواع أرشيفات الخطوط	(بدون إدخال)
`get_font_categories`	عرض جميع فئات الخطوط	(بدون إدخال)
`get_font_detail`	جلب تفاصيل خط محدد	`"uthmani"`
`get_font_files`	عرض ملفات الخط للتحميل	`fontCode: "uthmani"`
`get_font_page_files`	جلب ملفات الخط لصفحة محددة	`font: "uthmani", page: 1`
`list_font_page_files`	عرض ملفات الخط بشكل مجزأ	`font: "uthmani", format: "ttf"`

📐 تخطيطات المصحف

معلومات تخطيط الصفحات وبنية الأسطر.

الأداة	الوصف	مثال إدخال
`list_mushaf_layouts`	عرض تخطيطات صفحات المصحف	`linesPerPage: 15`
`get_layout_detail`	معلومات عن تخطيط محدد	`"hafs_15"`
`get_layout_page_lines`	بنية الأسطر للصفحات	`layout: "hafs_15", page: 1`
`get_layout_surah_lines`	بنية الأسطر للسورة	`layout: "hafs_15", surah: 1`
`layout_word_lookup`	إيجاد الصفحة/السطر عبر موقع الكلمة	`layout: "hafs_15", from: 1, to: 7`

🔧 وظائف مساعدة

وظائف أساسية للاختبار والاستخدام العام.

الأداة	الوصف	مثال إدخال
`get_response`	اختبار استجابة API الأساسية	(بدون إدخال)

خادم MCP — أدوات القرآن الكريم للوكلاء وبيئات التطوير المتكاملة