ربط Cursor بخادم MCP للنصوص الإسلامية
أضف خادم MCP لمعرض القرآن إلى Cursor عبر mcp.json: ابحث في كتب عربية تراثية مع توثيق الصفحة المطبوعة، دون حاجة إلى مفتاح.
في هذه الصفحة
بلا حساب ولا تسجيل دخول ولا مفتاح. يقرأ Cursor خوادم MCP من الملف mcp.json.
الخطوات
- افتح
~/.cursor/mcp.json(لكل المشاريع) أو.cursor/mcp.jsonداخل مشروع (لذلك المشروع وحده). أنشئ الملف إن لم يكن موجودًا. - أضف الخادم:
{
"mcpServers": {
"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
}
}- احفظ. يعرض Cursor خوادم MCP في صفحة Customize؛ وينبغي أن يظهر
quran-galleryمفعّلًا مع أدواته. - افتح دردشة في وضع Agent واسأل سؤالًا يحتاج إلى نص (أدناه).
وفي صفحة /mcp زر تثبيت بنقرة واحدة لـ Cursor.
أول سؤال تجرّبه
ابحث عن حديث «إنما الأعمال بالنيات» في المجاميع الأصلية، وأخبرني في أي كتاب وطبعة ومجلد وصفحة طُبع. انقل النص العربي بحروفه.
ينبغي أن يستدعي مساعدك shamela_search_library (أو search ثم fetch). وتتضمن النتائج صحيح البخاري، ط السلطانية، الصفحة 1/6، مع رابط إلى تلك الصفحة في قارئ المكتبة. فإن أجاب من ذاكرته بدل ذلك فقل له: «استعمل أداة مكتبة معرض القرآن وانقل ما تعيده.»
يجب أن تكون استعلامات البحث بالعربية؛ فيترجم مساعدك المصطلحات الإنجليزية أولًا (التفاصيل). وتجد أسئلة جاهزة لـ«تخريج الحديث» وتوثيق النصوص ومقارنة التفاسير في قائمة الأدوات الكاملة.
حل المشكلات
- 429، «Keyless limit reached». يتيح الاستخدام بلا مفتاح 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP. انتظر حسب ترويسة
Retry-After، أو أضف مفتاحًا مجانيًا (أدناه). انظر الحدود والأخطاء. - 503. الخادم أو المكتبة خلفه غير متاح لوقت وجيز. أعد المحاولة بعد المدة في ترويسة
Retry-After؛ وإن عرض العميل صفر أدوات فانتظر دقيقة ثم أعد الاتصال. - الأدوات لا تظهر، أو تنقصك أداة متوقعة. عطّل الخادم ثم فعّله في قائمة MCP في Cursor، أو أعد تشغيل Cursor؛ فقائمة الأدوات تُخزَّن مؤقتًا لكل جلسة.
- يفشل الاتصال فورًا. نقطة الاتصال هي
/mcp/shamela؛ أما/mcpوحده فصفحة ويب لا الخادم.
اختياري: مفتاح مجاني لحدود أعلى
المفتاح ليس مطلوبًا أبدًا. المفتاح المجاني يرفع الحد إلى 60 استدعاءً في الدقيقة ويرفع سقوف نطاق الصفحات المفروضة على الاستخدام بلا مفتاح. أنشئ مفتاحًا من صفحة المطوّرين (Developers) في حسابك بمعرض القرآن (كيف تعمل المفاتيح)، ثم أرسله رمزًا من نوع bearer.
أضف مدخل headers:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}أبقِ أي ملف يحوي مفتاحًا خارج git.