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

الجذور

فهم الجذور في MCP
الجذور هي مفهوم في MCP يحدد الحدود التي يمكن للخوادم أن تعمل ضمنها. إنها توفر طريقة للعملاء لإعلام الخوادم بالموارد ذات الصلة ومواقعها.

ما هي الجذور؟#

الجذر هو URI يقترح العميل أن يركز الخادم عليه. عندما يتصل عميل بخادم، فإنه يعلن عن الجذور التي يجب أن يعمل معها الخادم. على الرغم من استخدامها في المقام الأول لمسارات نظام الملفات، يمكن أن تكون الجذور أي URI صالح بما في ذلك عناوين URL لـ HTTP.
على سبيل المثال، يمكن أن تكون الجذور:
file:///home/user/projects/myapp
https://api.example.com/v1

لماذا نستخدم الجذور؟#

تخدم الجذور عدة أغراض مهمة:
1.
التوجيه: إنها تُعلم الخوادم بالموارد والمواقع ذات الصلة
2.
الوضوح: تجعل الجذور من الواضح الموارد التي تشكل جزءًا من مساحة العمل الخاصة بك
3.
التنظيم: تتيح لك الجذور المتعددة العمل مع موارد مختلفة في وقت واحد

كيف تعمل الجذور#

عندما يدعم العميل الجذور، فإنه:
1.
يعلن عن إمكانية roots أثناء الاتصال
2.
يقدم قائمة بالجذور المقترحة للخادم
3.
يخطر الخادم عند تغيير الجذور (إذا كان مدعومًا)
في حين أن الجذور إعلامية وليست إلزامية بشكل صارم، يجب على الخوادم:
1.
احترام الجذور المقدمة
2.
استخدام URIs الجذر لتحديد مواقع الموارد والوصول إليها
3.
إعطاء الأولوية للعمليات داخل حدود الجذر

حالات الاستخدام الشائعة#

تستخدم الجذور بشكل شائع لتحديد:
مسارات المشروع
مواقع المستودعات
نقاط نهاية API
مواقع التكوين
حدود الموارد

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

عند العمل مع الجذور:
1.
اقترح فقط الموارد الضرورية
2.
استخدم أسماء واضحة ووصفيّة للجذور
3.
مراقبة إمكانية الوصول إلى الجذر
4.
التعامل مع تغييرات الجذر بأمان

مثال#

إليك كيف يمكن لعميل MCP نموذجي أن يكشف عن الجذور:
{
  "roots": [
    {
      "uri": "file:///home/user/projects/frontend",
      "name": "Frontend Repository"
    },
    {
      "uri": "https://api.example.com/v1",
      "name": "API Endpoint"
    }
  ]
}
يقترح هذا التكوين أن يركز الخادم على كل من مستودع محلي ونقطة نهاية API مع إبقائهما منفصلين منطقيًا.
Modified at 2025-03-12 10:42:12
Previous
أخذ العينات
Next
وسائل النقل
Built with