(اضغط على الصورة أعلاه لمشاهدة فيديو هذا الدرس)
التنفيذ العملي هو المكان الذي تصبح فيه قوة بروتوكول Model Context Protocol (MCP) ملموسة. بينما يُعد فهم النظرية والهندسة المعمارية وراء MCP أمرًا مهمًا، فإن القيمة الحقيقية تظهر عند تطبيق هذه المفاهيم لبناء واختبار ونشر حلول تحل مشكلات العالم الحقيقي. يهدف هذا الفصل إلى سد الفجوة بين المعرفة النظرية والتطوير العملي، حيث يرشدك خلال عملية تحويل تطبيقات MCP إلى واقع.
سواء كنت تطور مساعدين أذكياء، أو تدمج الذكاء الاصطناعي في سير العمل التجاري، أو تبني أدوات مخصصة لمعالجة البيانات، فإن MCP يوفر أساسًا مرنًا. تصميمه المحايد للغة ووجود SDKs رسمية للغات البرمجة الشهيرة يجعله متاحًا لمجموعة واسعة من المطورين. من خلال الاستفادة من هذه SDKs، يمكنك بسرعة إنشاء نماذج أولية، وتكرارها، وتوسيع نطاق حلولك عبر منصات وبيئات مختلفة.
في الأقسام التالية، ستجد أمثلة عملية، وأكواد نموذجية، واستراتيجيات نشر توضح كيفية تنفيذ MCP باستخدام C#، Java مع Spring، TypeScript، JavaScript، وPython. ستتعلم أيضًا كيفية تصحيح أخطاء خوادم MCP واختبارها، وإدارة واجهات برمجة التطبيقات (APIs)، ونشر الحلول إلى السحابة باستخدام Azure. تم تصميم هذه الموارد العملية لتسريع تعلمك ومساعدتك على بناء تطبيقات MCP قوية وجاهزة للإنتاج بثقة.
يركز هذا الدرس على الجوانب العملية لتنفيذ MCP عبر لغات برمجة متعددة. سنستكشف كيفية استخدام SDKs الخاصة بـ MCP في C#، Java مع Spring، TypeScript، JavaScript، وPython لبناء تطبيقات قوية، وتصحيح أخطاء خوادم MCP واختبارها، وإنشاء موارد وقوالب وأدوات قابلة لإعادة الاستخدام.
بنهاية هذا الدرس، ستكون قادرًا على:
- تنفيذ حلول MCP باستخدام SDKs الرسمية في لغات برمجة متنوعة
- تصحيح أخطاء خوادم MCP واختبارها بشكل منهجي
- إنشاء واستخدام ميزات الخادم (الموارد، القوالب، والأدوات)
- تصميم سير عمل MCP فعال للمهام المعقدة
- تحسين تنفيذ MCP من حيث الأداء والموثوقية
يوفر بروتوكول Model Context Protocol SDKs رسمية لعدة لغات:
- C# SDK
- Java مع Spring SDK ملاحظة: يتطلب الاعتماد على Project Reactor. (راجع مناقشة القضية 246.)
- TypeScript SDK
- Python SDK
- Kotlin SDK
يوفر هذا القسم أمثلة عملية لتنفيذ MCP عبر لغات برمجة متعددة. يمكنك العثور على أكواد نموذجية في دليل samples المنظم حسب اللغة.
يتضمن المستودع تنفيذات نموذجية باللغات التالية:
كل عينة توضح مفاهيم MCP الرئيسية وأنماط التنفيذ الخاصة بتلك اللغة والنظام البيئي.
يمكن لخوادم MCP تنفيذ أي مجموعة من هذه الميزات:
توفر الموارد سياقًا وبيانات للمستخدم أو نموذج الذكاء الاصطناعي لاستخدامها:
- مستودعات الوثائق
- قواعد المعرفة
- مصادر البيانات المنظمة
- أنظمة الملفات
القوالب هي رسائل وأنماط عمل موجهة للمستخدمين:
- قوالب محادثة محددة مسبقًا
- أنماط تفاعل موجهة
- هياكل حوار متخصصة
الأدوات هي وظائف ينفذها نموذج الذكاء الاصطناعي:
- أدوات معالجة البيانات
- تكاملات API الخارجية
- قدرات حسابية
- وظائف البحث
يتضمن مستودع SDK الرسمي لـ C# عدة تنفيذات نموذجية توضح جوانب مختلفة من MCP:
- عميل MCP الأساسي: مثال بسيط يوضح كيفية إنشاء عميل MCP واستدعاء الأدوات
- خادم MCP الأساسي: تنفيذ خادم بسيط مع تسجيل أدوات أساسي
- خادم MCP المتقدم: خادم متكامل الميزات مع تسجيل الأدوات، والمصادقة، ومعالجة الأخطاء
- تكامل ASP.NET: أمثلة توضح التكامل مع ASP.NET Core
- أنماط تنفيذ الأدوات: أنماط مختلفة لتنفيذ الأدوات بمستويات تعقيد مختلفة
SDK الخاص بـ MCP في C# في مرحلة المعاينة وقد تتغير واجهات برمجة التطبيقات. سنقوم بتحديث هذه المدونة باستمرار مع تطور SDK.
للحصول على عينات تنفيذ كاملة لـ C#، قم بزيارة مستودع العينات الرسمي لـ C# SDK
يوفر SDK الخاص بـ Java مع Spring خيارات تنفيذ MCP قوية مع ميزات على مستوى المؤسسات.
- تكامل مع إطار عمل Spring
- أمان قوي للأنواع
- دعم البرمجة التفاعلية
- معالجة شاملة للأخطاء
للحصول على عينة تنفيذ كاملة لـ Java مع Spring، راجع عينة Java مع Spring في دليل العينات.
يوفر SDK الخاص بـ JavaScript نهجًا خفيف الوزن ومرنًا لتنفيذ MCP.
- دعم Node.js والمتصفح
- واجهة برمجة تعتمد على الوعود (Promise-based API)
- تكامل سهل مع Express وأطر عمل أخرى
- دعم WebSocket للبث
للحصول على عينة تنفيذ كاملة لـ JavaScript، راجع عينة JavaScript في دليل العينات.
يوفر SDK الخاص بـ Python نهجًا Pythonic لتنفيذ MCP مع تكامل ممتاز مع أطر عمل التعلم الآلي.
- دعم Async/await مع asyncio
- تكامل مع FastAPI
- تسجيل أدوات بسيط
- تكامل أصلي مع مكتبات التعلم الآلي الشهيرة
للحصول على عينة تنفيذ كاملة لـ Python، راجع عينة Python في دليل العينات.
تُعد إدارة واجهات برمجة التطبيقات في Azure حلاً رائعًا لتأمين خوادم MCP. الفكرة هي وضع مثيل إدارة واجهات برمجة التطبيقات في Azure أمام خادم MCP الخاص بك وتركه يتولى الميزات التي قد تحتاجها مثل:
- تحديد معدل الطلبات
- إدارة الرموز (Tokens)
- المراقبة
- موازنة الأحمال
- الأمان
إليك عينة من Azure تقوم بذلك بالضبط، أي إنشاء خادم MCP وتأمينه باستخدام إدارة واجهات برمجة التطبيقات في Azure.
-
في نافذة طرفية جديدة، قم بتثبيت وتشغيل MCP Inspector
npx @modelcontextprotocol/inspector
يجب أن ترى واجهة مشابهة لـ:
-
اضغط على الرابط لتحميل تطبيق الويب MCP Inspector من عنوان URL الذي يعرضه التطبيق (مثل http://127.0.0.1:6274/#resources)
-
قم بتعيين نوع النقل إلى
SSE -
قم بتعيين عنوان URL إلى نقطة نهاية SSE الخاصة بإدارة واجهات برمجة التطبيقات التي تم عرضها بعد
azd upواضغط على اتصال:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
قائمة الأدوات. اضغط على أداة واختر تشغيل الأداة.
إذا نجحت جميع الخطوات، يجب أن تكون الآن متصلاً بخادم MCP وتمكنت من استدعاء أداة.
Remote-mcp-functions: توفر هذه المجموعة من المستودعات قوالب بدء سريعة لبناء ونشر خوادم MCP مخصصة باستخدام Azure Functions مع Python، C# .NET أو Node/TypeScript.
- الأمان حسب التصميم: يتم تأمين خادم MCP باستخدام المفاتيح وHTTPS
- خيارات المصادقة: يدعم OAuth باستخدام المصادقة المدمجة و/أو إدارة واجهات برمجة التطبيقات
- العزل الشبكي: يسمح بالعزل الشبكي باستخدام شبكات Azure الافتراضية (VNET)
- بنية بدون خادم: تعتمد على Azure Functions للتنفيذ القابل للتوسع والموجه بالأحداث
- التطوير المحلي: دعم شامل للتطوير المحلي وتصحيح الأخطاء
- عملية نشر بسيطة: عملية نشر مبسطة إلى Azure
- توفر SDKs الخاصة بـ MCP أدوات خاصة بكل لغة لتنفيذ حلول MCP قوية
- عملية تصحيح الأخطاء والاختبار ضرورية لتطبيقات MCP الموثوقة
- قوالب القوالب القابلة لإعادة الاستخدام تمكن من تفاعلات AI متسقة
- يمكن لسير العمل المصمم جيدًا تنظيم المهام المعقدة باستخدام أدوات متعددة
- يتطلب تنفيذ حلول MCP مراعاة الأمان، الأداء، ومعالجة الأخطاء
صمم سير عمل MCP عملي يعالج مشكلة واقعية في مجالك:
- حدد 3-4 أدوات ستكون مفيدة لحل هذه المشكلة
- أنشئ مخطط سير عمل يوضح كيفية تفاعل هذه الأدوات
- نفذ نسخة أساسية من إحدى الأدوات باستخدام لغتك المفضلة
- أنشئ قالبًا يساعد النموذج على استخدام أداتك بفعالية
التالي: المواضيع المتقدمة
إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية هو المصدر الموثوق. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.