Mashhor Quran MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | منفذ الاستماع | 3939 |
| MCP_PATH | No | مسار نقطة الاتصال | /mcp |
| TRUST_PROXY | No | عدد قفزات الوكيل العكسي أمام الخادم (Express `trust proxy`) — بدون هذا يرى الخادم عنوان الوكيل نفسه لكل الزوار فيُبطِل تحديد المعدّل لكل IP. اتركه 1 خلف وكيل واحد (حالة Hostinger المعتادة)، أو عدّله ليطابق بنيتك | 1 |
| ALLOWED_HOSTS | No | رؤوس Host المسموحة (حماية من هجمات DNS rebinding) — عدّلها لتطابق النطاق الفعلي الذي ستستضيف عليه | quran.mashhor-hub.com,mcp.mashhor-hub.com,localhost |
| ALLOWED_ORIGINS | No | أصول CORS المسموحة | https://claude.ai,https://claude.com,https://chatgpt.com,https://chat.openai.com,https://gemini.google.com |
| RATE_LIMIT_PER_MIN | No | أقصى عدد طلبات لكل عنوان IP في الدقيقة | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_surahsA | يعيد أسماء سور القرآن الكريم الـ114 بالترتيب مع رقم كل سورة. |
| list_recitersB | يبحث في قراء القرآن الكريم المتاحين عبر mp3quran.net، مع رواياتهم المتاحة. يمكن تمرير جزء من اسم القارئ للتصفية. |
| get_surah_audioA | يعيد رابط ملف الصوت المباشر لتلاوة سورة معيّنة بصوت قارئ محدد (استخدم list_reciters أولًا لمعرفة المعرّف reciter_id). |
| search_quranA | يبحث عن كلمة أو عبارة داخل نص القرآن الكريم كاملًا (بلا تشكيل، ويتجاهل اختلاف رسم الألف/الياء/التاء المربوطة)، ويعيد الآيات المطابقة مع موضعها. |
| get_ayahA | يعيد نص آية واحدة بعينها من القرآن الكريم برقم السورة ورقم الآية. |
| list_radio_stationsB | يعيد قائمة إذاعات القرآن الكريم المباشرة المتاحة مع روابط البث. |
| get_prayer_timesA | يعيد مواقيت الصلاة الخمس لمدينة أو إحداثيات معيّنة في تاريخ محدد (افتراضيًا اليوم). مرّر اسم مدينة من القائمة المعروفة (مكة المكرمة، المدينة المنورة، القاهرة، الكويت، الإمارات) أو إحداثيات latitude/longitude مباشرة لأي مكان آخر. |
| get_hijri_dateA | يعيد التاريخ الهجري المقابل لليوم (أو لتاريخ ميلادي محدد) دون أي استدعاء شبكي. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool addresses a unique resource or action: surah listing, verse retrieval, full-text search, reciter lookup, audio URL retrieval, radio stations, prayer times, and Hijri date. No overlapping purposes that would cause misselection.
All names use snake_case with consistent list_/get_/search_ verb prefixes and clear nouns, making the pattern predictable throughout.
8 tools are well-scoped for Quran text, audio, and Islamic date utilities; each tool has a distinct role without being excessive or thin.
Core Quran retrieval, search, audio, and Islamic utilities are covered, but there is no full-surah text or verse-range retrieval and no translation/tafsir. These are minor gaps that agents can work around by repeated get_ayah calls.