Gemini CLI-কে ইসলামিক গ্রন্থ MCP সার্ভারের সাথে সংযুক্ত করুন
একটি কমান্ডে অথবা settings.json দিয়ে Gemini CLI-তে Quran Gallery MCP সার্ভার যোগ করুন: ক্লাসিক্যাল আরবি বই, ছাপা-পৃষ্ঠার উদ্ধৃতি, কোনো কী লাগবে না।
এই পাতায়
কোনো অ্যাকাউন্ট, সাইন-ইন বা কী লাগবে না। একটিমাত্র কমান্ড:
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 এন্ডপয়েন্ট হিসেবে পড়ে।
প্রথম যে প্রম্পটটি চেষ্টা করবেন
Find the hadith «إنما الأعمال بالنيات» in the primary collections and tell me which book, edition, volume and page it is printed on. Quote the Arabic exactly.
আপনার অ্যাসিস্ট্যান্ট shamela_search_library (অথবা search, তারপর fetch) কল করবে। ফলাফলের মধ্যে আছে صحيح البخاري, ط السلطانية, page 1/6, মাকতাবাহ রিডারে সেই পৃষ্ঠার লিংকসহ। যদি সে স্মৃতি থেকে উত্তর দেয়, বলুন: “Use the Quran Gallery library tool and quote what it returns.”
সার্চ কুয়েরি অবশ্যই আরবিতে হতে হবে; আপনার অ্যাসিস্ট্যান্ট ইংরেজি শব্দগুলো আগে অনুবাদ করে নেয় (বিস্তারিত)। তাখরীজ, কোনো অংশ উদ্ধৃত করা এবং তাফসীর তুলনার তৈরি প্রম্পট পূর্ণ টুল তালিকায় আছে।
সমস্যা সমাধান
- 400, “schema at properties.transmission.items.items must be a boolean or an object”. আমাদের সার্ভারের একটি আগের সংস্করণ এমন একটি টুল স্কিমা পাঠিয়েছিল যা Gemini API প্রত্যাখ্যান করত, এবং প্রতিটি প্রম্পট এই ত্রুটিতে ব্যর্থ হতো। এটি ঠিক করা হয়েছে।
geminiপুনরায় চালু করুন। - 429, “Keyless limit reached”. কী ছাড়া ব্যবহারে প্রতি IP ঠিকানায় মিনিটে ১০টি এবং দিনে ২০০টি টুল কল চলে।
Retry-Afterহেডার পর্যন্ত অপেক্ষা করুন, অথবা একটি বিনামূল্যের কী যোগ করুন (নিচে)। দেখুন সীমা ও ত্রুটি। - 503. সার্ভার বা তার পেছনের লাইব্রেরি সাময়িকভাবে অনুপলব্ধ।
Retry-Afterহেডারের পর আবার চেষ্টা করুন। ক্লায়েন্ট শূন্য টুল দেখালে এক মিনিট অপেক্ষা করে আবার সংযুক্ত হোন। - টুল দেখা যাচ্ছে না, বা প্রত্যাশিত কোনো টুল নেই।
geminiপুনরায় চালু করে/mcp listচালান। টুল তালিকা চালু হওয়ার সময় পড়া হয়। gemini mcp listসার্ভারটিকে Disabled দেখায়, অথবা “Gemini CLI is not running in a trusted directory” আসে। যে ফোল্ডারকে আপনি trust করেননি, সেখানে Gemini CLI MCP সার্ভার বন্ধ রাখে, আরgemini mcp remove-ও সেখানে সেগুলো খুঁজে পায় না। সেই ফোল্ডারে একবারgeminiখুলে সেটিকে trust করুন। স্ক্রিপ্টে বা-pদিয়ে এর বদলে--skip-trustদিতে পারেন।- সংযোগ সাথে সাথেই ব্যর্থ হয়। এন্ডপয়েন্ট হলো
/mcp/shamela। শুধু/mcpএকটি ওয়েব পৃষ্ঠা, সার্ভার নয়।
ঐচ্ছিক: বেশি সীমার জন্য বিনামূল্যের কী
কী কখনোই বাধ্যতামূলক নয়। একটি বিনামূল্যের কী সীমা বাড়িয়ে মিনিটে ৬০ কল করে এবং কী-বিহীন ব্যবহারের পৃষ্ঠা-পরিসরের সীমা তুলে দেয়। আপনার Quran Gallery অ্যাকাউন্টের 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" }
}
}
}আপনি যে কোনো সেটিংস ফাইল কমিট করেন, তার বাইরে কী-টি রাখুন।