مواد پر جائیں

GitHub Copilot کے ساتھ اسلامی کتب کا MCP سرور استعمال کریں

VS Code میں GitHub Copilot کے ایجنٹ موڈ کو قرآن گیلری MCP سرور دیں: عربی کلاسیکی کتب، چھپے صفحے کے حوالے، نہ اکاؤنٹ نہ کلید۔

اس صفحے پر

نہ اکاؤنٹ، نہ سائن اِن، نہ کلید۔ VS Code میں GitHub Copilot وہی MCP کنفیگریشن استعمال کرتا ہے جو خود VS Code کرتا ہے، اور MCP ٹولز کو ایجنٹ موڈ سے کال کرتا ہے۔

مراحل

  1. اپنے ورک اسپیس میں .vscode/mcp.json بنائیں (یا Command Palette سے MCP: Add Server چلائیں):
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. اندراج کے اوپر Start ایکشن سے سرور شروع کریں اور اس پر بھروسا کریں۔
  2. Copilot چیٹ ویو کھولیں اور Agent موڈ پر جائیں۔ ٹولز پکر کھولیں اور تصدیق کریں کہ quran-gallery کے ٹولز پر نشان لگا ہے۔
  3. ایسا سوال پوچھیں جس کے لیے کسی متن کی ضرورت ہو (نیچے)۔

تنظیمی پالیسی Copilot کے لیے MCP سرورز کو بند کر سکتی ہے؛ اگر ٹولز کبھی ظاہر نہ ہوں تو اپنے منتظم سے پوچھیں کہ کیا MCP کی اجازت ہے۔ مکمل مراحل اور کلید کی ترتیب VS Code صفحے پر ہے۔

پہلا پرامپٹ جو آزمائیں

«إنما الأعمال بالنيات» والی حدیث بنیادی مجموعوں میں تلاش کریں اور بتائیں کہ وہ کس کتاب، ایڈیشن، جلد اور صفحے پر چھپی ہے۔ عربی عبارت بالکل ویسی ہی نقل کریں۔

آپ کے اسسٹنٹ کو shamela_search_library (یا search پھر fetch) کال کرنا چاہیے۔ نتائج میں صحيح البخاري، ط السلطانية، صفحہ 1/6 شامل ہے، مکتبہ ریڈر میں اس صفحے کے لنک کے ساتھ۔ اگر وہ یادداشت سے جواب دے تو کہیں: “قرآن گیلری لائبریری ٹول استعمال کریں اور جو وہ لوٹائے اسے نقل کریں۔”

تلاش کے سوالات عربی میں ہونے چاہییں؛ آپ کا اسسٹنٹ انگریزی الفاظ کا پہلے ترجمہ کرتا ہے (تفصیل)۔ تخریج، عبارت کا حوالہ دینے اور تفاسیر کے موازنے کے لیے تیار پرامپٹس مکمل ٹول فہرست میں درج ہیں۔

مسائل کا حل

  • 429، “Keyless limit reached”۔ بغیر کلید استعمال میں فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 کی اجازت ہے۔ Retry-After ہیڈر تک انتظار کریں، یا مفت کلید شامل کریں (نیچے)۔ حدود اور غلطیاں دیکھیں۔
  • 503۔ سرور یا اس کے پیچھے لائبریری مختصر وقت کے لیے دستیاب نہیں۔ Retry-After ہیڈر کے بعد دوبارہ کوشش کریں؛ اگر کلائنٹ صفر ٹولز دکھائے تو ایک منٹ انتظار کریں اور دوبارہ کنیکٹ کریں۔
  • ٹولز ظاہر نہیں ہوتے، یا مطلوبہ ٹول غائب ہے۔ ٹولز پکر کھولیں اور یقینی بنائیں کہ سرور پر نشان ہے؛ MCP: List Servers سے سرور ری اسٹارٹ کریں۔
  • فوراً کنکشن ناکام ہو جائے۔ اینڈ پوائنٹ /mcp/shamela ہے؛ سادہ /mcp ایک ویب صفحہ ہے، سرور نہیں۔

اختیاری: زیادہ حدوں کے لیے مفت کلید

کلید کبھی لازمی نہیں۔ مفت کلید حد کو فی منٹ 60 کالز تک بڑھاتی ہے اور بغیر کلید والی صفحاتی حدیں ہٹا دیتی ہے۔ VS Code صفحے پر دکھائے گئے طریقے کے مطابق headers کا اندراج شامل کریں۔ اپنے قرآن گیلری اکاؤنٹ کے Developers صفحے پر ایک بنائیں (کلیدیں کیسے کام کرتی ہیں)۔

اگلے مراحل

اس صفحے کو GitHub پر ایڈٹ کریں