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

VS Code-এ ইসলামিক বই MCP সার্ভার যোগ করুন

mcp.json দিয়ে VS Code-এ Quran Gallery MCP সার্ভার যোগ করুন, কোনো কী ছাড়াই, এবং চ্যাটে ছাপা-পৃষ্ঠার উদ্ধৃতিসহ ক্লাসিক্যাল আরবি বই খুঁজুন।

এই পাতায়

কোনো অ্যাকাউন্ট, সাইন-ইন বা কী লাগবে না। VS Code একটি mcp.json ফাইল থেকে MCP সার্ভার পড়ে।

ধাপসমূহ

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

GitHub Copilot-এর মাধ্যমে একই সেটআপের জন্য দেখুন VS Code-এ GitHub Copilot। /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.json এডিটর থেকে সার্ভারটি পুনরায় চালু করুন (ইনলাইন Restart অ্যাকশন) অথবা MCP: List Servers চালিয়ে সেটি রিস্টার্ট করুন।
  • সংযোগ সাথে সাথেই ব্যর্থ হয়। এন্ডপয়েন্ট হলো /mcp/shamela; শুধু /mcp একটি ওয়েব পৃষ্ঠা, সার্ভার নয়।

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

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

সার্ভারে একটি headers এন্ট্রি যোগ করুন:

{
	"servers": {
		"quran-gallery": {
			"type": "http",
			"url": "https://qurangallery.com/mcp/shamela",
			"headers": { "Authorization": "Bearer qg_sk_your_key_here" }
		}
	}
}

কী আছে এমন ওয়ার্কস্পেস ফাইল কমিট করবেন না।

পরবর্তী ধাপ

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