Skip to content

Latest commit

 

History

History
542 lines (447 loc) · 46.2 KB

File metadata and controls

542 lines (447 loc) · 46.2 KB

سجل التغييرات: منهج MCP للمبتدئين

هذه الوثيقة تُستخدم كسجل لجميع التغييرات المهمة التي تم إجراؤها على منهج بروتوكول سياق النموذج (MCP) للمبتدئين. ويتم توثيق التغييرات بترتيب عكسي زمني (الأحدث أولاً).

5 فبراير 2026

تحسينات التحقق والتنقل على مستوى المستودع

إضافة محتوى جديد للمناهج

الوحدة 03 - البدء

  • 12-mcp-hosts/README.md: دليل شامل جديد لإعداد مضيفي MCP

    • أمثلة إعداد Claude Desktop و VS Code و Cursor و Cline و Windsurf
    • قوالب تشكيل JSON لجميع المضيفين الرئيسيين
    • جدول مقارنة أنواع النقل (stdio، SSE/HTTP، WebSocket)
    • معالجة مشكلات الاتصال الشائعة
    • أفضل ممارسات الأمان لتكوين المضيف
  • 13-mcp-inspector/README.md: دليل تصحيح أخطاء جديد لمفتش MCP

    • طرق التثبيت (npx، npm عالمي، من المصدر)
    • الاتصال بالخوادم عبر stdio و HTTP/SSE
    • أدوات الاختبار، الموارد، وسير عمل النماذج المحفزة
    • تكامل VS Code مع مفتش MCP
    • سيناريوهات تصحيح الأخطاء الشائعة مع حلول

الوحدة 04 - التطبيق العملي

  • pagination/README.md: دليل جديد لتطبيق الترقيم الصفحي
    • أنماط الترقيم الصفحي القائمة على المؤشر في Python و TypeScript و Java
    • التعامل مع الترقيم الصفحي على جانب العميل
    • استراتيجيات تصميم المؤشر (غير شفاف مقابل منظم)
    • توصيات لتحسين الأداء

الوحدة 05 - المواضيع المتقدمة

  • mcp-protocol-features/README.md: الغوص العميق في ميزات البروتوكول الجديدة
    • تنفيذ إشعارات التقدم
    • أنماط إلغاء الطلبات
    • قوالب الموارد مع أنماط URI
    • إدارة دورة حياة الخادم
    • التحكم في مستوى السجلات
    • أنماط معالجة الأخطاء مع أكواد JSON-RPC

إصلاحات في التنقل (تحديث أكثر من 24 ملفًا)

ملفات README للوحدات الرئيسية أصبح يحتوي على روابط لكل من الدرس الأول والوحدة التالية

ملفات فرعية 02-الأمان

  • كل الوثائق الأمنية الخمسة الإضافية الآن تحتوي على تنقل "ما التالي":

ملفات 09-دراسة حالة

  • كل ملفات دراسة الحالة الآن تحتوي على تنقل تسلسلي:

مختبرات 10-تيسير الذكاء الاصطناعي تمت إضافة قسم "ما التالي" إلى نظرة عامة الوحدة 10 والوحدة 11

إصلاحات في الشيفرة والمحتوى

تحديثات SDK والاعتمادات تم إصلاح إصدار openai الفارغ إلى ^4.95.0 تم تحديث SDK من ^1.8.0 إلى >=1.26.0 تم تحديث تثبيتات إصدار mcp إلى >=1.26.0

إصلاحات في الشيفرة تم إصلاح طراز غير صالح gpt-4o-mini إلى gpt-4.1-mini

إصلاحات في المحتوى تم إصلاح الرابط المكسور READMEmdREADME.md، تم إصلاح رأس المنهج Module 1-3Module 0-3، تم إصلاح مسار حساس لحالة الأحرف تمت إزالة محتوى دراسة حالة 5 المكرر والفاسد

تحسينات إرشاد المبتدئين تمت إضافة مقدمة مناسبة، وأهداف تعلم، ومتطلبات مسبقة للمبتدئين

تحديثات المنهج

README.md الرئيسي

  • إضافة الإدخالات 3.12 (مضيفي MCP)، 3.13 (مفتش MCP)، 4.1 (الترقيم الصفحي)، 5.16 (ميزات البروتوكول) إلى جدول المنهج

README للوحدات تمت إضافة الدروس 12 و13 إلى قائمة الدروس تمت إضافة قسم الأدلة العملية مع رابط الترقيم الصفحي تمت إضافة الدروس 5.15 (نقل مخصص) و5.16 (ميزات البروتوكول)

study_guide.md

  • تحديث خريطة الأفكار مع جميع المواضيع الجديدة: إعداد مضيفي MCP، مفتش MCP، استراتيجيات الترقيم الصفحي، الغوص العميق في ميزات البروتوكول

28 يناير 2026

مراجعة التوافق مع مواصفة MCP 2025-11-25

