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

وسائل النقل

بالتأكيد ، إليك ترجمة المحتوى إلى اللغة العربية مع الالتزام بالتعليمات:
تعرف على آليات الاتصال في Model Context Protocol (MCP)
توفر وسائل النقل في Model Context Protocol (MCP) الأساس للتواصل بين العملاء والخوادم. تتعامل وسيلة النقل مع الآليات الأساسية لكيفية إرسال واستقبال الرسائل.

تنسيق الرسائل#

يستخدم MCP JSON-RPC 2.0 كتنسيق سلكي. تقع مسؤولية طبقة النقل على تحويل رسائل بروتوكول MCP إلى تنسيق JSON-RPC للإرسال وتحويل رسائل JSON-RPC المستلمة مرة أخرى إلى رسائل بروتوكول MCP.
هناك ثلاثة أنواع من رسائل JSON-RPC المستخدمة:

الطلبات#

الاستجابات#

الإشعارات#

أنواع النقل المضمنة#

يتضمن MCP تطبيقين قياسيين للنقل:

الإدخال/الإخراج القياسي (stdio)#

تمكن وسيلة النقل stdio الاتصال من خلال تدفقات الإدخال والإخراج القياسية. هذا مفيد بشكل خاص لعمليات التكامل المحلية وأدوات سطر الأوامر.
استخدم stdio عندما:
بناء أدوات سطر الأوامر
تنفيذ عمليات التكامل المحلية
الحاجة إلى اتصال بسيط بين العمليات
العمل مع نصوص shell
TypeScript (الخادم)

أحداث مرسلة من الخادم (SSE)#

تمكن وسيلة النقل SSE البث من الخادم إلى العميل مع طلبات HTTP POST لاتصال العميل بالخادم.
استخدم SSE عندما:
مطلوب فقط البث من الخادم إلى العميل
العمل مع الشبكات المقيدة
تنفيذ تحديثات بسيطة
TypeScript (الخادم)

وسائل النقل المخصصة#

يسهل MCP تنفيذ وسائل نقل مخصصة لتلبية احتياجات محددة. أي تطبيق نقل يحتاج فقط إلى التوافق مع واجهة النقل:
يمكنك تنفيذ وسائل نقل مخصصة من أجل:
بروتوكولات الشبكة المخصصة
قنوات الاتصال المتخصصة
التكامل مع الأنظمة الحالية
تحسين الأداء
TypeScript
Python
لاحظ أنه على الرغم من أن خوادم MCP غالبًا ما يتم تنفيذها باستخدام asyncio ، فإننا نوصي بتنفيذ واجهات منخفضة المستوى مثل وسائل النقل باستخدام anyio لتوافق أوسع.

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

يجب أن تتعامل تطبيقات النقل مع سيناريوهات الأخطاء المختلفة:
1.
أخطاء الاتصال
2.
أخطاء تحليل الرسائل
3.
أخطاء البروتوكول
4.
مهلات الشبكة
5.
تنظيف الموارد
مثال على معالجة الأخطاء:
TypeScript
Python
لاحظ أنه على الرغم من أن خوادم MCP غالبًا ما يتم تنفيذها باستخدام asyncio ، فإننا نوصي بتنفيذ واجهات منخفضة المستوى مثل وسائل النقل باستخدام anyio لتوافق أوسع.

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

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

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

عند تنفيذ النقل:

المصادقة والترخيص#

تنفيذ آليات المصادقة المناسبة
التحقق من صحة بيانات اعتماد العميل
استخدم معالجة الرموز الآمنة
تنفيذ فحوصات الترخيص

أمن البيانات#

استخدم TLS لنقل الشبكة
تشفير البيانات الحساسة
التحقق من صحة سلامة الرسالة
تنفيذ حدود حجم الرسالة
تطهير بيانات الإدخال

أمن الشبكة#

تنفيذ تحديد المعدل
استخدم المهلات المناسبة
التعامل مع سيناريوهات رفض الخدمة
مراقبة الأنماط غير العادية
تنفيذ قواعد جدار الحماية المناسبة

تصحيح أخطاء النقل#

نصائح لتصحيح أخطاء مشكلات النقل:
1.
تمكين تسجيل تصحيح الأخطاء
2.
مراقبة تدفق الرسائل
3.
تحقق من حالات الاتصال
4.
تحقق من صحة تنسيقات الرسائل
5.
اختبار سيناريوهات الأخطاء
6.
استخدم أدوات تحليل الشبكة
7.
تنفيذ فحوصات السلامة
8.
مراقبة استخدام الموارد
9.
اختبار الحالات المتطرفة
10.
استخدم تتبع الأخطاء المناسب
Modified at 2025-03-12 10:43:20
Previous
الجذور
Next
ما الجديد
Built with