التنفيذ العملي هو المكان الذي يصبح فيه تأثير بروتوكول سياق النموذج (MCP) ملموسًا. بينما يعد فهم النظرية والهندسة المعمارية وراء MCP أمرًا مهمًا، تظهر القيمة الحقيقية عند تطبيق هذه المفاهيم لبناء واختبار ونشر حلول تحل مشكلات العالم الحقيقي. هذا الفصل يجسر الفجوة بين المعرفة النظرية والتطوير العملي، ويرشدك خلال عملية تحويل تطبيقات MCP إلى واقع.
سواء كنت تطور مساعدين ذكيين، أو تدمج الذكاء الاصطناعي في سير عمل الأعمال، أو تبني أدوات مخصصة لمعالجة البيانات، يوفر MCP أساسًا مرنًا. تصميمه المستقل عن اللغة وSDKs الرسمية للغات البرمجة الشائعة يجعله متاحًا لشريحة واسعة من المطورين. من خلال الاستفادة من هذه SDKs، يمكنك بسرعة إنشاء نماذج أولية، والتكرار، وتوسيع حلولك عبر منصات وبيئات مختلفة.
في الأقسام التالية، ستجد أمثلة عملية، وأكواد نموذجية، واستراتيجيات نشر توضح كيفية تنفيذ MCP في C#، وJava، وTypeScript، وJavaScript، وPython. ستتعلم أيضًا كيفية تصحيح الأخطاء واختبار خوادم MCP، وإدارة واجهات برمجة التطبيقات، ونشر الحلول على السحابة باستخدام Azure. هذه الموارد العملية مصممة لتسريع تعلمك ومساعدتك على بناء تطبيقات MCP قوية وجاهزة للإنتاج بثقة.
يركز هذا الدرس على الجوانب العملية لتنفيذ MCP عبر عدة لغات برمجة. سنستعرض كيفية استخدام SDKs الخاصة بـ MCP في C#، وJava، وTypeScript، وJavaScript، وPython لبناء تطبيقات متينة، وتصحيح واختبار خوادم MCP، وإنشاء موارد وقوالب وأدوات قابلة لإعادة الاستخدام.
بنهاية هذا الدرس، ستكون قادرًا على:
- تنفيذ حلول MCP باستخدام SDKs الرسمية في لغات برمجة مختلفة
- تصحيح واختبار خوادم MCP بشكل منهجي
- إنشاء واستخدام ميزات الخادم (الموارد، والقوالب، والأدوات)
- تصميم سير عمل فعال لـ MCP للمهام المعقدة
- تحسين تنفيذ MCP من حيث الأداء والموثوقية
يوفر بروتوكول سياق النموذج SDKs رسمية لعدة لغات:
يقدم هذا القسم أمثلة عملية لتنفيذ MCP عبر عدة لغات برمجة. يمكنك العثور على أكواد نموذجية في دليل samples منظم حسب اللغة.
يحتوي المستودع على تنفيذات نموذجية باللغات التالية:
كل عينة توضح مفاهيم MCP الأساسية وأنماط التنفيذ الخاصة باللغة والنظام البيئي المعني.
يمكن لخوادم MCP تنفيذ أي مزيج من هذه الميزات:
توفر الموارد السياق والبيانات للمستخدم أو نموذج الذكاء الاصطناعي للاستخدام:
- مستودعات الوثائق
- قواعد المعرفة
- مصادر البيانات المهيكلة
- أنظمة الملفات
القوالب هي رسائل وسير عمل مصممة مسبقًا للمستخدمين:
- قوالب محادثة محددة مسبقًا
- أنماط تفاعل موجهة
- هياكل حوار متخصصة
الأدوات هي وظائف يمكن للنموذج الذكي تنفيذها:
- أدوات معالجة البيانات
- تكاملات واجهات برمجة التطبيقات الخارجية
- قدرات حسابية
- وظيفة البحث
يحتوي مستودع SDK الرسمي لـ C# على عدة تنفيذات نموذجية توضح جوانب مختلفة من MCP:
- عميل MCP بسيط: مثال بسيط يوضح كيفية إنشاء عميل MCP واستدعاء الأدوات
- خادم MCP بسيط: تنفيذ خادم بسيط مع تسجيل أدوات أساسي
- خادم MCP متقدم: خادم كامل الميزات مع تسجيل الأدوات، والمصادقة، ومعالجة الأخطاء
- تكامل ASP.NET: أمثلة توضح التكامل مع ASP.NET Core
- أنماط تنفيذ الأدوات: أنماط مختلفة لتنفيذ الأدوات بمستويات تعقيد متنوعة
SDK الخاص بـ MCP في C# في مرحلة المعاينة وقد تتغير واجهات برمجة التطبيقات. سنستمر في تحديث هذه المدونة مع تطور SDK.
للحصول على عينات تنفيذ كاملة لـ C#، قم بزيارة مستودع عينات SDK الرسمي لـ C#
يوفر SDK الخاص بـ Java خيارات تنفيذ MCP قوية مع ميزات بمستوى المؤسسات.
- تكامل مع Spring Framework
- أمان قوي للأنواع
- دعم البرمجة التفاعلية
- معالجة شاملة للأخطاء
لعينة تنفيذ Java كاملة، انظر عينة Java في دليل العينات.
يوفر SDK الخاص بـ JavaScript نهجًا خفيف الوزن ومرنًا لتنفيذ MCP.
- دعم Node.js والمتصفحات
- واجهة برمجة تطبيقات قائمة على الوعود
- تكامل سهل مع Express وأطر عمل أخرى
- دعم WebSocket للبث المباشر
لعينة تنفيذ JavaScript كاملة، انظر عينة JavaScript في دليل العينات.
يوفر SDK الخاص بـ Python نهجًا بيثونيًا لتنفيذ MCP مع تكامل ممتاز لأطر تعلم الآلة.
- دعم async/await مع asyncio
- تكامل مع Flask وFastAPI
- تسجيل أدوات بسيط
- تكامل أصلي مع مكتبات تعلم الآلة الشهيرة
لعينة تنفيذ Python كاملة، انظر عينة Python في دليل العينات.
تعد إدارة واجهات برمجة التطبيقات في Azure إجابة ممتازة على كيفية تأمين خوادم MCP. الفكرة هي وضع مثيل Azure API Management أمام خادم MCP الخاص بك وتركه يتولى ميزات قد تحتاجها مثل:
- تحديد معدلات الاستخدام
- إدارة الرموز
- المراقبة
- موازنة التحميل
- الأمان
إليك عينة Azure تقوم بذلك بالضبط، أي إنشاء خادم MCP وتأمينه باستخدام Azure API Management.
شاهد كيف تتم عملية التفويض في الصورة أدناه:
في الصورة السابقة، يحدث ما يلي:
- تتم عملية المصادقة/التفويض باستخدام Microsoft Entra.
- تعمل Azure API Management كبوابة وتستخدم السياسات لتوجيه وإدارة حركة المرور.
- يقوم Azure Monitor بتسجيل جميع الطلبات للتحليل المستقبلي.
لنلق نظرة أكثر تفصيلًا على تدفق التفويض:
تعرف أكثر على مواصفة تفويض MCP
لنرَ إن كان بإمكاننا نشر العينة التي ذكرناها سابقًا:
-
استنساخ المستودع
git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git cd remote-mcp-apim-functions-python -
سجل
Microsoft.Appresource provider.- If you are using Azure CLI, run
az provider register --namespace Microsoft.App --wait. - If you are using Azure PowerShell, run
Register-AzResourceProvider -ProviderNamespace Microsoft.App. Then run(Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationStateوبعد فترة تحقق مما إذا كانت التسجيل قد اكتمل.
- If you are using Azure CLI, run
-
شغّل هذا الأمر azd لتوفير خدمة إدارة API، وتطبيق الوظائف (مع الكود) وجميع موارد Azure المطلوبة الأخرى
azd up
يجب أن تنشر هذه الأوامر جميع الموارد السحابية على Azure
-
في نافذة طرفية جديدة، قم بتثبيت وتشغيل MCP Inspector
npx @modelcontextprotocol/inspector
يجب أن ترى واجهة مشابهة لـ:
-
اضغط CTRL وانقر لتحميل تطبيق MCP Inspector من العنوان الذي يعرضه التطبيق (مثل http://127.0.0.1:6274/#resources)
-
اضبط نوع النقل إلى
SSE -
Set the URL to your running API Management SSE endpoint displayed after
azd upواضغط Connect:https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse
-
عرض الأدوات. انقر على أداة واضغط Run Tool.
إذا نجحت كل الخطوات، يجب أن تكون متصلًا الآن بخادم MCP وتمكنت من استدعاء أداة.
Remote-mcp-functions: مجموعة من المستودعات هي قوالب بدء سريعة لبناء ونشر خوادم MCP مخصصة عن بُعد باستخدام Azure Functions مع Python، وC# .NET، أو Node/TypeScript.
توفر العينات حلاً كاملاً يسمح للمطورين بـ:
- البناء والتشغيل محليًا: تطوير وتصحيح خادم MCP على جهاز محلي
- النشر على Azure: نشر سهل إلى السحابة بأمر azd up بسيط
- الاتصال من العملاء: الاتصال بخادم MCP من عملاء مختلفين بما في ذلك وضع وكيل Copilot في VS Code وأداة MCP Inspector
- الأمان من التصميم: خادم MCP مؤمن باستخدام المفاتيح وHTTPS
- خيارات المصادقة: يدعم OAuth باستخدام المصادقة المدمجة و/أو إدارة API
- عزل الشبكة: يسمح بالعزل الشبكي باستخدام شبكات Azure الافتراضية (VNET)
- بنية بدون خادم: يستفيد من Azure Functions للتنفيذ القابل للتوسع والموجه بالأحداث
- تطوير محلي: دعم شامل للتطوير المحلي وتصحيح الأخطاء
- نشر بسيط: عملية نشر مبسطة إلى Azure
يحتوي المستودع على جميع ملفات التكوين اللازمة، والكود المصدري، وتعريفات البنية التحتية للبدء بسرعة بتنفيذ خادم MCP جاهز للإنتاج.
-
Azure Remote MCP Functions Python - تنفيذ نموذجي لـ MCP باستخدام Azure Functions مع Python
-
Azure Remote MCP Functions .NET - تنفيذ نموذجي لـ MCP باستخدام Azure Functions مع C# .NET
-
Azure Remote MCP Functions Node/Typescript - تنفيذ نموذجي لـ MCP باستخدام Azure Functions مع Node/TypeScript.
- توفر SDKs الخاصة بـ MCP أدوات مخصصة لكل لغة لتنفيذ حلول MCP متينة
- عملية تصحيح الأخطاء والاختبار ضرورية لتطبيقات MCP موثوقة
- قوالب القوالب القابلة لإعادة الاستخدام تمكّن تفاعلات ذكاء اصطناعي متسقة
- يمكن لسير العمل المصمم جيدًا تنسيق مهام معقدة باستخدام أدوات متعددة
- يتطلب تنفيذ حلول MCP مراعاة الأمان، والأداء، ومعالجة الأخطاء
صمم سير عمل MCP عملي يعالج مشكلة حقيقية في مجالك:
- حدد 3-4 أدوات ستكون مفيدة لحل هذه المشكلة
- أنشئ مخطط سير عمل يوضح كيفية تفاعل هذه الأدوات
- نفذ نسخة أساسية من إحدى الأدوات باستخدام لغتك المفضلة
- أنشئ قالبًا يساعد النموذج على استخدام أداتك بفعالية
التالي: مواضيع متقدمة
إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر المعتمد. للمعلومات الهامة، يُنصح بالترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.