تعزيز المفاهيم الأساسية (01-CoreConcepts/)

  • بريميتيف جديد للعميل - Roots: إضافة توثيق شامل لبريمتيب العميل Roots الذي يمكّن الخوادم من فهم حدود نظام الملفات وصلاحيات الوصول
  • تعليقات أدوات: توثيق عن تعليقات سلوك الأدوات (readOnlyHint، destructiveHint) لاتخاذ قرارات تنفيذ أدوات أفضل
  • استدعاء الأدوات في العينة: تحديث توثيق العينة ليشمل معلمات tools و toolChoice لاستدعاء الأدوات بقيادة النموذج أثناء طلبات العينة
  • تحريض وضع URL: توثيق التحريض القائم على URL للتفاعلات الخارجية التي يبدأها الخادم
  • المهام (تجريبية): إضافة قسم جديد يوثق ميزة المهام التجريبية للأغلفة التنفيذية الدائمة واسترجاع النتائج المؤجلة
  • دعم الرموز: ملاحظة إمكانية تضمين الأيقونات كبيانات وصفية إضافية في الأدوات والموارد وقوالب الموارد والنماذج المحفزة

تحديثات التوثيق

  • README.md: إضافة مرجع إصدار MCP Specification 2025-11-25 وشرح الإصدار بناءً على التاريخ
  • study_guide.md: تحديث خريطة المنهج لتشمل المهام وتعليقات الأدوات في قسم المفاهيم الأساسية؛ تحديث توقيت الوثيقة

التحقق من التوافق مع المواصفة

  • إصدار البروتوكول: التحقق من أن كل التوثيق يشير إلى MCP Specification 2025-11-25 الحالي
  • الامتثال للهندسة المعمارية: تأكيد دقة توثيق الهندسة ذات الطبقتين (طبقة البيانات + طبقة النقل)
  • توثيق البريميتيفات: التحقق من صحة البريميتيفات الخادمة (الموارد، النماذج المحفزة، الأدوات) والبريميتيفات العميلة (العينة، التحريض، التسجيل، Roots)
  • آليات النقل: التحقق من دقة توثيق النقل عبر STDIO و HTTP القابل للبث
  • إرشادات الأمان: تأكيد التوافق مع أفضل ممارسات أمان MCP الحالية

توثيق الميزات الرئيسية لـ MCP 2025-11-25

  • اكتشاف OpenID Connect: اكتشاف خادم المصادقة عبر OIDC
  • وثائق بيانات تعريف عميل OAuth: آلية تسجيل العميل الموصى بها
  • مخطط JSON 2020-12: اللهجة الافتراضية لتعريفات مخططات MCP
  • نظام تصنيف SDK: متطلبات رسمية لدعم وصيانة ميزات SDK
  • هيكل الحوكمة: رسم مجموعات العمل ومجموعات الاهتمام رسميًا في حوكمة MCP

تحديث كبير في وثائق الأمان (02-Security/)

تكامل ورشة عمل قمة أمان MCP (شيربا)

  • مصدر تدريبي عملي جديد: إضافة تكامل شامل مع ورشة عمل قمة أمان MCP (شيربا) في كل وثائق الأمان
  • تغطية مسار الرحلة: توثيق التقدم الكامل من المخيم القاعدي إلى القمة
  • التوافق مع OWASP: كل إرشادات الأمان الآن مطابقة لمخاطر OWASP MCP في دليل أمان Azure

تكامل OWASP MCP Top 10

  • قسم جديد: إضافة جدول مخاطر أمان OWASP MCP Top 10 مع تخفيفات Azure إلى ملف README الأمني الرئيسي
  • توثيق معتمد على المخاطر: تحديث mcp-security-controls-2025.md مع مراجع مخاطر OWASP MCP لكل مجال أمان
  • الهندسة المرجعية: ربط بدليل هندسة الأمان والتنفيذ في OWASP MCP Azure

تحديث ملفات الأمان

  • README.md: إضافة نظرة عامة على ورشة شيربا، جدول مسار الرحلة، ملخص مخاطر OWASP MCP Top 10، وقسم التدريب العملي
  • mcp-security-controls-2025.md: تحديث رأس الملف لفبراير 2026، إضافة مراجع مخاطر OWASP (MCP01-MCP08)، إصلاح تعارض إصدار المواصفة
  • mcp-security-best-practices-2025.md: إضافة قسم موارد شيربا و OWASP، تحديث الطابع الزمني
  • mcp-best-practices.md: إضافة قسم التدريب العملي مع روابط شيربا و OWASP
  • azure-content-safety-implementation.md: إضافة مرجع OWASP MCP06، توافق مع معسكر شيربا 3، وقسم الموارد الإضافية

روابط موارد جديدة مضافة

توافق منهج MCP الشامل مع MCP Specification 2025-11-25

الوحدة 03 - البدء

  • توثيق SDK: إضافة Go SDK إلى قائمة SDK الرسمية؛ تحديث كل مراجع SDK لتتوافق مع MCP Specification 2025-11-25
  • توضيح النقل: تحديث أوصاف نقل STDIO و HTTP Streaming مع مراجع المواصفة الصريحة

الوحدة 04 - التطبيق العملي

  • تحديثات SDK: إضافة Go SDK؛ تحديث قائمة SDK مع مرجع إصدار المواصفة
  • مواصفة التفويض: تحديث رابط مواصفة MCP Authorization إلى الإصدار الحالي 2025-11-25

