مواد پر جائیں

Cursor کو اسلامی متون کے MCP سرور سے جوڑیں

mcp.json کے ذریعے قرآن گیلری MCP سرور Cursor میں شامل کریں: چھپے صفحے کے حوالوں کے ساتھ عربی کلاسیکی کتب میں تلاش، کلید درکار نہیں۔

اس صفحے پر

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

مراحل

  1. ~/.cursor/mcp.json (تمام پروجیکٹس کے لیے) یا کسی پروجیکٹ میں .cursor/mcp.json (صرف اسی پروجیکٹ کے لیے) کھولیں۔ اگر فائل موجود نہ ہو تو بنائیں۔
  2. سرور شامل کریں:
{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. محفوظ کریں۔ Cursor MCP سرورز کو اپنے Customize صفحے پر فہرست کرتا ہے؛ quran-gallery اپنے ٹولز کے ساتھ فعال دکھنا چاہیے۔
  2. Agent موڈ میں چیٹ کھولیں اور ایسا سوال پوچھیں جس کے لیے کسی متن کی ضرورت ہو (نیچے)۔

/mcp صفحے پر Cursor کے لیے ایک کلک میں انسٹال کا بٹن بھی ہے۔

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

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

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

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

مسائل کا حل

  • 429، “Keyless limit reached”۔ بغیر کلید استعمال میں فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 کی اجازت ہے۔ Retry-After ہیڈر تک انتظار کریں، یا مفت کلید شامل کریں (نیچے)۔ حدود اور غلطیاں دیکھیں۔
  • 503۔ سرور یا اس کے پیچھے لائبریری مختصر وقت کے لیے دستیاب نہیں۔ Retry-After ہیڈر کے بعد دوبارہ کوشش کریں؛ اگر کلائنٹ صفر ٹولز دکھائے تو ایک منٹ انتظار کریں اور دوبارہ کنیکٹ کریں۔
  • ٹولز ظاہر نہیں ہوتے، یا مطلوبہ ٹول غائب ہے۔ Cursor کی MCP فہرست میں سرور کو بند کر کے دوبارہ آن کریں، یا 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 سے باہر رکھیں۔

اگلے مراحل

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