Skip to content

Latest commit

 

History

History
258 lines (187 loc) · 24 KB

File metadata and controls

258 lines (187 loc) · 24 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

اتبع هذه الخطوات للبدء باستخدام هذه الموارد:

  1. افتح نسخة من المستودع (Fork): اضغط على GitHub forks
  2. انسخ المستودع (Clone): git clone https://github.com/microsoft/mcp-for-beginners.git
  3. انضم إلى Azure AI Foundry Discord وتواصل مع الخبراء والمطورين الآخرين

🌐 دعم متعدد اللغات

مدعوم عبر GitHub Action (آلي ومحدث دائماً)

الفرنسية | الإسبانية | الألمانية | الروسية | العربية | الفارسية (اللغة الفارسية) | الأردية | الصينية (المبسطة) | الصينية (التقليدية، ماكاو) | الصينية (التقليدية، هونغ كونغ) | الصينية (التقليدية، تايوان) | اليابانية | الكورية | الهندية | البنغالية | الماراثية | النيبالية | البنجابية (غورموخي) | البرتغالية (البرتغال) | البرتغالية (البرازيل) | الإيطالية | البولندية | التركية | اليونانية | التايلاندية | السويدية | الدنماركية | النرويجية | الفنلندية | الهولندية | العبرية | الفيتنامية | الإندونيسية | الماليزية | التاغالوغ (الفلبينية) | السواحلية | الهنغارية | التشيكية | السلوفاكية | الرومانية | البلغارية | الصربية (السيريلية) | الكرواتية | السلوفينية | الأوكرانية | البورمية (ميانمار)

🚀 منهج بروتوكول سياق النموذج (MCP) للمبتدئين

تعلم MCP من خلال أمثلة عملية بالبرمجة باستخدام C#، Java، JavaScript، Python، وTypeScript

🧠 نظرة عامة على منهج بروتوكول سياق النموذج

بروتوكول سياق النموذج (MCP) هو إطار عمل متطور يهدف إلى توحيد التفاعل بين نماذج الذكاء الاصطناعي وتطبيقات العملاء. يقدم هذا المنهج مفتوح المصدر مسار تعلم منظم، مع أمثلة برمجية عملية وحالات استخدام واقعية، عبر لغات برمجة شائعة مثل C#، Java، JavaScript، TypeScript، وPython.

سواء كنت مطور ذكاء اصطناعي، مهندس نظم، أو مهندس برمجيات، فإن هذا الدليل هو مصدرك الشامل لإتقان أساسيات MCP واستراتيجيات تنفيذه.

🔗 الموارد الرسمية لـ MCP

انضم إلينا في MCP Dev Days في 29-30 يوليو 2025

استعد ليومين من الغوص العميق في الجوانب التقنية، التواصل المجتمعي، والتعلم العملي في MCP Dev Days، وهو حدث افتراضي مخصص لبروتوكول سياق النموذج (MCP) — المعيار الناشئ الذي يربط بين نماذج الذكاء الاصطناعي والأدوات التي تعتمد عليها.

➡️ سجل في MCP Dev Days

يمكنك مشاهدة MCP Dev Days بالتسجيل في صفحة الحدث: https://aka.ms/mcpdevdays. من هناك، ستتمكن من الانضمام إلى البث المباشر على YouTube أو Twitch. جميع المحتويات مسجلة وستكون متاحة لاحقًا على قناة Microsoft Developer على YouTube. كما سيكون كود العروض التوضيحية متاحًا على GitHub.

تفاصيل الحدث

  • التواريخ: 29 يوليو (اليوم الأول) و30 يوليو (اليوم الثاني)
  • الوقت: 9:00 صباحًا بتوقيت PST يوميًا
  • المكان: عبر الإنترنت – انضم من أي مكان!

اليوم الأول: إنتاجية MCP، أدوات التطوير، والمجتمع:

