إضافة أداة Hello
أضيفوا مُزخرفًا إلى دالة Python لكي يتمكن الذكاء الاصطناعي من استدعائها.
إضافة أداة Hello درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
امنح خادمك مهارة
الخادم الذي لا يحتوي على أدوات ليس سوى هيكل فارغ. أما الأداة فهي دالة Python يستطيع الذكاء الاصطناعي استدعاءها لتنفيذ شيء فعلي للمستخدم. 🛠️
المزخرف السحري
تُظهر FastMCP الدالة كأداة عبر سطر واحد: المزخرف @mcp.tool() الموضوع مباشرة فوق تعريف الدالة.
@mcp.tool()
def hello():
...اكتب دالة عادية
المتن عبارة عن Python فحسب. لا توجد شيفرة خاصة بالبروتوكول، ولا حاجة إلى كتابة JSON يدويًا. اكتب ما ينبغي للأداة تنفيذه وأعد قيمة.
@mcp.tool()
def hello():
return "Hello from MCP!"إضافة وسيط
تصبح الأدوات أكثر فائدة عند تزويدها بمدخلات. أضف وسيطًا، وسيتمكن النموذج من تمرير قيمة عندما يقرر استدعاء أداتك.
@mcp.tool()
def greet(name):
return "Hello, " + nameتلميحات الأنواع تنشئ المخطط
أضف تلميح نوع مثل name: str، وستحوّله FastMCP إلى مخطط للمدخلات. عندها يعرف النموذج بدقة نوع القيمة التي ينبغي إرسالها.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameيصبح نص التوثيق وصفًا
يصبح نص التوثيق الخاص بدالتك وصفًا للأداة. يقرأه النموذج ليقرر متى تكون هذه الأداة هي الأنسب للاستخدام.
@mcp.tool()
def greet(name: str) -> str:
"""Greet a person by name."""
return "Hello, " + nameيُشتق الاسم من الدالة
يكون اسم الأداة، افتراضيًا، هو اسم الدالة. لذلك تنشر def greet أداة يعرضها العميل باسم "greet".
إرجاع نص عادي
بالنسبة إلى الأداة الأولى، ما عليك سوى إرجاع سلسلة نصية. تُغلّف FastMCP هذه السلسلة في بنية نتيجة MCP الصحيحة، كي يتلقى العميل نصًا واضحًا.
اكتب وصفًا جيدًا
تُعدّ الصياغة الجيدة مهمة؛ إذ يساعد الوصف الواضح النموذج على اختيار أداتك في الوقت المناسب. أما نصوص التوثيق المبهمة فتؤدي إلى تفويت الاستدعاءات.
يُسجَّل تلقائيًا
لن تحتاج إلى استدعاء دالة تسجيل بنفسك. فبمجرد تزيين الدالة، تُصبح الأداة مسجَّلة في مثيل mcp وتكون جاهزة للإعلان عنها.
أضف العدد الذي تريده
يمكن لخادم واحد أن يحتوي على أدوات عديدة. زيّن كل دالة فحسب، وستظهر جميعها معًا عندما يسأل العميل عمّا هو متاح.
تحقق سريع
من أين يأتي وصف الأداة؟
مراجعة
لقد أضفت أداة باستخدام @mcp.tool()، ومنحتها وسائط محددة الأنواع، وتركت نص التوثيق يصفها. يستطيع خادمك أخيرًا تنفيذ شيء ما. والآن لنشغّله! ✨
الأسئلة الشائعة
هل درس «إضافة أداة Hello» مجاني؟
نعم — نص درس «إضافة أداة Hello» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «إضافة أداة Hello»؟
أضيفوا مُزخرفًا إلى دالة Python لكي يتمكن الذكاء الاصطناعي من استدعائها. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.
كم من الوقت يستغرق درس «إضافة أداة Hello»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.