[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80934":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":17,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},80934,"tafsir-mcp","tafsircenter\u002Ftafsir-mcp","tafsircenter","Scholarly MCP server for the Holy Quran with 5 classical tafsirs and word-level linguistic analysis — sponsored by Tafsir Center for Quranic Studies","https:\u002F\u002Ftafsir.net",null,"Python",35,5,32,0,1,3,2.33,"MIT License",false,"main",true,[],"2026-06-12 02:04:08","\u003Cdiv align=\"center\">\n\n# 🕌 Tafsir MCP\n\n**خادم MCP العلمي للقرآن الكريم — برعاية مركز تفسير للدراسات القرآنية**\n\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Ftafsir-mcp.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Ftafsir-mcp\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode-MIT-blue.svg)](LICENSE)\n[![Data License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdata-CC%20BY%204.0-green.svg)](LICENSE-DATA)\n[![MCP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-2025--11--25-purple.svg)](https:\u002F\u002Fmodelcontextprotocol.io)\n[![Tafsir Center](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fsponsor-Markaz%20Tafsir-darkgreen.svg)](https:\u002F\u002Ftafsir.net)\n\n[العربية](#arabic) · [English](#english)\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Ca id=\"arabic\">\u003C\u002Fa>\n\n## 🌙 نبذة\n\nخادم **Model Context Protocol (MCP)** يوفّر وصولاً علمياً موثّقاً للقرآن الكريم لأي مساعد ذكي يدعم MCP (Claude Code، Claude Desktop، VS Code، وغيرها).\n\nكل البيانات مراجعة ومعتمدة من **[مركز تفسير للدراسات القرآنية](https:\u002F\u002Ftafsir.net)**.\n\n---\n\n## ✨ المميزات\n\n- 📖 **6,236 آية** كاملة بالرسم العثماني\n- 📚 **5 تفاسير كلاسيكية**: الطبري · ابن كثير · البغوي · السعدي · الميسر\n- 🌍 **المختصر في التفسير** بـ3 لغات (عربي، إنجليزي، بنغالي)\n- 🔤 **77,432 كلمة** بتحليل لغوي شامل (إعراب، صرف، جذر، رسم)\n- 🔍 **1,891 جذر** قابل للبحث والإحصاء\n- ⚡ **بحث FTS5** سريع مع تطبيع عربي كامل (بدون تشكيل)\n- 🎵 **اختلاف القراءات** لكل آية وكلمة\n- 📜 **أسباب النزول** بالإسناد الكامل (201 آية)\n- 📊 **إحصاءات تفصيلية** لكل سورة وصفحة مصحف\n- 🛡️ **حماية صارمة** من الهلوسة (Pydantic v2 validation)\n- 📴 **يعمل دون إنترنت** بعد التثبيت\n\n---\n\n## 🚀 التثبيت السريع\n\n### لمستخدمي Claude Code:\n```bash\nclaude mcp add tafsir --scope user -- uvx tafsir-mcp\n```\n\n### للتثبيت اليدوي:\n```bash\npip install tafsir-mcp\n# أو\nuvx tafsir-mcp\n```\n\nعند أول تشغيل، سيُحمَّل ملف البيانات (~214 MB) من Hugging Face تلقائياً ويُخزَّن في `~\u002F.cache\u002Ftafsir-mcp\u002F`.\n\n### للمطوّرين (من المصدر):\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftafsircenter\u002Ftafsir-mcp\ncd tafsir-mcp\ncp \u002Fpath\u002Fto\u002Fquran.db data\u002Fquran.db   # أو: export TAFSIR_DB_PATH=\u002Fpath\u002Fto\u002Fquran.db\nuv sync\nuv run tafsir-mcp\n```\n\n---\n\n## 🔧 ربط Claude Desktop\n\nأضف إلى `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tafsir\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u002FUsers\u002FYOUR_USERNAME\u002Fprojects\u002Fquranic-scholar-mcp\",\n        \"run\",\n        \"tafsir-mcp\"\n      ]\n    }\n  }\n}\n```\n\n---\n\n## 🧰 الأدوات المتاحة (13 أداة)\n\n| الفئة | الأداة | الوصف |\n|---|---|---|\n| **الآية** | `fetch_ayah` | نص آية بالرسم العثماني، مع تجويد\u002Fإعراب اختياري |\n| | `fetch_tafsir` | تفسير من 8 مصادر (تفاسير متعددة بطلب واحد) |\n| | `fetch_nuzool_reason` | سبب النزول بالإسناد الكامل |\n| **السورة** | `fetch_surah_info` | معلومات شاملة: أهداف، فضائل، نزول |\n| | `get_surah_statistics` | إحصاءات: كلمات، حروف، أطول كلمة... |\n| **الكلمة** | `analyze_word` | إعراب، صرف، معنى، جذر، قراءات |\n| | `find_root_occurrences` | كل مواضع جذر في القرآن |\n| | `get_root_stats` | إحصاءات جذر: سور، آيات، أوزان |\n| **البحث** | `search_quran_text` | بحث FTS5 بدون تشكيل |\n| | `search_in_tafsir` | بحث LIKE في متن تفسير محدد |\n| **القراءات** | `get_qeraat_variants` | اختلاف القراءات لآية أو كلمة |\n| **عام** | `get_quran_overview` | إحصاءات شاملة للقرآن |\n| | `get_page_fawaed` | فوائد صفحة من المصحف |\n\n---\n\n## 📋 الموارد والقوالب\n\n### الموارد (Resources)\n| المورد | الوصف |\n|--------|-------|\n| `quran:\u002F\u002Fsurahs` | فهرس 114 سورة (JSON) |\n| `quran:\u002F\u002Ftafsirs` | فهرس 8 مصادر تفسيرية مع الإسناد (JSON) |\n| `quran:\u002F\u002Fschema` | توثيق مخطط قاعدة البيانات (Markdown) |\n\n### قوالب الدراسة (Prompts)\n| القالب | الوصف |\n|--------|-------|\n| `study_ayah(surah, ayah)` | دراسة شاملة: نص + تفسير + إعراب + كلمات |\n| `compare_tafsirs(surah, ayah)` | مقارنة التفاسير الخمسة |\n| `root_study(root)` | دراسة جذر: إحصاء + مواضع + سياقات |\n| `surah_overview(surah)` | نظرة شاملة على سورة |\n| `tajweed_lesson(surah, ayah)` | درس تجويد: أحكام + قراءات |\n\n---\n\n## 📚 مصادر التفسير\n\n| المعرّف | الكتاب | المؤلف | الوفاة |\n|---------|--------|--------|--------|\n| `tabary` | جامع البيان | أبو جعفر الطبري | 310هـ |\n| `katheer` | تفسير ابن كثير | أبو الفداء إسماعيل بن كثير | 774هـ |\n| `baghawy` | معالم التنزيل | الحسين بن مسعود البغوي | 510هـ |\n| `saadi` | تيسير الكريم الرحمن | عبد الرحمن بن ناصر السعدي | 1376هـ |\n| `moyassar` | التفسير الميسر | مجمع الملك فهد | — |\n| `mukhtasar_ar` | المختصر (عربي) | مجمع الملك فهد | — |\n| `mukhtasar_en` | Concise Commentary (English) | King Fahd Complex | — |\n| `mukhtasar_bn` | সংক্ষিপ্ত তাফসীর (Bengali) | King Fahd Complex | — |\n\n---\n\n## 🗂️ بنية المشروع\n\n```\nsrc\u002Ftafsir\u002F\n├── server.py          # FastMCP entry point\n├── db.py              # SQLite read-only connection\n├── data_loader.py     # DB path resolver + auto-download\n├── models.py          # Pydantic models + attributions\n├── normalize.py       # Arabic text normalization\n├── tools\u002F             # 13 MCP tools\n├── resources\u002F         # 3 MCP resources\n└── prompts\u002F           # 5 study prompt templates\n```\n\n---\n\n## 🧪 الاختبارات\n\n```bash\nuv run pytest tests\u002F -v\n# 35 tests — all pass\n```\n\n---\n\n## 🔒 الأمان\n\n- قاعدة البيانات تُفتح للقراءة فقط: `mode=ro` + `PRAGMA query_only=ON`\n- جميع مدخلات المستخدم عبر `?` placeholders — لا SQL injection\n- الأدوات لا تصل للشبكة (`openWorldHint=False`)\n\n---\n\n## 📜 الترخيص\n\n- **الكود**: [MIT License](LICENSE) — Ahmed Eid, Tafsir Center for Quranic Studies\n- **قاعدة البيانات**: [CC BY 4.0](LICENSE-DATA) — يجب نسبة المصدر لمركز تفسير\n\n---\n\n## 🏛️ الجهة الراعية\n\nهذا المشروع رعاية ودعم **[مركز تفسير للدراسات القرآنية](https:\u002F\u002Ftafsir.net)**.\nالبيانات القرآنية مراجعة وموثّقة من قِبل الباحثين العلميين في المركز.\n\n📧 cloud@tafsir.net\n\n---\n\n\u003Ca id=\"english\">\u003C\u002Fa>\n\n## 🌙 About\n\nA **Model Context Protocol (MCP)** server providing scholarly, certified access to the Holy Quran for any MCP-compatible AI assistant (Claude Code, Claude Desktop, VS Code, etc.).\n\nAll data is reviewed and certified by **[Tafsir Center for Quranic Studies](https:\u002F\u002Ftafsir.net)**.\n\n## ✨ Features\n\n- 📖 **6,236 ayahs** in Uthmani script\n- 📚 **5 classical Arabic tafsirs**: Tabari · Ibn Kathir · Baghawi · Saadi · Muyassar\n- 🌍 **Trilingual Mukhtasar** (Arabic, English, Bengali)\n- 🔤 **77,432 words** with full linguistic analysis (i'rab, sarf, root, rasm)\n- 🔍 **1,891 roots** searchable with statistics\n- ⚡ **FTS5 search** with full Arabic normalization (diacritic-free)\n- 🎵 **Qira'at variants** per ayah and word\n- 📜 **Asbab al-nuzool** with full isnad (201 ayahs)\n- 📊 **Detailed statistics** per surah and mushaf page\n- 🛡️ **Hallucination protection** (strict Pydantic v2 validation)\n- 📴 **Fully offline** after installation\n\n## 🚀 Quick Install\n\n```bash\n# Claude Code\nclaude mcp add tafsir --scope user -- uvx tafsir-mcp\n\n# pip \u002F uvx\npip install tafsir-mcp\nuvx tafsir-mcp\n```\n\nOn first run, the database (~214 MB) is downloaded automatically from Hugging Face and cached at `~\u002F.cache\u002Ftafsir-mcp\u002F`.\n\n## 🧰 Available Tools (13)\n\n| Category | Tool | Description |\n|---|---|---|\n| **Ayah** | `fetch_ayah` | Ayah text with optional tajweed\u002Fi'rab |\n| | `fetch_tafsir` | Tafsir from up to 8 sources in one call |\n| | `fetch_nuzool_reason` | Asbab al-nuzool with full isnad |\n| **Surah** | `fetch_surah_info` | Full surah info: goals, virtues, revelation |\n| | `get_surah_statistics` | Word count, char count, longest word... |\n| **Word** | `analyze_word` | I'rab, sarf, meaning, root, qira'at |\n| | `find_root_occurrences` | All occurrences of a root in the Quran |\n| | `get_root_stats` | Root stats: surahs, ayahs, distinct forms |\n| **Search** | `search_quran_text` | FTS5 diacritic-free search |\n| | `search_in_tafsir` | LIKE search in a tafsir text |\n| **Qira'at** | `get_qeraat_variants` | Reading variants for ayah or word |\n| **General** | `get_quran_overview` | Quran-wide statistics |\n| | `get_page_fawaed` | Fawaed for a mushaf page |\n\n## 📜 License\n\n- **Code**: [MIT](LICENSE) — Ahmed Eid, Tafsir Center for Quranic Studies\n- **Quranic Data**: [CC BY 4.0](LICENSE-DATA) — attribution to \"Tafsir Center for Quranic Studies\" required\n\n## 🏛️ Sponsor\n\nSponsored by **[Tafsir Center for Quranic Studies](https:\u002F\u002Ftafsir.net)**.\n\n📧 cloud@tafsir.net · [GitHub Issues](https:\u002F\u002Fgithub.com\u002Ftafsircenter\u002Ftafsir-mcp\u002Fissues)\n","Tafsir MCP 是一个为《古兰经》提供学术支持的MCP服务器，包含5种经典注释和词级语言分析。该项目使用Python开发，核心功能包括全文6236节经文、5种经典注释、全面的语言学分析（如语法、形态学、词根等）、快速全文搜索以及离线运行能力。它特别适合需要高质量《古兰经》文本及其学术资源的应用场景，比如智能助手集成、教育软件开发或个人学习研究。此外，通过严格的验证机制确保了内容的准确性和一致性。",2,"2026-06-11 04:02:53","CREATED_QUERY"]