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

GitHub Copilot-এ ইসলামিক বই MCP সার্ভার ব্যবহার করুন

VS Code-এর GitHub Copilot agent mode-কে Quran Gallery MCP সার্ভার দিন: ছাপা-পৃষ্ঠার উদ্ধৃতিসহ ক্লাসিক্যাল আরবি বই, অ্যাকাউন্ট বা কী ছাড়াই।

এই পাতায়

কোনো অ্যাকাউন্ট, সাইন-ইন বা কী লাগবে না। VS Code-এর GitHub Copilot VS Code-এর মতোই একই MCP কনফিগারেশন ব্যবহার করে এবং agent mode থেকে MCP টুল কল করে।

ধাপসমূহ

  1. আপনার ওয়ার্কস্পেসে .vscode/mcp.json তৈরি করুন (অথবা Command Palette থেকে MCP: Add Server চালান):
{
	"servers": {
		"quran-gallery": { "type": "http", "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. এন্ট্রির উপরের Start অ্যাকশন দিয়ে সার্ভারটি চালু করুন এবং এটিকে ট্রাস্ট করুন।
  2. Copilot চ্যাট ভিউ খুলে Agent মোডে যান। টুল পিকার খুলে নিশ্চিত করুন quran-gallery-র টুলগুলো টিক দেওয়া আছে।
  3. এমন একটি প্রশ্ন করুন যার জন্য কোনো গ্রন্থের পাঠ দরকার (নিচে)।

প্রতিষ্ঠানের নীতি Copilot-এর জন্য MCP সার্ভার নিষ্ক্রিয় করতে পারে; টুল কখনো না এলে আপনার অ্যাডমিনকে জিজ্ঞাসা করুন MCP অনুমোদিত কি না। পূর্ণ ধাপ ও কী সেটআপ VS Code পৃষ্ঠায় আছে।

প্রথম যে প্রম্পটটি চেষ্টা করবেন

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.”

সার্চ কুয়েরি অবশ্যই আরবিতে হতে হবে; আপনার অ্যাসিস্ট্যান্ট ইংরেজি শব্দগুলো আগে অনুবাদ করে নেয় (বিস্তারিত)। তাখরীজ, কোনো অংশ উদ্ধৃত করা এবং তাফসীর তুলনার তৈরি প্রম্পট পূর্ণ টুল তালিকায় আছে।

সমস্যা সমাধান

  • 429, “Keyless limit reached”. কী ছাড়া ব্যবহারে প্রতি IP ঠিকানায় মিনিটে ১০টি এবং দিনে ২০০টি টুল কল চলে। Retry-After হেডার পর্যন্ত অপেক্ষা করুন, অথবা একটি বিনামূল্যের কী যোগ করুন (নিচে)। দেখুন সীমা ও ত্রুটি।
  • 503. সার্ভার বা তার পেছনের লাইব্রেরি সাময়িকভাবে অনুপলব্ধ। Retry-After হেডারের পর আবার চেষ্টা করুন; ক্লায়েন্ট শূন্য টুল দেখালে এক মিনিট অপেক্ষা করে আবার সংযুক্ত হোন।
  • টুল দেখা যাচ্ছে না, বা প্রত্যাশিত কোনো টুল নেই। টুল পিকার খুলে নিশ্চিত করুন সার্ভারটি টিক দেওয়া আছে; MCP: List Servers থেকে সার্ভারটি পুনরায় চালু করুন।
  • সংযোগ সাথে সাথেই ব্যর্থ হয়। এন্ডপয়েন্ট হলো /mcp/shamela; শুধু /mcp একটি ওয়েব পৃষ্ঠা, সার্ভার নয়।

ঐচ্ছিক: বেশি সীমার জন্য বিনামূল্যের কী

কী কখনোই বাধ্যতামূলক নয়। একটি বিনামূল্যের কী সীমা বাড়িয়ে মিনিটে ৬০ কল করে এবং কী-বিহীন ব্যবহারের পৃষ্ঠা-পরিসরের সীমা তুলে দেয়। VS Code পৃষ্ঠায় যেমন দেখানো আছে ঠিক তেমন একটি headers এন্ট্রি যোগ করুন। আপনার Quran Gallery অ্যাকাউন্টের Developers পৃষ্ঠায় একটি কী তৈরি করুন (কী কীভাবে কাজ করে)।

পরবর্তী ধাপ

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