wehub-resource-sync🐙 מודול 4: פיתוח MCP מעשי - שרת שיבוט GitHub מותאם אישית
⚡ התחלה מהירה: בנה שרת MCP מוכן לייצור שמבצע אוטומציה לשיבוט ריפוזיטוריות GitHub ואינטגרציה עם VS Code תוך 30 דקות בלבד!
🎯 יעדי הלמידה
בסוף המעבדה הזו תוכל:
- ✅ ליצור שרת MCP מותאם אישית עבור זרמי עבודה בפיתוח בעולם האמיתי
- ✅ לממש פונקציונליות שיבוט ריפוזיטוריות GitHub באמצעות MCP
- ✅ לשלב שרתי MCP מותאמים אישית עם VS Code ו-Agent Builder
- ✅ להשתמש במצב Agent של GitHub Copilot עם כלי MCP מותאמים אישית
- ✅ לבדוק ולפרוס שרתי MCP מותאמים בסביבות ייצור
📋 דרישות מוקדמות
- השלמת מעבדות 1-3 (יסודות MCP ופיתוח מתקדם)
- מנוי GitHub Copilot (רישום חינם זמין)
- VS Code עם Microsoft Foundry 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 | מעבר חלק בזרם העבודה |
| 🛡️ טיפול חזק בשגיאות | טיפול בבעיות רשת, הרשאות ונתיבים | אמינות מוכנה לייצור |
📖 יישום שלב אחר שלב
שלב 1: יצירת סוכן GitHub ב-Agent Builder
-
הפעל את Agent Builder דרך הרחבת Microsoft Foundry Toolkit
-
צור סוכן חדש עם התצורה הבאה:
Agent Name: GitHubAgent -
אתחל שרת MCP מותאם אישית:
- עבור ל-כלים → הוסף כלי → שרת MCP
- בחר "Create A new MCP Server"
- בחר תבנית Python לגמישות מירבית
- שם השרת:
git_mcp_server
שלב 2: הגדרת מצב Agent של GitHub Copilot
- פתח את GitHub Copilot ב-VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- בחר מודל סוכן בממשק Copilot
- בחר במודל Claude 3.7 עבור יכולות הסקת מסקנות משופרות
- אפשר אינטגרציית MCP לגישה לכלים
💡 טיפ מקצועי: Claude 3.7 מספק הבנה מעמיקה של זרמי עבודה בפיתוח ודפוסי טיפול בשגיאות.
שלב 3: מימוש הפונקציונליות העיקרית של שרת MCP
השתמש בפקודת הפרומפט המפורטת הבאה עם מצב Agent של GitHub Copilot:
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
שלב 4: בדוק את שרת MCP שלך
4a. בדיקה ב-Agent Builder
- הפעל את קונפיגורציית הדיבאג עבור 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 אוטומטית
- ✅ הודעות שגיאה ברורות בתרחישים לא חוקיים
- ✅ טיפול נאות במקרים קיצוניים
4b. בדיקה ב-MCP Inspector
🎉 כל הכבוד! יצרת בהצלחה שרת MCP מעשי ומוכן לייצור הפותר את אתגרי זרימת העבודה הפיתוחית בעולם האמיתי. שרת השיבוט המותאם שלך מראה את עוצמת ה-MCP לאוטומציה ולשיפור פרודוקטיביות המפתחים.
🏆 הישג שהושג:
- ✅ מפתח MCP - יצירת שרת MCP מותאם אישית
- ✅ אוטומטור זרימות עבודה - פישוט תהליכי פיתוח
- ✅ מומחה אינטגרציה - חיבור מספר כלים לפיתוח
- ✅ מוכן לייצור - פתרונות פרוסים
🎓 סיום הסדנה: המסע שלך עם פרוטוקול הקשר למודל
משתתף יקר,
ברכות על השלמת כל ארבעת המודולים בסדנת פרוטוקול הקשר למודל! עברת דרך ארוכה מהבנת יסודות Microsoft Foundry Toolkit ועד לבניית שרתי MCP מוכנים לייצור הפותרים אתגרי פיתוח אמיתיים.
🚀 סיכום מסלול הלמידה שלך:
מודול 1: התחלת בחקר יסודות Microsoft Foundry Toolkit, בדיקות מודלים ויצירת סוכן AI ראשון.
מודול 2: למדת ארכיטקטורת MCP, שילוב Playwright MCP ובנית סוכן אוטומציה לדפדפן ראשון.
מודול 3: התקדמת לפיתוח שרתי MCP מותאמים עם שרת מזג האוויר וצבירת מומחיות בכלי דיבאג.
מודול 4: יישמת הכל ליצירת כלי אוטומציה למערכי ריפוזיטוריות GitHub מעשיים.
🌟 מה שלטת בו:
- ✅ אקוסיסטם Microsoft Foundry Toolkit: מודלים, סוכנים ודפוסי אינטגרציה
- ✅ ארכיטקטורת MCP: עיצוב לקוח-שרת, פרוטוקולי תקשורת ואבטחה
- ✅ כלי מפתחים: מפלטפורמת Playground ל-Inspector ועד לפריסה
- ✅ פיתוח מותאם אישית: בנייה, בדיקה ופריסה של שרתי MCP אישיים
- ✅ יישומים מעשיים: פתרון אתגרי זרימות עבודה אמיתיים עם AI
🔮 הצעדים הבאים שלך:
- בנה את שרת MCP שלך: יישם את הכישורים לאוטומציה של זרימות עבודה ייחודיות
- הצטרף לקהילת MCP: שתף יצירות ולמד מאחרים
- חקור אינטגרציה מתקדמת: קשר שרתי MCP למערכות ארגוניות
- תורם בקוד פתוח: סייע בשיפור כלי MCP והתיעוד
זכור, הסדנה היא רק ההתחלה. אקוסיסטם פרוטוקול הקשר למודל מתפתח במהירות, ואתה מצויד להיות בחזית כלי פיתוח מבוססי AI.
תודה על ההשתתפות והמסירות ללמידה!
אנו מקווים שסדנה זו עוררה בך רעיונות שישנו את אופן בניית הכלים והאינטראקציה שלך עם AI במסע הפיתוח.
קידוד מהנה!
מה הלאה
ברכות על השלמת כל המעבדות במודול 10!
- חזור ל: סקירת מודול 10
- המשך ל: מודול 11: מעבדות מעשיות לשרת MCP
כתב ויתור: מסמך זה תורגם באמצעות שירות תרגום אוטומטי Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להחשיב את המסמך המקורי בשפתו הטבעית כמקור הסמכות. למידע קריטי מומלץ להשתמש בתרגום מקצועי על ידי מתרגם אדם. אנו לא אחראים לכל אי-הבנה או פירוש שגוי הנובע מהשימוש בתרגום זה.