يركز على تمكين المطورين من استخدام MCP في سير عملهم والاحتفال بمجتمع MCP الرائع. سينضم إلينا أعضاء المجتمع وشركاء مثل Arcade، Block، Okta، وNeon لنرى كيف يتعاونون مع Microsoft لتشكيل نظام MCP مفتوح وقابل للتوسع. عروض حية عبر VS Code، Visual Studio، GitHub Copilot، وأدوات المجتمع الشهيرة
سير عمل تطوير عملي قائم على السياق
جلسات يقودها المجتمع ورؤى ملهمة
سواء كنت تبدأ للتو مع MCP أو تبني به بالفعل، سيضع اليوم الأول الأساس بالإلهام والنصائح العملية.

اليوم الثاني: بناء خوادم MCP بثقة

مخصص لبناة MCP. سنتعمق في استراتيجيات التنفيذ وأفضل الممارسات لإنشاء خوادم MCP ودمج MCP في سير عمل الذكاء الاصطناعي الخاص بك.

المواضيع تشمل:

  • بناء خوادم MCP ودمجها في تجارب الوكلاء
  • تطوير قائم على المحفزات (Prompt-driven development)
  • أفضل ممارسات الأمان
  • استخدام اللبنات الأساسية مثل Functions، ACA، وAPI Management
  • التوافق مع السجلات والأدوات (1P + 3P)

إذا كنت مطورًا، منشئ أدوات، أو استراتيجي منتجات ذكاء اصطناعي، فإن هذا اليوم مليء بالرؤى التي تحتاجها لبناء حلول 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 خادم SSE إنشاء خوادم باستخدام Server-Sent Events الدليل
3.6 البث عبر HTTP تنفيذ البث عبر HTTP في MCP الدليل
3.7 مجموعة أدوات الذكاء الاصطناعي استخدام AI Toolkit مع MCP الدليل
3.8 الاختبار اختبار تنفيذ خادم MCP الخاص بك الدليل
3.9 النشر نشر خوادم MCP في بيئة الإنتاج الدليل
الوحدات 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 هندسة السياق تقنيات هندسة السياق الفعالة الدليل
الوحدة 6-10: المجتمع وأفضل الممارسات
06 مساهمات المجتمع كيفية المساهمة في نظام MCP البيئي الدليل
07 رؤى من التبني المبكر قصص تطبيقات من الواقع الدليل
08 أفضل الممارسات لـ MCP الأداء، تحمل الأخطاء، والمرونة الدليل
09 دراسات حالة MCP أمثلة تطبيقية عملية الدليل
10 ورشة عمل تطبيقية بناء خادم MCP باستخدام مجموعة أدوات الذكاء الاصطناعي المختبر

💻 مشاريع تعليمية نموذجية

عينات حاسبة MCP الأساسية

اللغة الوصف الرابط
C# مثال خادم MCP عرض الكود
Java حاسبة MCP عرض الكود
JavaScript عرض توضيحي لـ MCP عرض الكود
Python خادم MCP عرض الكود
TypeScript مثال MCP عرض الكود

تطبيقات MCP المتقدمة

اللغة الوصف الرابط
C# عينة متقدمة عرض الكود
Java مثال تطبيق الحاوية عرض الكود
JavaScript عينة متقدمة عرض الكود
Python تطبيق معقد عرض الكود
TypeScript عينة الحاوية عرض الكود

🎯 المتطلبات الأساسية لتعلم MCP

للاستفادة القصوى من هذا المنهج، يجب أن تمتلك:

  • معرفة أساسية بالبرمجة في واحدة على الأقل من اللغات التالية: C#، Java، JavaScript، Python، أو TypeScript

  • فهم نموذج العميل-الخادم وواجهات برمجة التطبيقات (APIs)

  • إلمام بمفاهيم REST وHTTP

  • (اختياري) خلفية في مفاهيم الذكاء الاصطناعي وتعلم الآلة

  • المشاركة في مناقشات المجتمع للدعم

📚 دليل الدراسة والموارد

يحتوي هذا المستودع على عدة موارد لمساعدتك على التنقل والتعلم بفعالية:

