الموارد المدرجة في مقابل الموارد المبنية على القوالب
قدّموا إدخالات ثابتة وأنماطًا تُنشأ عند الطلب.
الموارد المدرجة في مقابل الموارد المبنية على القوالب درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
Two Ways to Offer Data
MCP exposes data two ways: a listed resource with a fixed URI, or a templated one with placeholders. Knowing which to pick keeps your server clear.
Listed: Enumerable and Few
A listed resource has a concrete URI and shows up in resources/list. Use it when there are only a handful of known items the client can browse.
@mcp.resource("config://app")
def app_config() -> str:
return read_config()Templated: Infinite by Pattern
A templated resource uses curly-brace placeholders, so it covers countless URIs. It can't be listed in full, because the set is open-ended.
@mcp.resource("file://{path}")
def read_file(path: str) -> str:
return open(path).read()The Listing Difference
Clients call resources/list to discover fixed resources. Templates appear in a separate templates list instead, advertising the shape rather than concrete entries.
Browse vs Address
Think of it as browse vs address. Listed resources are like menu items you scan; templates are like typing an address you already know.
When the Set Is Small
If your data is a short, stable set, prefer listed resources. The model can see every option, which makes the right choice obvious to it.
When the Set Is Huge
If items number in the thousands, a template wins. Listing them all would flood the client, so you advertise the pattern and let it fill in values.
weather://{city}/todayCombine Both Freely
A real server often does both: a few listed entries for common data, plus templates for the long tail. They coexist happily side by side.
Help Discovery Along
Templates can't enumerate, but you can add a small listed index resource that points to popular URIs, giving the model useful starting points.
@mcp.resource("cities://index")
def cities() -> str:
return "london, paris, tokyo"Same Read, Either Way
However a URI is found, the client reads it the same way: one resources/read call. Listed or templated changes discovery, not how content is fetched.
Why This Matters
Choosing listed vs templated shapes how easily a model finds your data. Pick listed for browsing, templated for scale, and your server stays usable. 🎯
Quick Check
Which resource type should you use for thousands of items?
Recap
You learned that listed resources suit small browsable sets while templated ones scale to huge collections, and the two combine well. Next: notifying clients of updates. 🚀
الأسئلة الشائعة
هل درس «الموارد المدرجة في مقابل الموارد المبنية على القوالب» مجاني؟
نعم — نص درس «الموارد المدرجة في مقابل الموارد المبنية على القوالب» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «الموارد المدرجة في مقابل الموارد المبنية على القوالب»؟
قدّموا إدخالات ثابتة وأنماطًا تُنشأ عند الطلب. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «الموارد المدرجة في مقابل الموارد المبنية على القوالب»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- معرّفات URI ذات المعلمات للموارد
- إنشاء المحتوى وقت القراءة
- الموارد المدرجة في مقابل الموارد المبنية على القوالب
- إشعار العملاء بالتحديثات