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

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

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

এই পাতায়

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

ধাপসমূহ

  1. ~/.cursor/mcp.json (সব প্রজেক্ট) অথবা কোনো প্রজেক্টের .cursor/mcp.json (শুধু সেই প্রজেক্ট) খুলুন। ফাইলটি না থাকলে তৈরি করুন।
  2. সার্ভারটি যোগ করুন:
{
	"mcpServers": {
		"quran-gallery": { "url": "https://qurangallery.com/mcp/shamela" }
	}
}
  1. সেভ করুন। Cursor তার Customize পৃষ্ঠায় MCP সার্ভারগুলোর তালিকা দেখায়; quran-gallery চালু অবস্থায় এবং তার টুলসহ দেখা উচিত।
  2. Agent মোডে একটি চ্যাট খুলে এমন একটি প্রশ্ন করুন যার জন্য কোনো গ্রন্থের পাঠ দরকার (নিচে)।

/mcp পৃষ্ঠায় Cursor-এর জন্য এক-ক্লিক ইনস্টল বোতামও আছে।

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

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 হেডারের পর আবার চেষ্টা করুন; ক্লায়েন্ট শূন্য টুল দেখালে এক মিনিট অপেক্ষা করে আবার সংযুক্ত হোন।
  • টুল দেখা যাচ্ছে না, বা প্রত্যাশিত কোনো টুল নেই। Cursor-এর MCP তালিকায় সার্ভারটি বন্ধ করে আবার চালু করুন, অথবা Cursor পুনরায় চালু করুন; টুল তালিকা প্রতিটি সেশনে ক্যাশ করা থাকে।
  • সংযোগ সাথে সাথেই ব্যর্থ হয়। এন্ডপয়েন্ট হলো /mcp/shamela; শুধু /mcp একটি ওয়েব পৃষ্ঠা, সার্ভার নয়।

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

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

একটি headers এন্ট্রি যোগ করুন:

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

কী আছে এমন ফাইল git-এর বাইরে রাখুন।

পরবর্তী ধাপ

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