মূল বিষয়বস্তুতে যান

Gemini CLI-কে ইসলামিক গ্রন্থ MCP সার্ভারের সাথে সংযুক্ত করুন

একটি কমান্ডে অথবা settings.json দিয়ে Gemini CLI-তে Quran Gallery MCP সার্ভার যোগ করুন: ক্লাসিক্যাল আরবি বই, ছাপা-পৃষ্ঠার উদ্ধৃতি, কোনো কী লাগবে না।

এই পাতায়

কোনো অ্যাকাউন্ট, সাইন-ইন বা কী লাগবে না। একটিমাত্র কমান্ড:

gemini mcp add --transport http quran-gallery https://qurangallery.com/mcp/shamela

ধাপসমূহ

  1. আপনার প্রজেক্ট ফোল্ডারের ভেতরে উপরের কমান্ডটি চালান। এটি সেই ফোল্ডারের .gemini/settings.json-এ সার্ভারটি লেখে। ~/.gemini/settings.json-এ লিখতে --scope user যোগ করুন, তাহলে এটি প্রতিটি প্রজেক্টে কাজ করবে।

  2. gemini mcp list চালান। quran-gallery Connected দেখানো উচিত।

    একটি টার্মিনাল: gemini mcp add সার্ভারটি .gemini/settings.json-এ লেখে, এবং gemini mcp list quran-gallery-কে Connected দেখায়।

  3. gemini চালু করে এমন একটি প্রশ্ন করুন যার জন্য কোনো গ্রন্থের পাঠ দরকার (নিচে)। Gemini CLI প্রথমবার প্রতিটি টুল কলের আগে জিজ্ঞাসা করে। অনুমোদন করুন।

উত্তরে সংস্করণ, খণ্ড ও ছাপা পৃষ্ঠা এবং মাকতাবাহ রিডারে সেই পৃষ্ঠার একটি লিংক থাকে। লিংকের গঠন https://qurangallery.com/maktabah/book/{bookId}/{pageId}, যেমন সহীহ বুখারীর জন্য qurangallery.com/maktabah/book/1681/10, তাই এটি পৃষ্ঠাটি Quran Gallery-তে খোলে:

একটি টার্মিনাল: gemini উত্তর দেয় Sahih al-Bukhari, Sultaniyya সংস্করণ, খণ্ড ১ পৃষ্ঠা ৬, এবং পৃষ্ঠার লিংকসহ।

সরাতে: 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" }
		}
	}
}

আপনি যে কোনো সেটিংস ফাইল কমিট করেন, তার বাইরে কী-টি রাখুন।

পরবর্তী ধাপ

GitHub-এ এই পাতা সম্পাদনা করুন