الوصول إلى كائن السياق
الوصول إلى سياق الطلب داخل أداة.
الوصول إلى كائن السياق درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
تعرّفوا على كائن Context
يمثل كائن Context بوابة أداتكم إلى الطلب؛ إذ يحمل الحالة المشتركة، بالإضافة إلى أدوات المساعدة للتسجيل وإظهار التقدم.
اطلبوه حسب النوع
أضيفوا وسيطًا محدد النوع على أنه Context، وسيحقنه FastMCP تلقائيًا. ولا يرى العملاء هذا الوسيط مطلقًا.
from mcp.server.fastmcp import Context
@mcp.tool()
async def greet(name: str, ctx: Context) -> str:
return "hi " + nameالوصول إلى حالتكم المشتركة
تعمقوا في ctx.request_context.lifespan_context للحصول على الكائن نفسه الذي أعاده lifespan عند بدء التشغيل.
app = ctx.request_context.lifespan_context
rows = await app.db.query("...")استخدموا الاتصال النشط
تعمل أدواتكم الآن باستخدام مجموعة الاتصالات المشتركة بدلًا من فتح اتصال جديد تمامًا عند كل استدعاء.
سجّلوا عبر السياق
استدعوا ctx.info لإرسال سطر سجل إلى العميل، فهذا أكثر فائدة بكثير من استخدام print مخفي على الخادم.
await ctx.info("loading user " + str(user_id))أبلغوا عن التقدم أيضًا
بالنسبة إلى العمل البطيء، يبث ctx.report_progress تحديثات للنسبة المئوية المنجزة، لكي يتمكن المضيف من عرض شريط تقدم للمستخدم.
await ctx.report_progress(progress=3, total=10)إنه محقون، وليس مُمررًا
لا يملأ النموذج ctx مطلقًا. يتعرف FastMCP على تلميح النوع ويوفره، ولذلك يبقى خارج مخطط أداتكم.
الأدوات غير المتزامنة تحب السياق
معظم أدوات المساعدة في السياق قابلة للانتظار، لذا عرّفوا الأدوات التي تستخدم السياق على أنها دوال غير متزامنة لاستدعائها بسهولة.
سمّوه ما تشاؤون
يعود اسم الوسيط إليكم؛ فما يهم هو تلميح النوع. وغالبًا ما يسميه المطورون ctx وفقًا للعرف.
سياق واحد لكل طلب
يحصل كل استدعاء لأداة على سياق طلب خاص به، لكنها جميعًا تشير إلى حالة lifespan نفسها طويلة الأمد في الخلفية.
اقرؤوا البيانات الوصفية للطلب
يتيح السياق أيضًا البيانات الوصفية للطلب، لكي تتمكن الأداة من فحص تفاصيل الاستدعاء المحدد الذي تعالجه.
تحقق سريع
كيف تحصلون على كائن Context داخل أداة FastMCP؟
مراجعة: كائن Context
تصلون إلى الحالة المشتركة عبر ctx.request_context.lifespan_context، وتستخدمون ctx للتسجيل وإظهار التقدم. التالي: الإيقاف بطريقة سليمة. 🔌
الأسئلة الشائعة
هل درس «الوصول إلى كائن السياق» مجاني؟
نعم — نص درس «الوصول إلى كائن السياق» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «الوصول إلى كائن السياق»؟
الوصول إلى سياق الطلب داخل أداة. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «الوصول إلى كائن السياق»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- خطاف بدء التشغيل لدورة الحياة
- مشاركة الحالة عبر سياق التطبيق
- الوصول إلى كائن السياق
- الإيقاف النظيف وتحرير الموارد