الوحدة 05 - المواضيع المتقدمة

  • ميزات جديدة: إضافة ملاحظة حول ميزات MCP Specification 2025-11-25 الجديدة (المهام، تعليقات الأدوات، تحريض وضع URL، Roots)
  • موارد الأمان: إضافة روابط OWASP MCP Top 10 وورشة شيربا إلى المراجع الإضافية

الوحدة 06 - مساهمات المجتمع

  • قائمة SDK: إضافة Swift و Rust SDKs؛ تحديث رابط المواصفة إلى 2025-11-25
  • مرجع المواصفة: تحديث رابط MCP Specification إلى عنوان المواصفة المباشر

الوحدة 07 - دروس من الاعتماد المبكر

  • تحديثات الموارد: إضافة رابط MCP Specification 2025-11-25 و OWASP MCP Top 10 إلى الموارد الإضافية

الوحدة 08 - أفضل الممارسات

  • إصدار المواصفة: تحديث مرجع MCP Specification إلى 2025-11-25
  • موارد الأمان: إضافة OWASP MCP Top 10 وورشة شيربا إلى المراجع الإضافية

الوحدة 10 - تيسير سير العمل الذكي الاصطناعي

  • تحديث الشارة: تغيير شارة إصدار MCP من إصدار SDK (1.9.3) إلى إصدار المواصفة (2025-11-25)
  • روابط الموارد: تحديث رابط MCP Specification؛ إضافة OWASP MCP Top 10

الوحدة 11 - مختبرات عملية لخادم MCP

  • مرجع المواصفة: تحديث رابط MCP Specification إلى الإصدار 2025-11-25
  • موارد الأمان: إضافة OWASP MCP Top 10 إلى الموارد الرسمية

18 ديسمبر 2025

تحديث وثائق الأمان - MCP Specification 2025-11-25

أفضل ممارسات أمان MCP (02-Security/mcp-best-practices.md) - تحديث إصدار المواصفة

  • تحديث إصدار البروتوكول: التحديث ليتضمن أحدث MCP Specification 2025-11-25 (الصادر في 25 نوفمبر 2025)
    • تحديث كل مراجع إصدار المواصفة من 2025-06-18 إلى 2025-11-25
    • تحديث تاريخ الوثيقة من 18 أغسطس 2025 إلى 18 ديسمبر 2025
    • التحقق من أن كل روابط المواصفة تشير إلى الوثائق الحالية
  • التحقق من المحتوى: التحقق الشامل من أفضل الممارسات الأمنية وفقًا لأحدث المعايير
    • حلول أمان مايكروسوفت: تأكيد المصطلحات والروابط الحالية لـ Prompt Shields (سابقًا "كشف مخاطر فك الحبس")، أمان محتوى Azure، Microsoft Entra ID، و Azure Key Vault
    • أمان OAuth 2.1: التحقق من التوافق مع أفضل ممارسات أمان OAuth الأخيرة
    • معايير OWASP: التأكد من أن مراجع OWASP Top 10 للنماذج اللغوية الكبيرة لا تزال محدثة
    • خدمات Azure: التحقق من كل روابط وثائق Microsoft Azure وأفضل الممارسات
  • التوافق مع المعايير: التأكد من أن كل المعايير الأمنية المشار إليها حديثة
    • إطار إدارة مخاطر الذكاء الاصطناعي NIST
    • ISO 27001:2022
    • أفضل ممارسات أمان OAuth 2.1
    • أطر أمان والامتثال Azure
  • موارد التنفيذ: التحقق من صحة كل روابط أدلة التنفيذ والموارد
    • أنماط مصادقة إدارة Azure API
    • أدلة تكامل Microsoft Entra ID
    • إدارة أسرار Azure Key Vault
    • خطوط أنابيب DevSecOps وحلول الرصد

ضبط جودة التوثيق

  • التوافق مع المواصفة: ضمان توافق كل متطلبات الأمان الإلزامية في MCP (يجب / يجب ألا) مع أحدث المواصفة
  • تحديث الموارد: التحقق من كل الروابط الخارجية لوثائق Microsoft، معايير الأمان، وأدلة التنفيذ
  • تغطية أفضل الممارسات: تأكيد التغطية الشاملة للمصادقة، التفويض، تهديدات الذكاء الاصطناعي الخاصة، أمان سلسلة التوريد، وأنماط المؤسسات

6 أكتوبر 2025

توسعة قسم البدء – استخدام الخوادم المتقدم والمصادقة البسيطة

استخدام الخوادم المتقدم (03-GettingStarted/10-advanced)

  • إضافة فصل جديد: تقديم دليل شامل لاستخدام خوادم MCP المتقدم، يغطي كلًا من هندسة الخادم العادية والمنخفضة المستوى.
    • الخادم العادي مقابل المنخفض المستوى: مقارنة مفصلة وأمثلة شيفرة في Python و TypeScript للطريقتين.
    • تصميم معتمد على المعالجات: شرح إدارة الأدوات/الموارد/النماذج المحفزة باستخدام المعالجات لتطبيقات خوادم مرنة وقابلة للتوسع.
    • أنماط عملية: سيناريوهات واقعية حيث أنماط الخادم منخفضة المستوى مفيدة للميزات والهندسة المتقدمة.

