مواد پر جائیں

VS Code میں اسلامی کتب کا MCP سرور شامل کریں

mcp.json سے قرآن گیلری MCP سرور VS Code میں شامل کریں، کلید کے بغیر، اور چیٹ میں چھپے صفحے کے حوالوں کے ساتھ عربی کلاسیکی کتب میں تلاش کریں۔

اس صفحے پر

نہ اکاؤنٹ، نہ سائن اِن، نہ کلید۔ VS Code MCP سرورز mcp.json فائل سے پڑھتا ہے۔

مراحل

  1. اپنے ورک اسپیس میں .vscode/mcp.json بنائیں۔ (یا Command Palette سے MCP: Add Server چلائیں اور رہنما عمل پر چلیں، HTTP قسم اور نیچے والا URL منتخب کرتے ہوئے۔)
  2. سرور شامل کریں:
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. محفوظ کریں۔ VS Code سرور کے اندراج کے اوپر Start ایکشن دکھاتا ہے؛ اسے شروع کریں اور پوچھنے پر بھروسا کریں۔
  2. چیٹ ویو کو ایجنٹ موڈ میں کھولیں، دیکھیں کہ quran-gallery ٹولز کی فہرست میں ہے، اور سوال پوچھیں (نیچے)۔

GitHub Copilot کے ذریعے اسی ترتیب کے لیے VS Code میں GitHub Copilot دیکھیں۔ /mcp صفحے پر VS Code کے لیے ایک کلک میں انسٹال کا بٹن ہے۔

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

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

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

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

مسائل کا حل

  • 429، “Keyless limit reached”۔ بغیر کلید استعمال میں فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 کی اجازت ہے۔ 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" }
		}
	}
}

ایسی ورک اسپیس فائل کمٹ نہ کریں جس میں کلید ہو۔

اگلے مراحل

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