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

الهندسة المعمارية الأساسية

فهم كيفية ربط MCP للعملاء والخوادم ونماذج اللغة الكبيرة (LLMs)#

يعتمد بروتوكول سياق النموذج (MCP) على بنية مرنة وقابلة للتوسيع تتيح اتصالاً سلسًا بين تطبيقات LLM وعمليات التكامل. تغطي هذه الوثيقة المكونات والمفاهيم المعمارية الأساسية.

نظرة عامة#

يتبع MCP بنية العميل والخادم حيث:
المضيفون هم تطبيقات LLM (مثل Claude Desktop أو بيئات التطوير المتكاملة IDEs) التي تبدأ الاتصالات
العملاء يحتفظون باتصالات 1:1 مع الخوادم، داخل تطبيق المضيف
الخوادم توفر السياق والأدوات والمطالبات للعملاء
image-20250312145458026

المكونات الأساسية#

طبقة البروتوكول#

تتعامل طبقة البروتوكول مع تأطير الرسائل، وربط الطلبات/الاستجابات، وأنماط الاتصال عالية المستوى.
TypeScript
Python
تتضمن الفئات الرئيسية:
Protocol
Client
Server

طبقة النقل#

تتعامل طبقة النقل مع الاتصال الفعلي بين العملاء والخوادم. يدعم MCP آليات نقل متعددة:
1.
نقل Stdio
يستخدم الإدخال/الإخراج القياسي للاتصال
مثالي للعمليات المحلية
2.
HTTP مع نقل SSE
يستخدم Server-Sent Events للرسائل من الخادم إلى العميل
HTTP POST للرسائل من العميل إلى الخادم
تستخدم جميع عمليات النقل JSON-RPC 2.0 لتبادل الرسائل. راجع المواصفات للحصول على معلومات مفصلة حول تنسيق رسائل بروتوكول سياق النموذج Model Context Protocol.

أنواع الرسائل#

يحتوي MCP على هذه الأنواع الرئيسية من الرسائل:
1.
الطلبات تتوقع استجابة من الجانب الآخر:
2.
النتائج هي استجابات ناجحة للطلبات:
3.
الأخطاء تشير إلى فشل الطلب:
4.
الإشعارات هي رسائل أحادية الاتجاه لا تتوقع استجابة:

دورة حياة الاتصال#

1. التهيئة#

image.png
1.
يرسل العميل طلب initialize مع إصدار البروتوكول والقدرات
2.
يستجيب الخادم بإصدار البروتوكول والقدرات الخاصة به
3.
يرسل العميل إشعار initialized كإقرار
4.
يبدأ تبادل الرسائل العادي

2. تبادل الرسائل#

بعد التهيئة، يتم دعم الأنماط التالية:
طلب-استجابة: يرسل العميل أو الخادم طلبات، ويستجيب الآخر
الإشعارات: يرسل أي من الطرفين رسائل أحادية الاتجاه

3. الإنهاء#

يمكن لأي من الطرفين إنهاء الاتصال:
إيقاف التشغيل النظيف عبر close()
قطع اتصال النقل
شروط الخطأ

معالجة الأخطاء#

يحدد MCP رموز الخطأ القياسية التالية:
يمكن لمجموعات SDK والتطبيقات تحديد رموز الخطأ الخاصة بها أعلى من -32000.
يتم نشر الأخطاء من خلال:
استجابات الخطأ للطلبات
أحداث الخطأ على عمليات النقل
معالجات الأخطاء على مستوى البروتوكول

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

إليك مثال أساسي لتنفيذ خادم MCP:
TypeScript
Python

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

تحديد النقل#

1.
الاتصال المحلي
استخدم نقل stdio للعمليات المحلية
فعال للاتصال على نفس الجهاز
إدارة عمليات بسيطة
2.
الاتصال عن بعد
استخدم SSE للسيناريوهات التي تتطلب توافق HTTP
ضع في اعتبارك الآثار الأمنية بما في ذلك المصادقة والترخيص

معالجة الرسائل#

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

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

1.
أمان النقل
استخدم TLS للاتصالات البعيدة
تحقق من صحة أصول الاتصال
قم بتنفيذ المصادقة عند الحاجة
2.
التحقق من صحة الرسائل
تحقق من صحة جميع الرسائل الواردة
قم بتطهير المدخلات
تحقق من حدود حجم الرسالة
تحقق من تنسيق JSON-RPC
3.
حماية الموارد
قم بتنفيذ عناصر التحكم في الوصول
تحقق من صحة مسارات الموارد
راقب استخدام الموارد
تحديد معدل الطلبات
4.
معالجة الأخطاء
لا تسرب معلومات حساسة
سجل الأخطاء ذات الصلة بالأمان
قم بتنفيذ التنظيف المناسب
التعامل مع سيناريوهات رفض الخدمة DoS

التصحيح والمراقبة#

1.
تسجيل الدخول
سجل أحداث البروتوكول
تتبع تدفق الرسائل
راقب الأداء
سجل الأخطاء
2.
التشخيص
تنفيذ فحوصات السلامة
راقب حالة الاتصال
تتبع استخدام الموارد
تحديد الأداء
3.
الاختبار
اختبر عمليات نقل مختلفة
تحقق من معالجة الأخطاء
تحقق من الحالات الشاذة
خوادم اختبار التحميل
Modified at 2025-03-12 10:37:28
Previous
مفتش
Next
موارد
Built with