Skip to content

Latest commit

 

History

History
265 lines (198 loc) · 24.7 KB

File metadata and controls

265 lines (198 loc) · 24.7 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. نسخ المستودع: اضغط 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 transport الدليل
3.6 بث HTTP تنفيذ بث HTTP في MCP الدليل
3.7 أدوات الذكاء الاصطناعي استخدام أدوات الذكاء الاصطناعي مع 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 عرض التعليمات البرمجية
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، وهو حدث افتراضي مخصص لبروتوكول سياق النموذج (MCP) — المعيار الناشئ الذي يربط بين نماذج الذكاء الاصطناعي والأدوات التي تعتمد عليها.
يمكنك مشاهدة أيام مطوري MCP من خلال التسجيل في صفحة الحدث: https://aka.ms/mcpdevdays.

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

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

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

  • بناء خوادم MCP ودمجها في تجارب الوكلاء
  • تطوير موجه بالمطالبات
  • أفضل الممارسات الأمنية
  • استخدام اللبنات الأساسية مثل Functions، ACA، وإدارة واجهات برمجة التطبيقات
  • توافق السجل والأدوات (1P + 3P)

إذا كنت مطورًا، أو منشئ أدوات، أو استراتيجي منتجات الذكاء الاصطناعي، فإن هذا اليوم مليء بالرؤى التي تحتاجها لبناء حلول MCP قابلة للتوسع، آمنة، وجاهزة للمستقبل.

معسكر MCP التدريبي أغسطس 2025

تعلم من خلال جلسات فيديو مكثفة كيفية إنشاء خوادم MCP، التكامل مع VS Code، والنشر بشكل احترافي على Azure بناءً على محتوى منهج MCP للمبتدئين. احصل على مهارات عملية في تقنية تستخدمها بالفعل شركات كبرى.

🌟 شكرًا للمجتمع

شكرًا للمحترف المقدر من Microsoft شيفام غويال على مساهمته في نماذج الكود المهمة.

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

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

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

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

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

هذا المشروع تبنى مدونة قواعد السلوك مفتوحة المصدر من Microsoft.
لمزيد من المعلومات، راجع الأسئلة الشائعة حول مدونة قواعد السلوك أو
تواصل مع 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: وثائق حوكمة المشروع

🎒 دورات أخرى

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

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

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


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