وثائق MCP الرسمية باللغة العربية
  1. المفاهيم
وثائق MCP الرسمية باللغة العربية
  • البدء
    • مقدمة
    • خوادم المثال
    • أمثلة على العملاء
    • البدء السريع
      • لمطوري الخوادم
      • للمطورين العملاء
      • لمستخدمي سطح مكتب كلود
  • دروس تعليمية
    • LLMs بناء MCP مع
    • تصحيح الأخطاء
    • مفتش
  • المفاهيم
    • الهندسة المعمارية الأساسية
    • موارد
    • المطالبات
    • أدوات
    • أخذ العينات
    • الجذور
    • وسائل النقل
  • تطوير
    • ما الجديد
    • خريطة الطريق
    • المساهمة
  1. المفاهيم

موارد

عرض البيانات والمحتوى من خوادمك إلى نماذج اللغات الكبيرة (LLMs)#

الموارد هي لبنة أساسية في بروتوكول سياق النموذج (MCP) تسمح للخوادم بعرض البيانات والمحتوى الذي يمكن للعملاء قراءته واستخدامه كسياق لتفاعلات نماذج اللغات الكبيرة (LLMs).
تم تصميم الموارد لتكون مُتحكمًا بها بواسطة التطبيق، مما يعني أن تطبيق العميل يمكنه تحديد كيفية ومتى يجب استخدامها. قد تتعامل عملاء MCP المختلفون مع الموارد بشكل مختلف. على سبيل المثال:
يتطلب Claude Desktop حاليًا من المستخدمين تحديد الموارد بشكل صريح قبل أن يتمكنوا من استخدامها.
قد تقوم عملاء آخرون بتحديد الموارد تلقائيًا بناءً على طرق استدلالية.
قد تسمح بعض التطبيقات حتى للنموذج الذكاء الاصطناعي نفسه بتحديد الموارد التي سيتم استخدامها.
يجب أن يكون مؤلفو الخادم مستعدين للتعامل مع أي من أنماط التفاعل هذه عند تنفيذ دعم الموارد. من أجل عرض البيانات على النماذج تلقائيًا، يجب على مؤلفي الخادم استخدام لبنة مُتحكمًا بها بواسطة النموذج مثل الأدوات.

نظرة عامة#

تمثل الموارد أي نوع من البيانات التي يريد خادم MCP إتاحتها للعملاء. يمكن أن يشمل ذلك:
محتويات الملفات
سجلات قواعد البيانات
استجابات واجهة برمجة التطبيقات (API)
بيانات النظام الحية
لقطات الشاشة والصور
ملفات السجل
والمزيد
يتم تحديد كل مورد بواسطة معرف URI فريد ويمكن أن يحتوي إما على نص أو بيانات ثنائية.

معرفات URI للموارد#

يتم تحديد الموارد باستخدام معرفات URI التي تتبع هذا التنسيق:
[protocol]://[host]/[path]
على سبيل المثال:
file:///home/user/documents/report.pdf
postgres://database/customers/schema
screen://localhost/display1
يتم تعريف البروتوكول وهيكل المسار بواسطة تطبيق خادم MCP. يمكن للخوادم تحديد أنظمة URI مخصصة خاصة بها.

أنواع الموارد#

يمكن أن تحتوي الموارد على نوعين من المحتوى:

موارد نصية#

تحتوي الموارد النصية على بيانات نصية مشفرة بتنسيق UTF-8. هذه مناسبة لـ:
شفرة المصدر
ملفات التكوين
ملفات السجل
بيانات JSON/XML
نص عادي

موارد ثنائية#

تحتوي الموارد الثنائية على بيانات ثنائية خام مشفرة بـ base64. هذه مناسبة لـ:
الصور
ملفات PDF
ملفات صوتية
ملفات الفيديو
تنسيقات أخرى غير نصية

اكتشاف الموارد#

يمكن للعملاء اكتشاف الموارد المتاحة من خلال طريقتين رئيسيتين:

الموارد المباشرة#

تعرض الخوادم قائمة بالموارد الملموسة عبر نقطة النهاية resources/list. يتضمن كل مورد:

قوالب الموارد#

بالنسبة للموارد الديناميكية، يمكن للخوادم عرض قوالب URI التي يمكن للعملاء استخدامها لإنشاء معرفات URI صالحة للموارد:

قراءة الموارد#

لقراءة مورد، يقوم العملاء بتقديم طلب resources/read بمعرف URI الخاص بالموارد.
يستجيب الخادم بقائمة بمحتويات الموارد:
قد تُرجع الخوادم موارد متعددة استجابة لطلب resources/read واحد. يمكن استخدام هذا، على سبيل المثال، لإرجاع قائمة بالملفات داخل دليل عند قراءة الدليل.

تحديثات الموارد#

يدعم MCP تحديثات في الوقت الفعلي للموارد من خلال آليتين:

تغييرات القائمة#

يمكن للخوادم إخطار العملاء عندما تتغير قائمة الموارد المتاحة لديهم عبر إشعار notifications/resources/list_changed.

تغييرات المحتوى#

يمكن للعملاء الاشتراك في تحديثات لموارد معينة:
1.
يرسل العميل resources/subscribe مع معرف URI الخاص بالموارد
2.
يرسل الخادم notifications/resources/updated عند تغيير المورد
3.
يمكن للعميل جلب أحدث محتوى باستخدام resources/read
4.
يمكن للعميل إلغاء الاشتراك باستخدام resources/unsubscribe

مثال على التنفيذ#

إليك مثال بسيط لتنفيذ دعم الموارد في خادم MCP:
TypeScript
Python

أفضل الممارسات#

عند تنفيذ دعم الموارد:
1.
استخدم أسماء ومعرفات URI واضحة و وصفية للموارد
2.
قم بتضمين أوصاف مفيدة لتوجيه فهم نماذج اللغات الكبيرة (LLM)
3.
قم بتعيين أنواع MIME المناسبة عند معرفتها
4.
قم بتنفيذ قوالب الموارد للمحتوى الديناميكي
5.
استخدم الاشتراكات للموارد المتغيرة بشكل متكرر
6.
تعامل مع الأخطاء بأمان مع رسائل خطأ واضحة
7.
ضع في اعتبارك التقسيم إلى صفحات لقوائم الموارد الكبيرة
8.
قم بتخزين محتويات الموارد مؤقتًا عند الاقتضاء
9.
تحقق من صحة معرفات URI قبل المعالجة
10.
وثق أنظمة URI المخصصة الخاصة بك

اعتبارات أمنية#

عند عرض الموارد:
تحقق من صحة جميع معرفات URI الخاصة بالموارد
قم بتنفيذ عناصر تحكم وصول مناسبة
قم بتطهير مسارات الملفات لمنع اجتياز الدليل
كن حذرًا في التعامل مع البيانات الثنائية
ضع في اعتبارك تحديد المعدل لعمليات قراءة الموارد
تدقيق الوصول إلى الموارد
قم بتشفير البيانات الحساسة أثناء النقل
تحقق من صحة أنواع MIME
قم بتنفيذ مهلات لعمليات القراءة طويلة الأمد
تعامل مع تنظيف الموارد بشكل مناسب
Modified at 2025-03-12 10:38:16
Previous
الهندسة المعمارية الأساسية
Next
المطالبات
Built with