MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

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

  1. نسخ المستودع: انقر GitHub forks
  2. استنساخ المستودع: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. انضم إلى مجتمع 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

📚 هيكل المنهج الكامل

الوحدةالموضوعالوصفالرابط
الوحدات 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

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

  • الانضمام إلى مناقشات المجتمع للحصول على الدعم

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

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

دليل الدراسة

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

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

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

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

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

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

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

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

الفعاليات

أيام تطوير 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: وثائق إدارة المشروع

🎒 دورات أخرى

فريقنا ينتج دورات أخرى! تحقق من:

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

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

الحصول على المساعدة

إذا واجهت صعوبة أو كانت لديك أسئلة حول بناء تطبيقات الذكاء الاصطناعي، انضم إلى:

مجتمع Discord الخاص بـ Azure AI Foundry

إذا كانت لديك ملاحظات حول المنتج أو أخطاء أثناء البناء، قم بزيارة:

منتدى مطوري Azure AI Foundry


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