⚡ بداية سريعة: أنشئ خادم MCP جاهز للإنتاج يقوم بأتمتة استنساخ مستودعات GitHub ودمجها مع VS Code في 30 دقيقة فقط!
بحلول نهاية هذا المختبر، ستكون قادرًا على:
- ✅ إنشاء خادم MCP مخصص لتدفقات عمل تطوير حقيقية
- ✅ تنفيذ وظيفة استنساخ مستودعات GitHub عبر MCP
- ✅ دمج خوادم MCP المخصصة مع VS Code وAgent Builder
- ✅ استخدام وضع GitHub Copilot Agent مع أدوات MCP المخصصة
- ✅ اختبار ونشر خوادم MCP المخصصة في بيئات الإنتاج
- إكمال المختبرات 1-3 (أساسيات MCP والتطوير المتقدم)
- اشتراك GitHub Copilot (تسجيل مجاني متاح)
- VS Code مع ملحقات AI Toolkit وGitHub Copilot
- تثبيت وتكوين Git CLI
كمطورين، نستخدم GitHub كثيرًا لاستنساخ المستودعات وفتحها في VS Code أو VS Code Insiders. هذه العملية اليدوية تشمل:
- فتح الطرفية/موجه الأوامر
- التنقل إلى الدليل المطلوب
- تشغيل الأمر
git clone - فتح VS Code في الدليل المستنسخ
حل MCP الخاص بنا يبسط هذا إلى أمر ذكي واحد!
خادم GitHub Clone MCP (git_mcp_server) الذي يقدم:
| الميزة | الوصف | الفائدة |
|---|---|---|
| 🔄 استنساخ مستودعات ذكي | استنساخ مستودعات GitHub مع التحقق | التحقق التلقائي من الأخطاء |
| 📁 إدارة ذكية للدلائل | التحقق من وجود الدلائل وإنشاؤها بأمان | يمنع الكتابة فوق الملفات |
| 🚀 دمج متعدد المنصات مع VS Code | فتح المشاريع في VS Code/Insiders | انتقال سلس في سير العمل |
| 🛡️ معالجة أخطاء قوية | التعامل مع مشاكل الشبكة والصلاحيات والمسارات | موثوقية جاهزة للإنتاج |
-
افتح Agent Builder من خلال ملحق AI Toolkit
-
أنشئ وكيلًا جديدًا بالتكوين التالي:
Agent Name: GitHubAgent -
تهيئة خادم MCP مخصص:
- انتقل إلى الأدوات → إضافة أداة → خادم MCP
- اختر "إنشاء خادم MCP جديد"
- اختر قالب Python لأقصى مرونة
- اسم الخادم:
git_mcp_server
- افتح GitHub Copilot في VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- اختر نموذج الوكيل في واجهة Copilot
- اختر نموذج Claude 3.7 لتعزيز قدرات الاستدلال
- فعّل دمج MCP للوصول إلى الأدوات
💡 نصيحة احترافية: يوفر Claude 3.7 فهمًا متقدمًا لتدفقات العمل وأنماط معالجة الأخطاء.
استخدم الموجه التفصيلي التالي مع وضع GitHub Copilot Agent:
Create two MCP tools with the following comprehensive requirements:
🔧 TOOL A: clone_repository
Requirements:
- Clone any GitHub repository to a specified local folder
- Return the absolute path of the successfully cloned project
- Implement comprehensive validation:
✓ Check if target directory already exists (return error if exists)
✓ Validate GitHub URL format (https://github.com/user/repo)
✓ Verify git command availability (prompt installation if missing)
✓ Handle network connectivity issues
✓ Provide clear error messages for all failure scenarios
🚀 TOOL B: open_in_vscode
Requirements:
- Open specified folder in VS Code or VS Code Insiders
- Cross-platform compatibility (Windows/Linux/macOS)
- Use direct application launch (not terminal commands)
- Auto-detect available VS Code installations
- Handle cases where VS Code is not installed
- Provide user-friendly error messages
Additional Requirements:
- Follow MCP 1.9.3 best practices
- Include proper type hints and documentation
- Implement logging for debugging purposes
- Add input validation for all parameters
- Include comprehensive error handling
- شغّل تكوين التصحيح لـ Agent Builder
- كوّن وكيلك مع موجه النظام هذا:
SYSTEM_PROMPT:
You are my intelligent coding repository assistant. You help developers efficiently clone GitHub repositories and set up their development environment. Always provide clear feedback about operations and handle errors gracefully.
- اختبر بسيناريوهات مستخدم واقعية:
USER_PROMPT EXAMPLES:
Scenario : Basic Clone and Open
"Clone {Your GitHub Repo link such as https://github.com/kinfey/GHCAgentWorkshop
} and save to {The global path you specify}, then open it with VS Code Insiders"
النتائج المتوقعة:
- ✅ استنساخ ناجح مع تأكيد المسار
- ✅ فتح VS Code تلقائيًا
- ✅ رسائل خطأ واضحة للسيناريوهات غير الصالحة
- ✅ التعامل السليم مع الحالات الحدية
🎉 تهانينا! لقد أنشأت بنجاح خادم MCP عملي وجاهز للإنتاج يحل تحديات سير العمل الحقيقية في التطوير. يوضح خادم استنساخ GitHub المخصص الخاص بك قوة MCP في أتمتة وتحسين إنتاجية المطورين.
- ✅ مطور MCP - أنشأ خادم MCP مخصص
- ✅ مُبسط سير العمل - حسّن عمليات التطوير
- ✅ خبير التكامل - ربط أدوات تطوير متعددة
- ✅ جاهز للإنتاج - بناء حلول قابلة للنشر
عزيزي مشارك الورشة،
نبارك لك إتمام جميع الوحدات الأربع من ورشة Model Context Protocol! لقد قطعت شوطًا طويلًا من فهم أساسيات AI Toolkit إلى بناء خوادم MCP جاهزة للإنتاج تحل تحديات تطوير حقيقية.
الوحدة 1: بدأت باستكشاف أساسيات AI Toolkit، اختبار النماذج، وإنشاء أول وكيل AI.
الوحدة 2: تعلمت بنية MCP، دمج Playwright MCP، وبناء أول وكيل أتمتة متصفح.
الوحدة 3: تقدمت إلى تطوير خوادم MCP مخصصة مع خادم Weather MCP وتعلمت أدوات التصحيح.
الوحدة 4: طبقت كل شيء لإنشاء أداة أتمتة سير عمل مستودعات GitHub عملية.
- ✅ نظام AI Toolkit البيئي: النماذج، الوكلاء، وأنماط الدمج
- ✅ بنية MCP: تصميم العميل-الخادم، بروتوكولات النقل، والأمان
- ✅ أدوات المطورين: من Playground إلى Inspector وحتى النشر في الإنتاج
- ✅ التطوير المخصص: بناء، اختبار، ونشر خوادم MCP خاصة بك
- ✅ التطبيقات العملية: حل تحديات سير العمل الحقيقية باستخدام الذكاء الاصطناعي
- ابنِ خادم MCP خاص بك: طبق هذه المهارات لأتمتة تدفقات عملك الفريدة
- انضم إلى مجتمع MCP: شارك إبداعاتك وتعلم من الآخرين
- استكشف التكامل المتقدم: اربط خوادم MCP بأنظمة المؤسسات
- ساهم في المصادر المفتوحة: ساعد في تحسين أدوات MCP والوثائق
تذكر، هذه الورشة هي مجرد بداية. نظام Model Context Protocol يتطور بسرعة، وأنت الآن مجهز لتكون في طليعة أدوات التطوير المدعومة بالذكاء الاصطناعي.
شكرًا لمشاركتك والتزامك بالتعلم!
نأمل أن تكون هذه الورشة قد أثارت أفكارًا ستغير طريقة بناءك وتفاعلك مع أدوات الذكاء الاصطناعي في رحلتك التطويرية.
برمجة سعيدة!
تنويه:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والموثوق. للمعلومات الحساسة، يُنصح بالاعتماد على ترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.