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