Gemini CLI کو اسلامی متون کے MCP سرور سے جوڑیں
قرآن گیلری MCP سرور کو ایک کمانڈ یا settings.json سے Gemini CLI میں شامل کریں: عربی کلاسیکی کتب، چھپے صفحے کے حوالے، کلید درکار نہیں۔
اس صفحے پر
نہ اکاؤنٹ، نہ سائن اِن، نہ کلید۔ ایک کمانڈ:
gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamelaمراحل
اوپر والی کمانڈ اپنے پروجیکٹ فولڈر کے اندر چلائیں۔ یہ سرور کو اسی فولڈر کی
.gemini/settings.jsonمیں لکھ دیتی ہے۔ اسے~/.gemini/settings.jsonمیں لکھنے کے لیے--scope userشامل کریں، تاکہ یہ ہر پروجیکٹ میں کام کرے۔gemini mcp listچلائیں۔quran-galleryConnected دکھنا چاہیے۔
geminiشروع کریں اور ایسا سوال پوچھیں جس کے لیے کسی متن کی ضرورت ہو (نیچے)۔ Gemini CLI پہلی بار ہر ٹول کال سے پہلے پوچھتا ہے۔ اسے منظور کریں۔
جواب میں ایڈیشن، جلد اور چھپا ہوا صفحہ، اور مکتبہ ریڈر میں اس صفحے کا لنک دیا جاتا ہے۔ لنک کی شکل https://qurangallery.com/maktabah/book/{bookId}/{pageId} ہے، جیسے صحیح بخاری کے لیے qurangallery.com/maktabah/book/1681/10، اس لیے یہ صفحہ Quran Gallery پر کھلتا ہے:

ہٹانے کے لیے: gemini mcp remove quran-gallery۔
یا settings.json خود ایڈٹ کریں
سرور کو ~/.gemini/settings.json (تمام پروجیکٹس) یا .gemini/settings.json (ایک پروجیکٹ) میں شامل کریں:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http"
}
}
}کمانڈ یہی لکھتی ہے۔ "httpUrl": "https://qurangallery.com/mcp/shamela" بھی کام کرتا ہے۔ url کے ساتھ "type": "http" رکھیں، کیونکہ Gemini CLI کے پرانے ورژنز سادہ url کو SSE اینڈ پوائنٹ سمجھ کر پڑھتے ہیں۔
پہلا پرامپٹ جو آزمائیں
«إنما الأعمال بالنيات» والی حدیث بنیادی مجموعوں میں تلاش کریں اور بتائیں کہ وہ کس کتاب، ایڈیشن، جلد اور صفحے پر چھپی ہے۔ عربی عبارت بالکل ویسی ہی نقل کریں۔
آپ کے اسسٹنٹ کو shamela_search_library (یا search پھر fetch) کال کرنا چاہیے۔ نتائج میں صحيح البخاري، ط السلطانية، صفحہ 1/6 شامل ہے، مکتبہ ریڈر میں اس صفحے کے لنک کے ساتھ۔ اگر وہ یادداشت سے جواب دے تو کہیں: “قرآن گیلری لائبریری ٹول استعمال کریں اور جو وہ لوٹائے اسے نقل کریں۔”
تلاش کے سوالات عربی میں ہونے چاہییں؛ آپ کا اسسٹنٹ انگریزی الفاظ کا پہلے ترجمہ کرتا ہے (تفصیل)۔ تخریج، عبارت کا حوالہ دینے اور تفاسیر کے موازنے کے لیے تیار پرامپٹس مکمل ٹول فہرست میں درج ہیں۔
مسائل کا حل
- 400، “schema at properties.transmission.items.items must be a boolean or an object”۔ ہمارے سرور کے ایک پرانے ورژن نے ایسا ٹول اسکیما بھیجا جسے Gemini API نے مسترد کر دیا، اور ہر پرامپٹ اسی غلطی کے ساتھ ناکام ہو جاتا تھا۔ اسے ٹھیک کر دیا گیا ہے۔
geminiری اسٹارٹ کریں۔ - 429، “Keyless limit reached”۔ بغیر کلید استعمال میں فی IP ایڈریس فی منٹ 10 ٹول کالز اور روزانہ 200 کی اجازت ہے۔
Retry-Afterہیڈر تک انتظار کریں، یا مفت کلید شامل کریں (نیچے)۔ حدود اور غلطیاں دیکھیں۔ - 503۔ سرور یا اس کے پیچھے لائبریری مختصر وقت کے لیے دستیاب نہیں۔
Retry-Afterہیڈر کے بعد دوبارہ کوشش کریں۔ اگر کلائنٹ صفر ٹولز دکھائے تو ایک منٹ انتظار کریں اور دوبارہ کنیکٹ کریں۔ - ٹولز ظاہر نہیں ہوتے، یا مطلوبہ ٹول غائب ہے۔
geminiری اسٹارٹ کریں اور/mcp listچلائیں۔ ٹولز کی فہرست شروع میں پڑھی جاتی ہے۔ gemini mcp listسرور کو Disabled دکھاتا ہے، یا “Gemini CLI is not running in a trusted directory” آتا ہے۔ جس فولڈر پر آپ نے اعتماد نہ کیا ہو، اس میں Gemini CLI MCP سرورز بند رکھتا ہے، اورgemini mcp removeبھی انہیں وہاں نہیں ڈھونڈ پاتا۔ اس فولڈر میں ایک بارgeminiکھولیں اور اس پر اعتماد کریں۔ اسکرپٹ میں یا-pکے ساتھ آپ اس کے بجائے--skip-trustدے سکتے ہیں۔- فوراً کنکشن ناکام ہو جائے۔ اینڈ پوائنٹ
/mcp/shamelaہے۔ سادہ/mcpایک ویب صفحہ ہے، سرور نہیں۔
اختیاری: زیادہ حدوں کے لیے مفت کلید
کلید کبھی لازمی نہیں۔ مفت کلید حد کو فی منٹ 60 کالز تک بڑھاتی ہے اور بغیر کلید والی صفحاتی حدیں ہٹا دیتی ہے۔ اپنے قرآن گیلری اکاؤنٹ کے Developers صفحے پر ایک بنائیں (کلیدیں کیسے کام کرتی ہیں)، پھر اسے bearer ٹوکن کے طور پر بھیجیں۔
اسے --header (یا -H) سے شامل کریں:
gemini mcp add --transport http quran-gallery
https://qurangallery.com/mcp/shamela
--header "Authorization: Bearer qg_sk_your_key_here"settings.json میں یہی کلید url کے ساتھ headers آبجیکٹ میں جاتی ہے:
{
"mcpServers": {
"quran-gallery": {
"url": "https://qurangallery.com/mcp/shamela",
"type": "http",
"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
}
}
}کلید کو کسی بھی ایسی سیٹنگز فائل سے باہر رکھیں جسے آپ کمٹ کرتے ہیں۔