جعل استدعاءات أدوات MCP الطويلة تستجيب للإلغاء

الهدف

عند إلغاء المستخدم لعملية أداة معلقة، أوقف الخادم سريعاً أو أنهها بأمان.

الخطوات

1. حدّد مراحل الإدخال والإخراج أو الحساب الطويلة وعرّف الحالة الآمنة بعد الإلغاء. [mcp-cancel]
2. في معالج @mcp.tool() غير المتزامن ضع التنظيف في finally وأحط التنظيف المنتظر بـ anyio.move_on_after(5, shield=True). [mcp-cancel]
3. لأداة def عادية تعمل في خيط، استدعِ anyio.from_thread.check_cancelled() بين وحدات العمل؛ ويلغي العميل المهمة المنتظرة أو يترك مهلة القراءة تنتهي. [mcp-cancel]
4. لا تفعّل json_response=True لاتصالات Streamable HTTP الحديثة أو stateless_http=True للقديمة؛ فكلاهما يمنع وصول الإلغاء إلى المعالج. [mcp-cancel]
5. ألغِ مهمة اختبار بطيئة وتحقق من توقف المعالج وتحرير الموارد ووضع علامة الإلغاء على النتيجة. [mcp-cancel]

طريقة التحقق

بعد الإلغاء يعمل تنظيف async داخل `finally` ضمن حد الخمس ثواني، وتخرج أداة sync عند الفحص، وتسمح إعدادات HTTP بتمرير الإلغاء.

معالجة الأعطال

إذا تم تجاهل الإلغاء، فتحقق من تمرير رمز الإلغاء إلى عمليات الإدخال والإخراج اللاحقة.