المصادقة البسيطة (03-GettingStarted/11-simple-auth)

  • إضافة فصل جديد: دليل خطوة بخطوة لتطبيق المصادقة البسيطة في خوادم MCP.
    • مفاهيم المصادقة: شرح واضح للفروقات بين المصادقة والتفويض، وإدارة بيانات الاعتماد.
    • تطبيق المصادقة الأساسية: أنماط مصادقة باستخدام الوسيط في Python (Starlette) و TypeScript (Express)، مع عينات شيفرة.
    • التدرج إلى الأمان المتقدم: إرشادات للانتقال من المصادقة البسيطة إلى OAuth 2.1 و RBAC، مع مراجع للوحدات الأمنية المتقدمة.

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

29 سبتمبر 2025

مختبرات تكامل قاعدة بيانات خادم MCP - مسار تعليمي متكامل عملي

11-MCPServerHandsOnLabs - منهج كامل جديد لتكامل قواعد البيانات

  • مسار تعلم 13-مختبر كاملاً: إضافة منهج عملي شامل لبناء خوادم MCP جاهزة للإنتاج مع دمج قاعدة بيانات PostgreSQL
    • تطبيق عملي في العالم الحقيقي: حالة استخدام تحليلات Zava Retail التي توضح أنماط المؤسسات
    • تسلسل تعلم منظم:
      • المختبرات 00-03: الأساسيات - مقدمة، البنية الأساسية، الأمان وتعدد المستأجرين، إعداد البيئة
      • المختبرات 04-06: بناء خادم MCP - تصميم قاعدة البيانات والمخطط، تنفيذ خادم MCP، تطوير الأدوات
      • المختبرات 07-09: الميزات المتقدمة - دمج البحث الدلالي، الاختبار وتصحيح الأخطاء، دمج VS Code
      • المختبرات 10-12: الإنتاج وأفضل الممارسات - استراتيجيات النشر، المراقبة والرصد، أفضل الممارسات والتحسين
    • تقنيات المؤسسات: إطار FastMCP، PostgreSQL مع pgvector، تضمينات Azure OpenAI، تطبيقات Azure Container، Application Insights
    • ميزات متقدمة: أمان مستوى الصف Row Level Security (RLS)، البحث الدلالي، الوصول إلى بيانات متعددة المستأجرين، تضمينات المتجهات، المراقبة في الوقت الفعلي

توحيد المصطلحات - تحويل الوحدة إلى مختبر

  • تحديث شامل للوثائق: تحديث منهجي لكافة ملفات README في 11-MCPServerHandsOnLabs لاستخدام مصطلح "مختبر" بدلاً من "وحدة"
    • رؤوس الأقسام: تحديث "ما يغطيه هذا الوحدة" إلى "ما يغطيه هذا المختبر" عبر جميع المختبرات الـ13
    • وصف المحتوى: تغيير "توفر هذه الوحدة..." إلى "يوفر هذا المختبر..." في جميع الوثائق
    • أهداف التعلم: تحديث "بنهاية هذه الوحدة..." إلى "بنهاية هذا المختبر..."
    • روابط التنقل: تحويل جميع المراجع "وحدة XX:" إلى "مختبر XX:" في المراجع المتبادلة والتنقل
    • تتبع الإنجاز: تحديث "بعد إكمال هذه الوحدة..." إلى "بعد إكمال هذا المختبر..."
    • الحفاظ على المراجع التقنية: الاحتفاظ بمراجع وحدات Python في ملفات التكوين (مثل "module": "mcp_server.main")

تحسين دليل الدراسة (study_guide.md)

  • خريطة منهجية بصرية: إضافة قسم جديد "11. مختبرات دمج قاعدة البيانات" مع تصور هيكلي شامل للمختبرات
  • هيكل المستودع: تحديث من عشرة إلى أحد عشر قسمًا رئيسيًا مع وصف مفصل لـ 11-MCPServerHandsOnLabs
  • توجيه مسار التعلم: تعزيز تعليمات التنقل لتشمل الأقسام 00-11
  • تغطية التكنولوجيا: إضافة تفاصيل دمج FastMCP, PostgreSQL, وخدمات Azure
  • نتائج التعلم: التأكيد على تطوير خوادم جاهزة للإنتاج، أنماط دمج قواعد البيانات، وأمان المؤسسات

تحسين هيكل README الرئيسي

  • مصطلحات تعتمد على المختبر: تحديث README.md الرئيسي في 11-MCPServerHandsOnLabs لاستخدام بنية "مختبر" بشكل متسق
  • تنظيم مسار التعلم: تقدم واضح من المفاهيم الأساسية مرورًا بالتنفيذ المتقدم وحتى نشر الإنتاج
  • تركيز على العالم الحقيقي: التأكيد على التعلم العملي والتطبيقي باستخدام أنماط وتقنيات على مستوى المؤسسات

تحسين جودة الاتساق الوثائقي

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

26 سبتمبر 2025

تحسين دراسات الحالة - دمج سجل MCP على GitHub