دليل الدراسة

يتوفر دليل دراسة شامل لمساعدتك على التنقل في هذا المستودع بفعالية. يشمل الدليل:

  • خريطة منهجية بصرية توضح جميع المواضيع المشمولة
  • تفصيل دقيق لكل قسم من أقسام المستودع
  • إرشادات حول كيفية استخدام المشاريع النموذجية
  • مسارات تعلم موصى بها لمستويات مهارة مختلفة
  • موارد إضافية تكمل رحلة تعلمك

سجل التغييرات

نحتفظ بسجل مفصل لتغييرات جميع التحديثات المهمة على مواد المنهج، بما في ذلك:

  • إضافات محتوى جديدة
  • تغييرات هيكلية
  • تحسينات في الميزات
  • تحديثات التوثيق

🛠️ كيفية استخدام هذا المنهج بفعالية

تتضمن كل درس في هذا الدليل:

  1. شروحات واضحة لمفاهيم MCP
  2. أمثلة حية للكود بعدة لغات
  3. تمارين لبناء تطبيقات MCP حقيقية
  4. موارد إضافية للمتعلمين المتقدمين

🌟 شكر المجتمع

شكر خاص للخبير المعتمد من مايكروسوفت Shivam Goyal لمساهمته بعينات كود مهمة.

📜 معلومات الترخيص

هذا المحتوى مرخص بموجب رخصة MIT. للاطلاع على الشروط والأحكام، راجع الرخصة.

🤝 إرشادات المساهمة

يرحب هذا المشروع بالمساهمات والاقتراحات. معظم المساهمات تتطلب منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تؤكد أنك تملك الحق، وأنك تمنحنا فعليًا حقوق استخدام مساهمتك. لمزيد من التفاصيل، قم بزيارة
https://cla.opensource.microsoft.com.

عند تقديم طلب سحب، سيقوم بوت CLA تلقائيًا بتحديد ما إذا كنت بحاجة إلى تقديم CLA وتزيين طلب السحب بشكل مناسب (مثل: فحص الحالة، تعليق). فقط اتبع التعليمات التي يقدمها البوت. ستحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع المستودعات التي تستخدم CLA الخاص بنا.

اعتمد هذا المشروع مدونة قواعد السلوك مفتوحة المصدر من مايكروسوفت. لمزيد من المعلومات، راجع الأسئلة الشائعة حول مدونة السلوك أو تواصل مع opencode@microsoft.com لأي أسئلة أو تعليقات إضافية.

📂 هيكل المستودع

تم تنظيم المستودع كما يلي:

  • المنهج الأساسي (00-10): المحتوى الرئيسي منظم في عشرة وحدات متتالية
  • images/: الرسوم التوضيحية والمخططات المستخدمة في المنهج
  • translations/: دعم متعدد اللغات مع ترجمات آلية
  • translated_images/: نسخ محلية من الرسوم التوضيحية والمخططات
  • study_guide.md: دليل شامل للتنقل في المستودع
  • changelog.md: سجل لجميع التغييرات المهمة في مواد المنهج
  • mcp.json: ملف تكوين لمواصفات MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: وثائق حوكمة المشروع

🎒 دورات أخرى

فريقنا يقدم دورات أخرى! اطلع على:

™️ إشعار العلامة التجارية

قد يحتوي هذا المشروع على علامات تجارية أو شعارات لمشاريع أو منتجات أو خدمات. الاستخدام المصرح به لعلامات مايكروسوفت التجارية أو شعاراتها يخضع ويجب أن يتبع
إرشادات العلامات التجارية والعلامات التجارية لمايكروسوفت.
يجب ألا يسبب استخدام علامات مايكروسوفت التجارية أو شعاراتها في نسخ معدلة من هذا المشروع أي لبس أو يوحي برعاية مايكروسوفت.
أي استخدام لعلامات تجارية أو شعارات طرف ثالث يخضع لسياسات تلك الأطراف.

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.