تخطَّ إلى المحتوى

استعمال خادم المكتبة الإسلامية MCP مع GitHub Copilot

امنح GitHub Copilot في وضع الوكيل داخل VS Code خادم MCP لمعرض القرآن: كتب عربية تراثية بتوثيق الصفحة المطبوعة، بلا حساب ولا مفتاح.

في هذه الصفحة

بلا حساب ولا تسجيل دخول ولا مفتاح. يستعمل GitHub Copilot في VS Code إعداد MCP نفسه الذي يستعمله VS Code، ويستدعي أدوات MCP من وضع الوكيل (Agent mode).

الخطوات

  1. أنشئ .vscode/mcp.json في مساحة العمل (أو شغّل MCP: Add Server من لوحة الأوامر):
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. شغّل الخادم من الإجراء Start فوق مدخله، وثق به.
  2. افتح نافذة دردشة Copilot وانتقل إلى وضع Agent. افتح منتقي الأدوات وتأكد من تحديد أدوات quran-gallery.
  3. اسأل سؤالًا يحتاج إلى نص (أدناه).

قد تعطّل سياسة المؤسسة خوادم MCP في Copilot؛ فإن لم تظهر الأدوات أبدًا فاسأل المسؤول عندكم هل MCP مسموح. الخطوات الكاملة وإعداد المفتاح في صفحة VS Code.

أول سؤال تجرّبه

ابحث عن حديث «إنما الأعمال بالنيات» في المجاميع الأصلية، وأخبرني في أي كتاب وطبعة ومجلد وصفحة طُبع. انقل النص العربي بحروفه.

ينبغي أن يستدعي مساعدك shamela_search_library (أو search ثم fetch). وتتضمن النتائج صحيح البخاري، ط السلطانية، الصفحة 1/6، مع رابط إلى تلك الصفحة في قارئ المكتبة. فإن أجاب من ذاكرته بدل ذلك فقل له: «استعمل أداة مكتبة معرض القرآن وانقل ما تعيده.»

يجب أن تكون استعلامات البحث بالعربية؛ فيترجم مساعدك المصطلحات الإنجليزية أولًا (التفاصيل). وتجد أسئلة جاهزة لـ«تخريج الحديث» وتوثيق النصوص ومقارنة التفاسير في قائمة الأدوات الكاملة.

حل المشكلات

  • 429، «Keyless limit reached». يتيح الاستخدام بلا مفتاح 10 استدعاءات للأدوات في الدقيقة و200 في اليوم لكل عنوان IP. انتظر حسب ترويسة Retry-After، أو أضف مفتاحًا مجانيًا (أدناه). انظر الحدود والأخطاء.
  • 503. الخادم أو المكتبة خلفه غير متاح لوقت وجيز. أعد المحاولة بعد المدة في ترويسة Retry-After؛ وإن عرض العميل صفر أدوات فانتظر دقيقة ثم أعد الاتصال.
  • الأدوات لا تظهر، أو تنقصك أداة متوقعة. افتح منتقي الأدوات وتأكد من تحديد الخادم؛ وأعد تشغيل الخادم من MCP: List Servers.
  • يفشل الاتصال فورًا. نقطة الاتصال هي /mcp/shamela؛ أما /mcp وحده فصفحة ويب لا الخادم.

اختياري: مفتاح مجاني لحدود أعلى

المفتاح ليس مطلوبًا أبدًا. المفتاح المجاني يرفع الحد إلى 60 استدعاءً في الدقيقة ويرفع سقوف نطاق الصفحات المفروضة على الاستخدام بلا مفتاح. أضف مدخل headers تمامًا كما في صفحة VS Code. أنشئ مفتاحًا من صفحة المطوّرين (Developers) في حسابك بمعرض القرآن (كيف تعمل المفاتيح).

الخطوات التالية

عدّل هذه الصفحة على GitHub