دراسات الحالة (09-CaseStudy/) - تركيز على تطوير النظام البيئي

  • README.md: توسع رئيسي مع دراسة حالة شاملة لسجل MCP على GitHub
    • دراسة حالة سجل MCP على GitHub: دراسة حالة شاملة جديدة تفحص إطلاق سجل MCP لشركة GitHub في سبتمبر 2025
      • تحليل المشكلة: دراسة مفصلة لتحديات اكتشاف ونشر خادم MCP المبعثر
      • هندسة الحل: نهج سجل مركزي لـ GitHub مع تثبيت بـ نقرة واحدة في VS Code
      • الأثر التجاري: تحسنات ملحوظة في إدماج المطورين والإنتاجية
      • القيمة الاستراتيجية: تركيز على نشر الوكلاء المعياري والتشغيل المتداخل بين الأدوات
      • تطوير النظام البيئي: التموضع كمنصة أساسية للتكامل الوكالي
    • تحسين هيكل دراسات الحالة: تحديث جميع الدراسات السبع مع تنسيق متسق وأوصاف شاملة
      • وكلاء السفر Azure AI: تركيز على تنظيم الوكلاء المتعددين
      • دمج Azure DevOps: تركيز على أتمتة سير العمل
      • استرجاع الوثائق في الوقت الفعلي: تنفيذ عميل وحدة تحكم Python
      • مولد خطة الدراسة التفاعلية: تطبيق ويب محادثة Chainlit
      • الوثائق داخل المحرر: دمج VS Code و GitHub Copilot
      • إدارة API الخاصة بـ Azure: أنماط دمج API على مستوى المؤسسات
      • سجل MCP على GitHub: تطوير النظام البيئي ومنصة المجتمع
    • خاتمة شاملة: إعادة كتابة قسم الخاتمة لتسليط الضوء على سبع دراسات حالة تغطي أبعاد متعددة من تنفيذ MCP
      • التكامل المؤسساتي، تنظيم الوكلاء المتعددين، إنتاجية المطورين
      • تطوير النظام البيئي، تصنيف التطبيقات التعليمية
      • رؤى محسنة في أنماط البناء والاستراتيجيات وأفضل الممارسات
      • التأكيد على MCP كبروتوكول ناضج وجاهز للإنتاج

تحديثات دليل الدراسة (study_guide.md)

  • خريطة منهجية بصرية: تحديث مخطط العقل ليشمل سجل MCP على GitHub في قسم دراسات الحالة
  • وصف دراسات الحالة: تحسين من الأوصاف العامة إلى تفصيل مفصل لسبع دراسات حالة شاملة
  • هيكل المستودع: تحديث القسم 10 ليعكس تغطية متكاملة لدراسات الحالة مع تفاصيل تنفيذ محددة
  • دمج سجل التغييرات: إضافة إدخال 26 سبتمبر 2025 لتوثيق إضافة سجل MCP على GitHub وتحسينات دراسات الحالة
  • تحديثات التاريخ: تحديث توقيت التذييل ليعكس أحدث مراجعة (26 سبتمبر 2025)

تحسين جودة الوثائق

  • تعزيز الاتساق: توحيد تنسيق وهيكل دراسات الحالة عبر جميع الأمثلة السبع
  • تغطية شاملة: تغطي دراسات الحالة الآن سيناريوهات المؤسسات، إنتاجية المطورين، وتطوير النظام البيئي
  • وضع استراتيجي: تركيز محسّن على MCP كمنصة أساسية لنشر أنظمة الوكلاء
  • دمج الموارد: تحديث الموارد الإضافية لتشمل رابط سجل MCP على GitHub

15 سبتمبر 2025

توسيع المواضيع المتقدمة - النقلات المخصصة وهندسة السياق

نقل MCP المخصصة (05-AdvancedTopics/mcp-transport/) - دليل تنفيذ متقدم جديد

  • README.md: دليل تنفيذ كامل لآليات النقل المخصصة MCP
    • نقل شبكة أحداث Azure Event Grid: تنفيذ شامل لنقل قائم على الأحداث بدون خادم
      • أمثلة بـ C# وTypeScript وPython مع دمج Azure Functions
      • أنماط هندسة قائمة على الأحداث للحلول القابلة للتوسع في MCP
      • مستقبلات Webhook ومعالجة الرسائل الدفعية
    • نقل Azure Event Hubs: تنفيذ نقل تدفق عالي السعة
      • إمكانيات البث الفوري للحالات ذات الكمون المنخفض
      • استراتيجيات التقسيم وإدارة نقاط التحقق
      • تجميع الرسائل وتحسين الأداء
    • أنماط تكامل المؤسسات: أمثلة معمارية جاهزة للإنتاج
      • معالجة MCP موزعة عبر وظائف Azure متعددة
      • هياكل نقل هجينة تجمع بين أنواع نقل متعددة
      • متانة الرسائل، الاعتمادية، واستراتيجيات التعامل مع الأخطاء
    • الأمان والمراقبة: دمج Azure Key Vault وأنماط الرصد
      • مصادقة الهوية المُدارة والوصول بأدنى امتيازات
      • تتبع الأداء في Application Insights
      • فواصم الدارة وأنماط تحمل الأعطال
    • أطر الاختبار: استراتيجيات اختبار شاملة للنقلات المخصصة
      • اختبار الوحدة مع أطر المضاهاة والتقليد
      • اختبار التكامل باستخدام Azure Test Containers
      • اعتبارات اختبار الأداء والحمل

