التأكد من تحميل الأدوات وسردها

يعمل خادمك، لكن كيف تعرف أنه سليم؟ لنتحقق من أنه يُحمَّل ومن أن أداتك تظهر حيث يستطيع العملاء رؤيتها. 🔍

تأتي حزمة SDK بمساعد لهذا الغرض. يؤدي تشغيل mcp dev على ملفك إلى بدء الخادم مع إرفاق أداة فحص مرئية.

يفتح ذلك MCP Inspector في متصفحك: لوحة سهلة الاستخدام لاختبار خادمك دون كتابة أي شيفرة للعميل.

في Inspector، انقر على Connect. فهذا ينفّذ عملية المصافحة؛ وإذا نجحت، فهذا يعني أن خادمك قد حُمّل ويتحدث بروتوكول MCP بطريقة صحيحة.

انتقل الآن إلى تبويب Tools. فهذا يستدعي عملية سرد الأدوات في البروتوكول ويعرض كل أداة يعلن عنها خادمك.

ينبغي أن تجد دالتك هناك حسب اسمها، مثل "hello" أو "greet"، إلى جانب الوصف المأخوذ من نص توثيقها.

انقر على الأداة، وسيعرض Inspector مخططها، أي الوسائط المحددة الأنواع التي أنشأتها FastMCP من تلميحاتك. وهذا ما يقرأه النموذج.

أدخل أي وسائط ثم انقر على run. يستدعي Inspector أداتك ويعرض النتيجة الدقيقة التي سيتلقاها النموذج.

إذا كانت قائمة Tools فارغة، فمن المحتمل أن المزخرف لم يُنفَّذ. تأكد من أن @mcp.tool() موجود مباشرة فوق الدالة.

ذلك التبويب ليس سوى واجهة مستخدم فوق رسالة حقيقية: يرسل العميل طلب tools/list، ويرد خادمك بالفهرس.

لا يقتصر Inspector على الأدوات. فهو يحتوي أيضًا على تبويبات لـالموارد والمطالبات، حتى تتمكن من التحقق من كل إمكانات خادمك.

ماذا يفعل تبويب Tools في Inspector خلف الكواليس؟

لقد شغّلت mcp dev، واتصلت عبر Inspector، ورأيت أداتك مدرجة، بل واستدعيتها مباشرة. أصبح خادمك الأول حقيقيًا وتم التحقق منه. أحسنت! 🎉