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

أدوات

تمكين النماذج اللغوية الكبيرة (LLMs) من تنفيذ الإجراءات من خلال خادمك
الأدوات هي بدائية قوية في Model Context Protocol (MCP) تمكن الخوادم من عرض وظائف قابلة للتنفيذ للعملاء. من خلال الأدوات، يمكن للنماذج اللغوية الكبيرة (LLMs) التفاعل مع الأنظمة الخارجية، وإجراء العمليات الحسابية، واتخاذ إجراءات في العالم الحقيقي.
تم تصميم الأدوات لتكون تخضع لسيطرة النموذج، مما يعني أن الأدوات يتم عرضها من الخوادم للعملاء بقصد أن يكون نموذج الذكاء الاصطناعي قادرًا على استدعائها تلقائيًا (مع وجود إنسان في الحلقة لمنح الموافقة).

نظرة عامة#

تسمح الأدوات في Model Context Protocol (MCP) للخوادم بعرض وظائف قابلة للتنفيذ يمكن استدعاؤها من قبل العملاء واستخدامها من قبل النماذج اللغوية الكبيرة (LLMs) لتنفيذ الإجراءات. تشمل الجوانب الرئيسية للأدوات ما يلي:
الاكتشاف: يمكن للعملاء إدراج الأدوات المتاحة من خلال نقطة النهاية tools/list
الاستدعاء: يتم استدعاء الأدوات باستخدام نقطة النهاية tools/call، حيث تقوم الخوادم بتنفيذ العملية المطلوبة وإرجاع النتائج
المرونة: يمكن أن تتراوح الأدوات من العمليات الحسابية البسيطة إلى تفاعلات واجهة برمجة التطبيقات (API) المعقدة
مثل الموارد، يتم تعريف الأدوات بأسماء فريدة ويمكن أن تتضمن أوصافًا لتوجيه استخدامها. ومع ذلك، على عكس الموارد، تمثل الأدوات عمليات ديناميكية يمكنها تعديل الحالة أو التفاعل مع الأنظمة الخارجية.

هيكل تعريف الأداة#

يتم تعريف كل أداة بالهيكل التالي:

تنفيذ الأدوات#

فيما يلي مثال على تنفيذ أداة أساسية في خادم Model Context Protocol (MCP):
TypeScript
Python

أمثلة على أنماط الأدوات#

فيما يلي بعض الأمثلة على أنواع الأدوات التي يمكن أن يوفرها الخادم:

عمليات النظام#

الأدوات التي تتفاعل مع النظام المحلي:

تكاملات واجهة برمجة التطبيقات (API)#

الأدوات التي تغلف واجهات برمجة التطبيقات (APIs) الخارجية:

معالجة البيانات#

الأدوات التي تحول أو تحلل البيانات:

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

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

اعتبارات الأمان#

عند عرض الأدوات:

التحقق من صحة الإدخال#

تحقق من صحة جميع المعلمات مقابل المخطط
قم بتطهير مسارات الملفات وأوامر النظام
تحقق من صحة عناوين URL والمعرفات الخارجية
تحقق من أحجام ونطاقات المعلمات
منع حقن الأوامر

التحكم في الوصول#

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

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

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

اكتشاف الأدوات والتحديثات#

يدعم Model Context Protocol (MCP) اكتشاف الأدوات الديناميكي:
1.
يمكن للعملاء إدراج الأدوات المتاحة في أي وقت
2.
يمكن للخوادم إخطار العملاء عند تغيير الأدوات باستخدام notifications/tools/list_changed
3.
يمكن إضافة الأدوات أو إزالتها أثناء وقت التشغيل
4.
يمكن تحديث تعريفات الأدوات (على الرغم من أن هذا يجب أن يتم بعناية)

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

يجب الإبلاغ عن أخطاء الأدوات داخل كائن النتيجة، وليس كأخطاء على مستوى بروتوكول Model Context Protocol (MCP). يسمح هذا للنموذج اللغوي الكبير (LLM) برؤية الخطأ والتعامل معه المحتمل. عندما تواجه أداة خطأ:
1.
اضبط isError على true في النتيجة
2.
قم بتضمين تفاصيل الخطأ في مصفوفة content
فيما يلي مثال على معالجة الأخطاء المناسبة للأدوات:
TypeScript
Python
يسمح هذا النهج للنموذج اللغوي الكبير (LLM) برؤية حدوث خطأ وربما اتخاذ إجراء تصحيحي أو طلب تدخل بشري.

اختبار الأدوات#

يجب أن تغطي استراتيجية اختبار شاملة لأدوات Model Context Protocol (MCP) ما يلي:
الاختبار الوظيفي: تحقق من أن الأدوات تعمل بشكل صحيح مع المدخلات الصالحة وتعالج المدخلات غير الصالحة بشكل مناسب
اختبار التكامل: اختبر تفاعل الأدوات مع الأنظمة الخارجية باستخدام التبعيات الحقيقية والمزيفة
اختبار الأمان: تحقق من صحة المصادقة والتفويض وتطهير الإدخال وتحديد المعدل
اختبار الأداء: تحقق من السلوك تحت الحمل ومعالجة المهلة وتنظيف الموارد
معالجة الأخطاء: تأكد من أن الأدوات تبلغ عن الأخطاء بشكل صحيح من خلال بروتوكول Model Context Protocol (MCP) وتنظيف الموارد
Modified at 2025-03-12 10:40:24
Previous
المطالبات
Next
أخذ العينات
Built with