هندسة السياق (05-AdvancedTopics/mcp-contextengineering/) - مجال ناشئ في الذكاء الاصطناعي

  • README.md: استكشاف شامل لهندسة السياق كمجال ناشئ
    • المبادئ الأساسية: مشاركة السياق الكامل، وعي اتخاذ القرار الإجرائي، وإدارة نافذة السياق
    • الامتثال لبروتوكول MCP: كيف يعالج تصميم MCP تحديات هندسة السياق
      • قيود نافذة السياق واستراتيجيات التحميل التدريجي
      • تحديد الصلة والاسترجاع الديناميكي للسياق
      • التعامل متعدد الوسائط مع السياق واعتبارات الأمان
    • نهج التنفيذ: بنى أحادية الخيط مقابل بنى متعددة الوكلاء
      • تجزئة السياق وتقنيات الأولوية
      • تحميل السياق التدريجي واستراتيجيات الضغط
      • نهج طبقي للسياق وتحسين الاسترجاع
    • إطار القياس: مقاييس ناشئة لتقييم فعالية السياق
      • كفاءة الإدخال، الأداء، الجودة، وتجربة المستخدم
      • مناهج تجريبية لتحسين السياق
      • تحليل الفشل ومنهجيات التحسين

تحديثات تنقل المنهج (README.md)

  • تعزيز هيكل الوحدة: تحديث جدول المنهج لإضافة المواضيع المتقدمة الجديدة
    • إضافة هندسة السياق (5.14) والنقل المخصص (5.15)
    • تنسيق وروابط تنقل متسقة عبر جميع الوحدات
    • تحديث الأوصاف لتعكس نطاق المحتوى الحالي

تحسين هيكل الدليل

  • توحيد التسمية: إعادة تسمية "mcp transport" إلى "mcp-transport" للتوافق مع مجلدات المواضيع المتقدمة الأخرى
  • تنظيم المحتوى: اتباع نمط تسمية متسق لجميع مجلدات 05-AdvancedTopics (mcp-[topic])

تحسين جودة الوثائق

  • مطابقة مواصفات MCP: جميع المحتويات الجديدة تشير إلى مواصفة MCP 2025-06-18 الحالية
  • أمثلة متعددة اللغات: أمثلة شاملة باللغات C#، TypeScript، وPython
  • تركيز مؤسسي: أنماط جاهزة للإنتاج ودمج سحابة Azure
  • توثيق بصري: مخططات Mermaid لهندسة التدفق والتصور

18 أغسطس 2025

تحديث شامل للوثائق - معايير MCP 2025-06-18

ممارسات الأمان الأفضل لـ MCP (02-Security/) - تحديث شامل

  • MCP-SECURITY-BEST-PRACTICES-2025.md: إعادة كتابة كاملة متوافقة مع مواصفة MCP 2025-06-18
    • المتطلبات الإلزامية: إضافة متطلبات MUST/MUST NOT صريحة من المواصفة مع مؤشرات بصرية واضحة
    • 12 ممارسة أمان أساسية: إعادة هيكلة من قائمة 15 عنصرًا إلى مجالات أمان شاملة
      • أمان الرموز والمصادقة مع دمج مزود هوية خارجي
      • إدارة الجلسة وأمان النقل مع متطلبات تشفير
      • حماية تهديدات الذكاء الاصطناعي مع دمج Microsoft Prompt Shields
      • التحكم في الوصول والصلاحيات مع مبدأ أقل امتياز
      • سلامة المحتوى والمراقبة مع دمج Azure Content Safety
      • أمان سلسلة التوريد مع تحقق شامل للمكونات
      • أمان OAuth ومنع هجوم الوكيل المشوش مع تنفيذ PKCE
      • الاستجابة للحوادث والتعافي مع قدرات مؤتمتة
      • الالتزام والحوكمة مع التوافق التنظيمي
      • ضوابط الأمان المتقدمة مع بنية الثقة الصفرية
      • دمج نظام أمان Microsoft مع حلول شاملة
      • التطور الأمني المستمر بممارسات تكيفية
    • حلول أمان Microsoft: تحسين إرشادات الدمج لـ Prompt Shields, Azure Content Safety, Entra ID، وGitHub Advanced Security
    • موارد التنفيذ: تنظيم روابط الموارد حسب الوثائق الرسمية MCP، حلول أمان Microsoft، معايير الأمان، وأدلة التنفيذ

ضوابط أمان متقدمة (02-Security/) - تنفيذ للمؤسسات

  • MCP-SECURITY-CONTROLS-2025.md: مراجعة كاملة مع إطار أمان مؤسسي متقدم
    • 9 مجالات أمان شاملة: توسع من الضوابط الأساسية إلى إطار عمل مفصل للمؤسسات
      • مصادقة وتفويض متقدمة مع دمج Microsoft Entra ID
      • أمان الرموز وضوابط منع المرور مع تحقق شامل
      • ضوابط أمان الجلسات مع منع الاختطاف
      • ضوابط أمان خاصة بالذكاء الاصطناعي مع منع حقن المطالبات وتسمم الأدوات
      • منع هجوم الوكيل المشوش مع أمان وكيل OAuth
      • أمان تنفيذ الأدوات مع الحجز والعزل
      • ضوابط أمان سلسلة التوريد مع تحقق من التبعيات
      • ضوابط المراقبة والكشف مع دمج SIEM
      • الاستجابة للحوادث والتعافي مع قدرات مؤتمتة
    • أمثلة التنفيذ: إضافة كتل تهيئة YAML مفصلة وأمثلة تعليمات برمجية
    • دمج حلول Microsoft: تغطية شاملة لخدمات أمان Azure، GitHub Advanced Security، وإدارة هوية المؤسسات

