يوفر هذا الدليل نظرة عامة على هيكل ومستوى المحتوى في مستودع "بروتوكول سياق النموذج (MCP) للمبتدئين". استخدم هذا الدليل للتنقل داخل المستودع بكفاءة والاستفادة القصوى من الموارد المتاحة.
بروتوكول سياق النموذج (MCP) هو إطار معياري للتفاعل بين نماذج الذكاء الاصطناعي وتطبيقات العملاء. تم إنشاؤه في البداية بواسطة Anthropic، ويُدار الآن من قبل مجتمع MCP الأوسع عبر المنظمة الرسمية على GitHub. يوفر هذا المستودع منهجًا شاملاً مع أمثلة عملية على الشيفرة بلغات C#، Java، JavaScript، Python، وTypeScript، موجهًا لمطوري الذكاء الاصطناعي، مهندسي الأنظمة، ومهندسي البرمجيات.
mindmap
root((MCP for Beginners))
00. Introduction
::icon(fa fa-book)
(Protocol Overview)
(Standardization)
(Use Cases)
01. Core Concepts
::icon(fa fa-puzzle-piece)
(Client-Server Architecture)
(Protocol Components)
(Messaging Patterns)
02. Security
::icon(fa fa-shield)
(Threat Models)
(Best Practices)
(Auth Strategies)
03. Getting Started
::icon(fa fa-rocket)
(First Server)
(Client)
(LLM Client)
(VS Code Integration)
(SSE Server)
(HTTP Streaming)
(AI Toolkit)
(Testing)
(Deployment)
04. Practical Implementation
::icon(fa fa-code)
(SDKs)
(Testing/Debugging)
(Prompt Templates)
(Sample Projects)
05. Advanced Topics
::icon(fa fa-graduation-cap)
(Context Engineering)
(Foundry Integration)
(Multi-modal AI)
(OAuth2 Demo)
(Real-time Search)
(Streaming)
(Root Contexts)
(Routing)
(Sampling)
(Scaling)
(Security)
(Entra ID)
(Web Search)
06. Community
::icon(fa fa-users)
(Code Contributions)
(Documentation)
(MCP Clients)
(MCP Servers)
(Image Generation)
07. Early Adoption
::icon(fa fa-lightbulb)
(Real-world Examples)
(Deployment Stories)
(Future Roadmap)
08. Best Practices
::icon(fa fa-check)
(Performance)
(Fault Tolerance)
(Resilience)
09. Case Studies
::icon(fa fa-file-text)
(API Management)
(Travel Agent)
(Azure DevOps)
(Documentation MCP)
10. Hands-on Workshop
::icon(fa fa-laptop)
(AI Toolkit Integration)
(Custom Server Development)
(Production Deployment)
ينقسم المستودع إلى عشرة أقسام رئيسية، يركز كل منها على جانب مختلف من MCP:
-
المقدمة (00-Introduction/)
- نظرة عامة على بروتوكول سياق النموذج
- أهمية التوحيد في خطوط أنابيب الذكاء الاصطناعي
- حالات استخدام عملية وفوائد
-
المفاهيم الأساسية (01-CoreConcepts/)
- بنية العميل-الخادم
- المكونات الرئيسية للبروتوكول
- أنماط الرسائل في MCP
-
الأمان (02-Security/)
- التهديدات الأمنية في أنظمة MCP
- أفضل الممارسات لتأمين التنفيذات
- استراتيجيات المصادقة والتفويض
-
البدء السريع (03-GettingStarted/)
- إعداد البيئة والتكوين
- إنشاء خوادم وعملاء MCP أساسيين
- التكامل مع التطبيقات القائمة
- يشمل أقسامًا لـ:
- تنفيذ أول خادم
- تطوير العميل
- دمج عميل LLM
- التكامل مع VS Code
- خادم الأحداث المرسلة من الخادم (SSE)
- البث عبر HTTP
- دمج مجموعة أدوات الذكاء الاصطناعي
- استراتيجيات الاختبار
- إرشادات النشر
-
التنفيذ العملي (04-PracticalImplementation/)
- استخدام SDKs بلغات برمجة مختلفة
- تقنيات التصحيح، الاختبار، والتحقق
- تصميم قوالب مطالبات قابلة لإعادة الاستخدام وسير عمل
- مشاريع نموذجية مع أمثلة تنفيذية
-
المواضيع المتقدمة (05-AdvancedTopics/)
- تقنيات هندسة السياق
- دمج وكيل Foundry
- سير عمل الذكاء الاصطناعي متعدد الوسائط
- عروض توضيحية لمصادقة OAuth2
- قدرات البحث في الوقت الحقيقي
- البث في الوقت الحقيقي
- تنفيذ سياقات الجذر
- استراتيجيات التوجيه
- تقنيات العينة
- أساليب التوسع
- اعتبارات الأمان
- دمج أمان Entra ID
- دمج البحث على الويب
-
مساهمات المجتمع (06-CommunityContributions/)
- كيفية المساهمة بالشيفرة والوثائق
- التعاون عبر GitHub
- تحسينات المجتمع وردود الفعل
- استخدام عملاء MCP المتنوعين (Claude Desktop، Cline، VSCode)
- العمل مع خوادم MCP الشهيرة بما في ذلك توليد الصور
-
دروس من التبني المبكر (07-LessonsfromEarlyAdoption/)
- تطبيقات واقعية وقصص نجاح
- بناء ونشر حلول قائمة على MCP
- الاتجاهات وخارطة الطريق المستقبلية
-
أفضل الممارسات (08-BestPractices/)
- ضبط الأداء والتحسين
- تصميم أنظمة MCP مقاومة للأخطاء
- استراتيجيات الاختبار والمرونة
-
دراسات حالة (09-CaseStudy/)
- دراسة حالة: تكامل Azure API Management
- دراسة حالة: تنفيذ وكيل السفر
- دراسة حالة: تكامل Azure DevOps مع YouTube
- أمثلة تنفيذية مع توثيق مفصل
-
ورشة عمل تطبيقية (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- ورشة عمل شاملة تجمع MCP مع مجموعة أدوات الذكاء الاصطناعي
- بناء تطبيقات ذكية تربط نماذج الذكاء الاصطناعي بالأدوات الواقعية
- وحدات عملية تغطي الأساسيات، تطوير الخادم المخصص، واستراتيجيات النشر الإنتاجي
- نهج تعليمي مع مختبرات تعليمية وتعليمات خطوة بخطوة
يحتوي المستودع على موارد داعمة:
- مجلد الصور: يحتوي على مخططات ورسوم توضيحية مستخدمة في المنهج
- الترجمات: دعم متعدد اللغات مع ترجمات آلية للوثائق
- الموارد الرسمية لـ MCP:
- التعلم المتسلسل: اتبع الفصول بالترتيب (من 00 إلى 10) لتجربة تعلم منظمة.
- التركيز على لغة معينة: إذا كنت مهتمًا بلغة برمجة محددة، استكشف مجلدات العينات لتنفيذات بلغتك المفضلة.
- التنفيذ العملي: ابدأ بقسم "البدء السريع" لإعداد بيئتك وإنشاء أول خادم وعميل MCP.
- الاستكشاف المتقدم: بعد إتقان الأساسيات، تعمق في المواضيع المتقدمة لتوسيع معرفتك.
- المشاركة المجتمعية: انضم إلى مجتمع MCP عبر مناقشات GitHub وقنوات Discord للتواصل مع الخبراء والمطورين الآخرين.
يغطي المنهج عملاء وأدوات MCP المتنوعة:
-
العملاء الرسميون:
- Visual Studio Code
- MCP في Visual Studio Code
- Claude Desktop
- Claude في VSCode
- Claude API
-
عملاء المجتمع:
- Cline (واجهة طرفية)
- Cursor (محرر شيفرة)
- ChatMCP
- Windsurf
-
أدوات إدارة MCP:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
يقدم المستودع عدة خوادم MCP، منها:
-
خوادم مرجعية رسمية:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
توليد الصور:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
أدوات التطوير:
- Git MCP
- Terminal Control
- Code Assistant
-
خوادم متخصصة:
- Salesforce
- Microsoft Teams
- Jira & Confluence
يرحب هذا المستودع بمساهمات المجتمع. راجع قسم مساهمات المجتمع للحصول على إرشادات حول كيفية المساهمة بفعالية في نظام MCP البيئي.
| التاريخ | التغييرات |
|---|---|
| 16 يوليو 2025 | - تحديث هيكل المستودع ليعكس المحتوى الحالي - إضافة قسم عملاء وأدوات MCP - إضافة قسم خوادم MCP الشهيرة - تحديث خريطة المنهج البصرية مع جميع المواضيع الحالية - تعزيز قسم المواضيع المتقدمة بجميع المجالات المتخصصة - تحديث دراسات الحالة لتعكس أمثلة فعلية - توضيح أصل MCP كإنشاء من Anthropic |
| 11 يونيو 2025 | - الإنشاء الأولي لدليل الدراسة - إضافة خريطة المنهج البصرية - تحديد هيكل المستودع - تضمين مشاريع نموذجية وموارد إضافية |
تم تحديث هذا الدليل في 16 يوليو 2025، ويقدم نظرة عامة على المستودع حتى ذلك التاريخ. قد يتم تحديث محتوى المستودع بعد هذا التاريخ.
إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالاعتماد على الترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.