شرح معرّفات URI الخاصة بالموارد
تعلّموا كيفية عنونة الموارد باستخدام المخطط والمسار.
شرح معرّفات URI الخاصة بالموارد درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
ما هو المورد
مورد MCP هو سياق للقراءة فقط يقدّمه خادمك للنموذج، مثل ملف أو إعدادات أو سجل. يستطيع الذكاء الاصطناعي قراءته، لكنه لا يغيّره أبدًا.
لماذا نستخدم عنوانًا
يحتاج كل مورد إلى اسم ثابت حتى يتمكن العميل من طلبه بالمرجع. وهذا الاسم هو URI الخاص به، تمامًا كما تمتلك صفحة الويب عنوان URL. 🔗
المخطط ثم المسار
يتكوّن URI المورد من مخطط، يليه نقطتان وشرطات مائلة، ثم مسار. ويحدد المخطط نوع الشيء الذي يشير إليه URI.
file:///notes/today.txt
config://app/settingsاختر مخططك الخاص
يمكنك ابتكار مخطط يناسب خادمك، مثل config أو db. ويجمع المخطط الموارد المرتبطة تحت تسمية واضحة واحدة.
مخطط file
يُستخدم مخطط file كثيرًا للمستندات الموجودة على القرص. وتعني الشرطات المائلة الثلاث أن المسار يبدأ من الجذر، تمامًا مثل عناوين file في المتصفح.
file:///home/data/report.mdمثال على مخطط مخصص
بالنسبة إلى بيانات التطبيق، يحافظ مخطط مخصص ومنظم على سهولة القراءة. ويرى النموذج اسمًا يوضح له بالضبط ما يحتويه المورد.
users://profile/active
weather://city/londonيجب أن تكون URIs فريدة
يحتاج كل مورد إلى URI مميز خاص به حتى لا تكون الطلبات ملتبسة. فإذا اشترك موردان في URI واحد، فسيحدث تعارض وسترتبك العملاء.
التصريح به في FastMCP
في Python SDK، تربط URI بدالة باستخدام مزخرف resource. وتصبح هذه السلسلة العنوان الذي يستخدمه العملاء لقراءة المورد.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.resource("config://app")
def config(): ...يعرض العملاء قائمة URIs
عند اتصال عميل، يطلب من الخادم عرض قائمة بكل الموارد التي يوفّرها. ويحمل كل إدخال URI واسمًا ووصفًا موجزًا.
القراءة حسب URI
لجلب المحتوى، يرسل العميل طلب قراءة يتضمن URI المحدد بدقة. ويطابق الخادم هذا URI مع معالج، ثم يعيد المحتوى.
حافظ على ثبات URIs
تعامل مع URI المنشور كأنه وعد. فتغيير اسمه لاحقًا يعطّل أي عميل أو مرجع محفوظ كان يشير إلى العنوان القديم.
تحقق سريع
حدّد الجزء الذي يعرّف نوع المورد.
مراجعة
الموارد سياق للقراءة فقط، ويُحدَّد باسم URI يتكوّن من مخطط ومسار. حافظ على فرادة URIs وثباتها حتى يتمكن العملاء من الاعتماد عليها. ✅
الأسئلة الشائعة
هل درس «شرح معرّفات URI الخاصة بالموارد» مجاني؟
نعم — نص درس «شرح معرّفات URI الخاصة بالموارد» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «شرح معرّفات URI الخاصة بالموارد»؟
تعلّموا كيفية عنونة الموارد باستخدام المخطط والمسار. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «شرح معرّفات URI الخاصة بالموارد»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- شرح معرّفات URI الخاصة بالموارد
- تقديم مورد نصي ثابت
- قراءة ملف من القرص
- ضبط نوع MIME الصحيح