مواضيع أمان متقدمة (05-AdvancedTopics/mcp-security/) - تنفيذ جاهز للإنتاج

  • README.md: إعادة كتابة كاملة لتنفيذ أمان المؤسسات
    • توافق مع المواصفة الحالية: تحديث إلى مواصفة MCP 2025-06-18 مع متطلبات أمان إلزامية
    • تعزيز المصادقة: دمج Microsoft Entra ID مع أمثلة شاملة لـ .NET وJava Spring Security
    • دمج أمان الذكاء الاصطناعي: تنفيذ Microsoft Prompt Shields وAzure Content Safety بأمثلة Python مفصلة
    • تخفيف التهديدات المتقدمة: أمثلة تنفيذ شاملة لـ
      • منع هجوم الوكيل المشوش مع PKCE والتحقق من موافقة المستخدم
      • منع مرور الرموز مع تحقق الجمهور وإدارة الرموز الآمنة
      • منع اختطاف الجلسات مع الربط التشفيري وتحليل السلوك
    • دمج أمان المؤسسات: مراقبة Azure Application Insights، خطوط نقل الكشف عن التهديد، وأمان سلسلة التوريد
    • قائمة تحقق التنفيذ: ضوابط أمان إلزامية مقابل موصى بها مع فوائد منظومة أمان Microsoft

جودة الوثائق ومحاذاة المعايير

  • مراجع المواصفة: تحديث جميع المراجع لمواصفة MCP الحالية 2025-06-18
  • منظومة أمان Microsoft: تعزيز إرشادات الدمج في جميع وثائق الأمان
  • تنفيذ عملي: إضافة أمثلة تعليمية تفصيلية في .NET, Java, وPython مع أنماط مؤسسية
  • تنظيم الموارد: تصنيف شامل للوثائق الرسمية، معايير الأمان، وأدلة التنفيذ
  • مؤشرات بصرية: تمييز واضح للمتطلبات الإلزامية مقابل الممارسات الموصى بها

المفاهيم الأساسية (01-CoreConcepts/) - تحديث شامل

  • تحديث إصدار البروتوكول: تحديث للإشارة إلى مواصفة MCP الحالية 2025-06-18 بنظام الترقيم حسب التاريخ (صيغة YYYY-MM-DD)
  • تحسين البنية: تحسين أوصاف المضيفين والعملاء والخوادم لتعكس أنماط بنية MCP الحالية
  • تم تعريف المضيفين الآن بوضوح كتطبيقات ذكاء اصطناعي تنسق بين اتصالات متعددة لعملاء MCP
  • وُصف العملاء كمُتصِلات بروتوكول تحافظ على علاقات خادم لواحد
  • تم تعزيز الخوادم بسيناريوهات نشر محلية مقابل عن بُعد
  • إعادة هيكلة بدائية: مراجعة شاملة لـ primitives الخادم والعميل
    • Primitives الخادم: الموارد (مصادر البيانات)، المطالبات (القوالب)، الأدوات (الدوال القابلة للتنفيذ) مع شروحات وأمثلة مفصلة
    • Primitives العميل: التقاط عينات (اكتمالات LLM)، الاستخلاص (إدخال المستخدم)، التسجيل (تصحيح الأخطاء/المراقبة)
    • محدثة بأنماط طرق الاكتشاف الحالية (*/list)، الاسترجاع (*/get)، والتنفيذ (*/call)
  • هندسة البروتوكول: تقديم نموذج هندسة من طبقتين
    • طبقة البيانات: أساس JSON-RPC 2.0 مع إدارة دورة الحياة وال primitives
    • طبقة النقل: STDIO (محلي) وHTTP قابل للبث مع SSE (عن بُعد) كآليات نقل
  • إطار الأمان: مبادئ أمان شاملة تشمل موافقة المستخدم الصريحة، حماية خصوصية البيانات، أمان تنفيذ الأدوات، وأمان طبقة النقل
  • أنماط الاتصال: تحديث رسائل البروتوكول لتوضيح عمليات التهيئة والاكتشاف والتنفيذ والإشعارات
  • أمثلة الشيفرة: تحديث أمثلة متعددة اللغات (.NET، جافا، بايثون، جافا سكريبت) لتعكس أنماط SDK MCP الحالية

الأمان (02-Security/) - مراجعة شاملة للأمان

  • الامتثال للمعايير: موائمة كاملة مع متطلبات أمان MCP Specification 2025-06-18
  • تطور المصادقة: توثيق التطور من خوادم OAuth مخصصة إلى تفويض موفري الهوية الخارجيين (Microsoft Entra ID)
  • تحليل التهديدات الخاصة بالذكاء الاصطناعي: تغطية موسعة لأنواع هجمات الذكاء الاصطناعي الحديثة
    • سيناريوهات مفصلة لهجمات حقن المطالبات مع أمثلة من الواقع
    • آليات تسمم الأدوات وأنماط هجوم "سحب السجادة"
    • تسمم نافذة السياق وهجمات إرباك النماذج
  • حلول أمان الذكاء الاصطناعي من مايكروسوفت: تغطية شاملة لمنظومة الأمان من مايكروسوفت
    • AI Prompt Shields مع تقنيات الكشف المتقدمة، التمييز، والفواصل
    • أنماط تكامل أمان المحتوى Azure
    • أمان GitHub المتقدم لحماية سلسلة التوريد
  • تخفيف التهديدات المتقدمة: تحكمات أمان مفصلة لـ
    • اختطاف الجلسات مع سيناريوهات هجوم محددة لـ MCP ومتطلبات معرف الجلسة التشفيري
    • مشاكل الوكيل المشوش في سيناريوهات بروكسي MCP مع متطلبات موافقة صريحة
    • ثغرات تمرير الرموز مع ضوابط تحقق إلزامية
  • أمان سلسلة التوريد: توسيع تغطية سلسلة توريد الذكاء الاصطناعي بما يشمل نماذج الأساس، خدمات التضمين، مزودي السياق، وواجهات برمجة تطبيقات الطرف الثالث
  • أمان الأساس: تعزيز التكامل مع أنماط الأمان المؤسسية بما في ذلك هندسة الصفر ثقة ونظام أمان مايكروسوفت
  • تنظيم الموارد: تصنيف روابط الموارد الشاملة حسب النوع (الوثائق الرسمية، المعايير، الأبحاث، حلول مايكروسوفت، أدلة التنفيذ)

تحسينات جودة التوثيق

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

16 يوليو 2025

تحسينات README والتنقل

  • إعادة تصميم كاملة لتخطيط التنقل في README.md
  • استبدال علامات <details> بتنسيق جدولي أكثر سهولة في الاستخدام
  • إنشاء خيارات تخطيط بديلة في المجلد الجديد "alternative_layouts"
  • إضافة أمثلة تنقل قائمة على البطاقات، ترتيبات تبويب، وتنقل على شكل أكورديون
  • تحديث قسم هيكل المستودع ليشمل أحدث الملفات كلها
  • تعزيز قسم "كيفية استخدام هذا المنهج" بتوصيات واضحة
  • تحديث روابط مواصفة MCP لتشير إلى عناوين URL الصحيحة
  • إضافة قسم هندسة السياق (5.14) إلى هيكل المنهج

تحديثات دليل الدراسة

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

مساهمات المجتمع (06-CommunityContributions/)

  • إضافة معلومات مفصلة عن خوادم MCP لتوليد الصور
  • إضافة قسم شامل عن استخدام Claude في VSCode
  • إضافة تعليمات إعداد واستخدام عميل الطرفية Cline
  • تحديث قسم عملاء MCP ليشمل جميع الخيارات الشائعة
  • تعزيز أمثلة المساهمات بأمثلة شيفرة أكثر دقة

الموضوعات المتقدمة (05-AdvancedTopics/)

  • تنظيم جميع مجلدات الموضوعات التخصصية بتسمية متسقة
  • إضافة مواد وأمثلة هندسة السياق
  • إضافة توثيق تكامل وكيل Foundry
  • تعزيز توثيق تكامل أمان Entra ID

11 يونيو 2025

الإنشاء الأولي

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

البدء (03-GettingStarted/)

  • إنشاء أول أمثلة تنفيذ خوادم
  • إضافة توجيهات تطوير العملاء
  • تضمين تعليمات دمج عميل LLM
  • إضافة توثيق تكامل VS Code
  • تنفيذ أمثلة خادم باستخدام Server-Sent Events (SSE)

المفاهيم الأساسية (01-CoreConcepts/)

  • إضافة شرح مفصل لهندسة العميل-الخادم
  • إنشاء توثيق لمكونات البروتوكول الرئيسية
  • توثيق أنماط المراسلة في MCP

23 مايو 2025

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

  • تهيئة المستودع ببنية مجلدات أساسية
  • إنشاء ملفات README لكل قسم رئيسي
  • إعداد بنية الترجمة
  • إضافة أصول الصور والرسوم التوضيحية

التوثيق

  • إنشاء README.md ابتدائي مع نظرة عامة على المنهج
  • إضافة CODE_OF_CONDUCT.md و SECURITY.md
  • إعداد SUPPORT.md مع إرشادات للحصول على المساعدة
  • إنشاء هيكل أولي لدليل الدراسة

15 أبريل 2025

التخطيط والإطار العام

  • التخطيط الأولي لمنهج MCP للمبتدئين
  • تحديد أهداف التعلم والجمهور المستهدف
  • رسم هيكل المنهج المكون من 10 أقسام
  • تطوير إطار مفاهيمي للأمثلة ودراسات الحالة
  • إنشاء أمثلة أولية لمفاهيم رئيسية

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