MCP Academy · درس

اكتشاف الأدوات والموارد

اسردوا برمجيًا ما يقدمه الخادم.

الدرس 2 من 413 خطوة

اكتشاف الأدوات والموارد درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.

اسأل قبل أن تتصرف

ينبغي ألا يفترض العميل أبدًا ما يستطيع الخادم تنفيذه. بعد الاتصال، يكتشف القدرات المتاحة بطلب سردها من الخادم.

سرد الأدوات

استدعِ session.list_tools()، فيعيد الخادم كل أداة يتيحها، لتتمكن شيفرتك من فحصها.

result = await session.list_tools()

قراءة كل أداة

تحمل النتيجة قائمة tools. ويحتوي كل عنصر على اسم ووصف قابل للقراءة البشرية لكي تعرف وظيفته.

for tool in result.tools:
    print(tool.name, tool.description)

فحص بنية الإدخال

تعرض كل أداة أيضًا inputSchema، وهو JSON Schema يصف الوسيطات التي تقبلها. وهكذا تعرف ما يجب إرساله.

print(result.tools[0].inputSchema)

سرد الموارد

يمكن للخوادم تقديم بيانات للقراءة فقط أيضًا. استدعِ session.list_resources() لجلب مجموعة الموارد التي يمكنك قراءتها.

res = await session.list_resources()

للموارد معرّفات URI

يُحدَّد كل مورد بواسطة uri، مثل مسار ملف أو مخطط مخصص. وتستخدم ذلك uri لاحقًا لجلب محتواه.

for r in res.resources:
    print(r.uri, r.name)

سرد المطالبات

البدائية الثالثة هي المطالبات. يكشف session.list_prompts() عن قوالب تعليمات قابلة لإعادة الاستخدام ينشرها الخادم.

prompts = await session.list_prompts()

الاكتشاف مقيّد بالقدرات

لا تحصل إلا على ما أعلنه الخادم أثناء المصافحة. فإذا لم يعلن عن أي resources، فأعاد سردها مجموعة فارغة.

إنشاء قائمة حية

يعني الاكتشاف أن يتكيف العميل أثناء التشغيل. وصّل خادمًا جديدًا، فتظهر أدواته ببساطة دون الحاجة إلى تغيير شيفرة العميل.

تمريرها إلى نموذج

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

التخزين المؤقت أو إعادة السرد

قد تتغير قوائم الأدوات، لذلك يمكن للعميل المتأني أن يعيد السرد بعد إشعار بالتحديث بدلًا من الاعتماد على لقطة قديمة.

اختبار سريع

ما استدعاء الجلسة الذي يعيد قائمة أدوات الخادم مع مخططاتها؟

مراجعة: معرفة القائمة

تعلمت اكتشاف الخادم أثناء التشغيل: سرد أدواته وموارده ومطالباته، ثم قراءة كل اسم ووصف ومخطط قبل التصرف.

البدء مجانًا

تعلم Python مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات
30
الدروس
120

الأسئلة الشائعة

هل درس «اكتشاف الأدوات والموارد» مجاني؟

نعم — نص درس «اكتشاف الأدوات والموارد» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.

ماذا ستتعلم في «اكتشاف الأدوات والموارد»؟

اسردوا برمجيًا ما يقدمه الخادم. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟

لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «اكتشاف الأدوات والموارد»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟

نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. فتح جلسة عميل
  2. اكتشاف الأدوات والموارد
  3. استدعاء الأدوات من التعليمات البرمجية
  4. توجيه استدعاءات الأدوات عبر LLM
← العودة إلى MCP Academy