اتبع هذه الخطوات للبدء باستخدام هذه الموارد:
- نسخ المستودع: انقر
- استنساخ المستودع:
git clone https://github.com/microsoft/mcp-for-beginners.git
- انضم إلى مجتمع Azure AI Foundry على Discord وتواصل مع الخبراء والمطورين الآخرين
🌐 دعم متعدد اللغات
مدعوم عبر GitHub Action (تلقائي ودائم التحديث)
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese
🚀 منهج بروتوكول سياق النموذج (MCP) للمبتدئين
تعلم MCP من خلال أمثلة عملية في C#، Java، JavaScript، Rust، Python، وTypeScript
🧠 نظرة عامة على منهج بروتوكول سياق النموذج
بروتوكول سياق النموذج (MCP) هو إطار عمل متطور يهدف إلى توحيد التفاعلات بين نماذج الذكاء الاصطناعي وتطبيقات العملاء. يقدم هذا المنهج المفتوح المصدر مسارًا تعليميًا منظمًا، يتضمن أمثلة عملية في البرمجة وحالات استخدام واقعية، عبر لغات البرمجة الشهيرة مثل C#، Java، JavaScript، TypeScript، وPython.
سواء كنت مطور ذكاء اصطناعي، مهندس أنظمة، أو مهندس برمجيات، فإن هذا الدليل هو مورد شامل لإتقان أساسيات MCP واستراتيجيات التنفيذ.
🔗 موارد MCP الرسمية
- 📘 وثائق MCP – دروس مفصلة وأدلة المستخدم
- 📜 مواصفات MCP – هيكل البروتوكول والمراجع التقنية
- 📜 المواصفات الأصلية لـ MCP – مراجع تقنية قديمة (قد تحتوي على تفاصيل إضافية)
- 🧑💻 مستودع GitHub لـ MCP – أدوات مفتوحة المصدر وعينات من الأكواد
- 🌐 مجتمع MCP – انضم إلى المناقشات وساهم في المجتمع
🧭 نظرة عامة على منهج MCP
📚 هيكل المنهج الكامل
الوحدة | الموضوع | الوصف | الرابط |
---|---|---|---|
الوحدات 1-3: الأساسيات | |||
00 | مقدمة عن MCP | نظرة عامة على بروتوكول سياق النموذج وأهميته في خطوط أنابيب الذكاء الاصطناعي | اقرأ المزيد |
01 | شرح المفاهيم الأساسية | استكشاف عميق للمفاهيم الأساسية لـ MCP | اقرأ المزيد |
02 | الأمان في MCP | التهديدات الأمنية وأفضل الممارسات | اقرأ المزيد |
03 | البدء مع MCP | إعداد البيئة، الخوادم/العملاء الأساسية، التكامل | اقرأ المزيد |
الوحدة 3: بناء أول خادم وعميل | |||
3.1 | أول خادم | إنشاء أول خادم MCP | الدليل |
3.2 | أول عميل | تطوير عميل MCP أساسي | الدليل |
3.3 | عميل مع LLM | دمج نماذج اللغة الكبيرة | الدليل |
3.4 | تكامل VS Code | استخدام خوادم MCP في VS Code | الدليل |
3.5 | خادم stdio | إنشاء خوادم باستخدام نقل stdio | الدليل |
3.6 | بث HTTP | تنفيذ بث HTTP في MCP | الدليل |
3.7 | أدوات الذكاء الاصطناعي | استخدام أدوات الذكاء الاصطناعي مع MCP | الدليل |
3.8 | الاختبار | اختبار تنفيذ خادم MCP الخاص بك | الدليل |
3.9 | النشر | نشر خوادم MCP للإنتاج | الدليل |
3.10 | استخدام الخادم المتقدم | استخدام الخوادم المتقدمة للميزات المتقدمة وتحسين الهيكل | الدليل |
3.11 | المصادقة البسيطة | فصل يوضح المصادقة من البداية وRBAC | الدليل |
الوحدات 4-5: العملية والمتقدمة | |||
04 | التنفيذ العملي | SDKs، التصحيح، الاختبار، قوالب التعليمات القابلة لإعادة الاستخدام | اقرأ المزيد |
05 | مواضيع متقدمة في MCP | الذكاء الاصطناعي متعدد الوسائط، التوسع، الاستخدام المؤسسي | اقرأ المزيد |
5.1 | تكامل Azure | تكامل MCP مع Azure | الدليل |
5.2 | تعدد الوسائط | العمل مع وسائط متعددة | الدليل |
5.3 | عرض OAuth2 | تنفيذ مصادقة OAuth2 | الدليل |
5.4 | السياقات الجذرية | فهم وتنفيذ السياقات الجذرية | الدليل |
5.5 | التوجيه | استراتيجيات التوجيه في MCP | الدليل |
5.6 | أخذ العينات | تقنيات أخذ العينات في MCP | الدليل |
5.7 | التوسع | توسيع تنفيذات MCP | الدليل |
5.8 | الأمان | اعتبارات الأمان المتقدمة | الدليل |
5.9 | البحث على الويب | تنفيذ قدرات البحث على الويب | الدليل |
5.10 | البث في الوقت الحقيقي | بناء وظيفة البث في الوقت الحقيقي | الدليل |
5.11 | البحث في الوقت الحقيقي | تنفيذ البحث في الوقت الحقيقي | الدليل |
5.12 | مصادقة Entra ID | المصادقة باستخدام Microsoft Entra ID | الدليل |
5.13 | تكامل Foundry | التكامل مع Azure AI Foundry | الدليل |
5.14 | هندسة السياق | تقنيات هندسة السياق الفعالة | الدليل |
5.15 | نقل MCP المخصص | تنفيذات النقل المخصصة | الدليل |
الوحدات 6-10: المجتمع وأفضل الممارسات | |||
06 | مساهمات المجتمع | كيفية المساهمة في نظام MCP البيئي | الدليل |
07 | رؤى من التبني المبكر | قصص تنفيذ واقعية | الدليل |
08 | أفضل الممارسات لـ MCP | الأداء، تحمل الأخطاء، المرونة | الدليل |
09 | دراسات حالة MCP | أمثلة تنفيذ عملية | الدليل |
10 | ورشة عمل عملية | بناء خادم MCP باستخدام أدوات الذكاء الاصطناعي | المختبر |
الوحدة 11: مختبر عملي لخادم MCP | |||
11 | تكامل قاعدة بيانات خادم MCP | مسار تعلم عملي شامل من 13 مختبرًا لتكامل PostgreSQL | المختبرات |
11.1 | المقدمة | نظرة عامة على MCP مع تكامل قاعدة البيانات وحالة استخدام تحليلات البيع بالتجزئة | مختبر 00 |
11.2 | البنية الأساسية | فهم بنية خادم MCP، طبقات قاعدة البيانات، وأنماط الأمان | المختبر 01 |
11.3 | الأمان وتعدد المستأجرين | أمان على مستوى الصفوف، المصادقة، والوصول إلى بيانات متعددة المستأجرين | المختبر 02 |
11.4 | إعداد البيئة | إعداد بيئة التطوير، Docker، موارد Azure | المختبر 03 |
11.5 | تصميم قاعدة البيانات | إعداد PostgreSQL، تصميم مخطط البيع بالتجزئة، والبيانات النموذجية | المختبر 04 |
11.6 | تنفيذ خادم MCP | بناء خادم FastMCP مع تكامل قاعدة البيانات | المختبر 05 |
11.7 | تطوير الأدوات | إنشاء أدوات استعلام قاعدة البيانات واستكشاف المخطط | المختبر 06 |
11.8 | البحث الدلالي | تنفيذ تضمينات المتجه باستخدام Azure OpenAI وpgvector | المختبر 07 |
11.9 | الاختبار وتصحيح الأخطاء | استراتيجيات الاختبار، أدوات تصحيح الأخطاء، ونهج التحقق | المختبر 08 |
11.10 | تكامل VS Code | إعداد تكامل MCP مع VS Code واستخدام الدردشة الذكية | المختبر 09 |
11.11 | استراتيجيات النشر | نشر باستخدام Docker، تطبيقات Azure Container، واعتبارات التوسع | المختبر 10 |
11.12 | المراقبة | Insights التطبيق، تسجيل الأحداث، ومراقبة الأداء | المختبر 11 |
11.13 | أفضل الممارسات | تحسين الأداء، تعزيز الأمان، ونصائح للإنتاج | المختبر 12 |
💻 مشاريع أمثلة على الكود
أمثلة أساسية لحاسبة MCP
اللغة | الوصف | الرابط |
---|---|---|
C# | مثال على خادم MCP | عرض الكود |
Java | حاسبة MCP | عرض الكود |
JavaScript | عرض MCP | عرض الكود |
Python | خادم MCP | عرض الكود |
TypeScript | مثال MCP | عرض الكود |
Rust | مثال MCP | عرض الكود |
تطبيقات MCP المتقدمة
اللغة | الوصف | الرابط |
---|---|---|
C# | مثال متقدم | عرض الكود |
Java مع Spring | مثال تطبيق الحاوية | عرض الكود |
JavaScript | مثال متقدم | عرض الكود |
Python | تنفيذ معقد | عرض الكود |
TypeScript | مثال الحاوية | عرض الكود |
🎯 المتطلبات الأساسية لتعلم MCP
للاستفادة القصوى من هذا المنهج، يجب أن تكون لديك:
معرفة أساسية بالبرمجة في واحدة على الأقل من اللغات التالية: C#، Java، JavaScript، Python، أو TypeScript
فهم لنموذج العميل-الخادم وواجهات برمجة التطبيقات (APIs)
إلمام بمفاهيم REST وHTTP
(اختياري) خلفية في مفاهيم الذكاء الاصطناعي/التعلم الآلي
الانضمام إلى مناقشات المجتمع للحصول على الدعم
📚 دليل الدراسة والموارد
يتضمن هذا المستودع العديد من الموارد لمساعدتك على التنقل والتعلم بشكل فعال:
دليل الدراسة
يتوفر دليل الدراسة الشامل لمساعدتك على التنقل في هذا المستودع بشكل فعال. يتضمن الدليل:
- خريطة منهجية مرئية تعرض جميع الموضوعات التي يتم تغطيتها
- تفصيل دقيق لكل قسم من أقسام المستودع
- إرشادات حول كيفية استخدام المشاريع النموذجية
- مسارات تعلم موصى بها لمستويات المهارة المختلفة
- موارد إضافية لتكملة رحلة التعلم الخاصة بك
سجل التغييرات
نحتفظ بسجل سجل التغييرات الذي يتتبع جميع التحديثات المهمة لمواد المنهج، بما في ذلك:
- إضافات المحتوى الجديدة
- تغييرات هيكلية
- تحسينات الميزات
- تحديثات الوثائق
🛠️ كيفية استخدام هذا المنهج بشكل فعال
يتضمن كل درس في هذا الدليل:
- تفسيرات واضحة لمفاهيم MCP
- أمثلة حية للكود بلغات متعددة
- تمارين لبناء تطبيقات MCP حقيقية
- موارد إضافية للمتعلمين المتقدمين
الفعاليات
أيام تطوير MCP يوليو 2025
➡️مشاهدة عند الطلب - أيام تطوير MCP
استعد ليومين من الرؤى التقنية العميقة، التواصل المجتمعي، والتعلم العملي في أيام تطوير MCP، وهو حدث افتراضي مخصص لبروتوكول سياق النموذج (MCP) — المعيار الناشئ الذي يربط بين نماذج الذكاء الاصطناعي والأدوات التي تعتمد عليها. يمكنك مشاهدة أيام تطوير MCP من خلال التسجيل في صفحة الحدث الخاصة بنا: https://aka.ms/mcpdevdays.
اليوم الأول: إنتاجية MCP، أدوات التطوير، والمجتمع:
يركز على تمكين المطورين من استخدام MCP في سير عملهم الاحترافي والاحتفال بمجتمع MCP الرائع. سنكون برفقة أعضاء المجتمع وشركاء مثل Arcade، Block، Okta، وNeon لرؤية كيف يتعاونون مع Microsoft لتشكيل نظام MCP مفتوح وقابل للتوسيع.
عروض حية عبر VS Code، Visual Studio، GitHub Copilot، وأدوات المجتمع الشهيرة
تدفقات عمل عملية مدفوعة بالسياق
جلسات ورؤى يقودها المجتمع
سواء كنت قد بدأت للتو مع MCP أو كنت بالفعل تبني باستخدامه، فإن اليوم الأول سيضع الأساس للإلهام والنصائح العملية.
اليوم الثاني: بناء خوادم MCP بثقة
مخصص لبناة MCP. سنغوص في استراتيجيات التنفيذ وأفضل الممارسات لإنشاء خوادم MCP ودمج MCP في سير عمل الذكاء الاصطناعي الخاص بك.
الموضوعات تشمل:
- بناء خوادم MCP ودمجها في تجارب الوكلاء
- تطوير مدفوع بالمطالبات
- أفضل ممارسات الأمان
- استخدام اللبنات الأساسية مثل Functions، ACA، وإدارة واجهات برمجة التطبيقات
- محاذاة السجل والأدوات (1P + 3P)
إذا كنت مطورًا، أو منشئ أدوات، أو استراتيجي منتجات الذكاء الاصطناعي، فإن هذا اليوم مليء بالرؤى التي تحتاجها لبناء حلول MCP قابلة للتوسع، آمنة، وجاهزة للمستقبل.
معسكر MCP التدريبي أغسطس 2025
تعلم من خلال جلسات فيديو مكثفة كيفية إنشاء خوادم MCP، التكامل مع VS Code، والنشر بشكل احترافي على Azure بناءً على محتوى منهج MCP للمبتدئين. احصل على مهارات عملية في تقنية تستخدمها بالفعل شركات كبرى.
➡️مشاهدة عند الطلب معسكر MCP التدريبي | الإنجليزية
➡️مشاهدة عند الطلب معسكر MCP التدريبي | البرازيل
➡️مشاهدة عند الطلب معسكر MCP التدريبي | الإسبانية
لنتعلم MCP مع C# - سلسلة تعليمية
لنتعلم عن بروتوكول سياق النموذج (MCP)، وهو إطار عمل متقدم مصمم لتوحيد التفاعلات بين نماذج الذكاء الاصطناعي وتطبيقات العميل. من خلال هذه الجلسة المناسبة للمبتدئين، سنقدم لك MCP ونرشدك لإنشاء أول خادم MCP خاص بك.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 شكرًا للمجتمع
شكرًا لـ Microsoft Valued Professional Shivam Goyal على مساهمته في نماذج الكود المهمة.
📜 معلومات الترخيص
هذا المحتوى مرخص بموجب رخصة MIT. للحصول على الشروط والأحكام، راجع LICENSE.
🤝 إرشادات المساهمة
يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أنك لديك الحق في، وتقوم فعليًا، بمنحنا الحقوق لاستخدام مساهمتك. للحصول على التفاصيل، قم بزيارة https://cla.opensource.microsoft.com.
عندما تقدم طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA ويزين طلب السحب بشكل مناسب (مثل فحص الحالة، التعليق). ما عليك سوى اتباع التعليمات المقدمة من الروبوت. ستحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع المستودعات التي تستخدم CLA الخاص بنا.
لقد اعتمد هذا المشروع مدونة قواعد السلوك المفتوحة المصدر من Microsoft.
لمزيد من المعلومات، راجع الأسئلة الشائعة حول مدونة قواعد السلوك أو
تواصل مع opencode@microsoft.com لأي أسئلة أو تعليقات إضافية.
📂 هيكل المستودع
تم تنظيم المستودع على النحو التالي:
- المنهج الأساسي (00-11): المحتوى الرئيسي منظم في أحد عشر وحدة متسلسلة، بما في ذلك مختبرات تكامل قاعدة البيانات الشاملة
- 11-MCPServerHandsOnLabs/: مسار تعلم مكون من 13 مختبرًا لبناء خوادم MCP جاهزة للإنتاج مع تكامل PostgreSQL
- images/: الرسوم البيانية والرسوم التوضيحية المستخدمة في جميع أنحاء المنهج
- translations/: دعم متعدد اللغات مع ترجمات آلية
- translated_images/: نسخ محلية من الرسوم البيانية والرسوم التوضيحية
- study_guide.md: دليل شامل للتنقل في المستودع
- changelog.md: سجل لجميع التغييرات المهمة في مواد المنهج
- mcp.json: ملف تكوين لمواصفات MCP
- CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: وثائق إدارة المشروع
🎒 دورات أخرى
فريقنا ينتج دورات أخرى! تحقق من:
- جديد الذكاء الاصطناعي الطرفي للمبتدئين
- وكلاء الذكاء الاصطناعي للمبتدئين
- الذكاء الاصطناعي التوليدي للمبتدئين باستخدام .NET
- الذكاء الاصطناعي التوليدي للمبتدئين باستخدام JavaScript
- الذكاء الاصطناعي التوليدي للمبتدئين
- الذكاء الاصطناعي التوليدي للمبتدئين باستخدام Java
- التعلم الآلي للمبتدئين
- علم البيانات للمبتدئين
- الذكاء الاصطناعي للمبتدئين
- الأمن السيبراني للمبتدئين
- تطوير الويب للمبتدئين
- إنترنت الأشياء للمبتدئين
- تطوير XR للمبتدئين
- إتقان GitHub Copilot للبرمجة المزدوجة بالذكاء الاصطناعي
- إتقان GitHub Copilot لمطوري C#/.NET
- اختر مغامرتك الخاصة مع Copilot
™️ إشعار العلامة التجارية
قد يحتوي هذا المشروع على علامات تجارية أو شعارات لمشاريع أو منتجات أو خدمات. يجب أن يكون استخدام العلامات التجارية أو الشعارات الخاصة بـ Microsoft مصرحًا به ويتبع
إرشادات العلامة التجارية لـ Microsoft.
يجب ألا يتسبب استخدام العلامات التجارية أو الشعارات الخاصة بـ Microsoft في نسخ معدلة من هذا المشروع في حدوث لبس أو الإيحاء برعاية Microsoft.
أي استخدام للعلامات التجارية أو الشعارات الخاصة بأطراف ثالثة يخضع لسياسات تلك الأطراف.
الحصول على المساعدة
إذا واجهت صعوبة أو كانت لديك أسئلة حول بناء تطبيقات الذكاء الاصطناعي، انضم إلى:
إذا كانت لديك ملاحظات حول المنتج أو أخطاء أثناء البناء، قم بزيارة:
إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية هو المصدر الموثوق. للحصول على معلومات حساسة أو هامة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة.