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

المطالبات

إنشاء قوالب ومسارات عمل قابلة لإعادة الاستخدام
تُمكّن الـ Prompts الخوادم من تحديد قوالب ومسارات عمل قابلة لإعادة الاستخدام، والتي يمكن للعملاء عرضها بسهولة للمستخدمين و LLMs. إنها توفر طريقة قوية لتوحيد ومشاركة تفاعلات LLM الشائعة.
تم تصميم الـ Prompts لتكون مُدارة من قبل المستخدم، مما يعني أنها معروضة من الخوادم إلى العملاء بهدف تمكين المستخدم من اختيارها بشكل صريح للاستخدام.

نظرة عامة#

الـ Prompts في MCP هي قوالب محددة مسبقًا يمكنها:
قبول وسائط ديناميكية
تضمين سياق من الموارد
ربط تفاعلات متعددة
توجيه مسارات عمل محددة
الظهور كعناصر واجهة مستخدم (مثل أوامر الشرطة المائلة)

هيكل الـ Prompt#

يتم تعريف كل Prompt بما يلي:

اكتشاف الـ Prompts#

يمكن للعملاء اكتشاف الـ Prompts المتاحة من خلال نقطة النهاية prompts/list:

استخدام الـ Prompts#

لاستخدام Prompt، يقوم العملاء بإجراء طلب prompts/get:

الـ Prompts الديناميكية#

يمكن أن تكون الـ Prompts ديناميكية وتتضمن:

سياق الموارد المضمنة#

{
  "name": "analyze-project",
  "description": "Analyze project logs and code",
  "arguments": [
    {
      "name": "timeframe",
      "description": "Time period to analyze logs",
      "required": true
    },
    {
      "name": "fileUri",
      "description": "URI of code file to review",
      "required": true
    }
  ]
}
عند معالجة طلب prompts/get:
{
  "messages": [
    {
      "role": "user",
      "content": {
        "type": "text",
        "text": "Analyze these system logs and the code file for any issues:"
      }
    },
    {
      "role": "user",
      "content": {
        "type": "resource",
        "resource": {
          "uri": "logs://recent?timeframe=1h",
          "text": "[2024-03-14 15:32:11] ERROR: Connection timeout in network.py:127\n[2024-03-14 15:32:15] WARN: Retrying connection (attempt 2/3)\n[2024-03-14 15:32:20] ERROR: Max retries exceeded",
          "mimeType": "text/plain"
        }
      }
    },
    {
      "role": "user",
      "content": {
        "type": "resource",
        "resource": {
          "uri": "file:///path/to/code.py",
          "text": "def connect_to_service(timeout=30):\n    retries = 3\n    for attempt in range(retries):\n        try:\n            return establish_connection(timeout)\n        except TimeoutError:\n            if attempt == retries - 1:\n                raise\n            time.sleep(5)\n\ndef establish_connection(timeout):\n    # Connection implementation\n    pass",
          "mimeType": "text/x-python"
        }
      }
    }
  ]
}

مسارات العمل متعددة الخطوات#

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

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

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

عند تنفيذ الـ Prompts:
1.
استخدم أسماء Prompt واضحة و وصفية
2.
قدم أوصافًا تفصيلية للـ Prompts والوسائط
3.
تحقق من صحة جميع الوسائط المطلوبة
4.
تعامل مع الوسائط المفقودة بأمان
5.
ضع في اعتبارك إدارة الإصدارات لقوالب الـ Prompt
6.
قم بتخزين المحتوى الديناميكي مؤقتًا عند الاقتضاء
7.
قم بتنفيذ معالجة الأخطاء
8.
وثق تنسيقات الوسائط المتوقعة
9.
ضع في اعتبارك قابلية تركيب الـ Prompt
10.
اختبر الـ Prompts بمدخلات متنوعة

تكامل واجهة المستخدم#

يمكن عرض الـ Prompts في واجهات مستخدم العميل على النحو التالي:
أوامر الشرطة المائلة
إجراءات سريعة
عناصر قائمة السياق
إدخالات لوحة الأوامر
مسارات عمل موجهة
نماذج تفاعلية

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

يمكن للخوادم إخطار العملاء بتغييرات الـ Prompt:
1.
قدرة الخادم: prompts.listChanged
2.
إشعار: notifications/prompts/list_changed
3.
يقوم العميل بإعادة جلب قائمة الـ Prompt

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

عند تنفيذ الـ Prompts:
تحقق من صحة جميع الوسائط
قم بتطهير مدخلات المستخدم
ضع في اعتبارك تحديد المعدل
قم بتنفيذ عناصر التحكم في الوصول
تدقيق استخدام الـ Prompt
تعامل مع البيانات الحساسة بشكل مناسب
تحقق من صحة المحتوى الذي تم إنشاؤه
قم بتنفيذ المهلات
ضع في اعتبارك مخاطر حقن الـ Prompt
وثق المتطلبات الأمنية
Modified at 2025-03-12 10:39:23
Previous
موارد
Next
أدوات
Built with