README.md

יישום מעשי

היישום המעשי הוא המקום שבו כוחו של Model Context Protocol (MCP) מתגלם במציאות. בעוד שהבנת התיאוריה והארכיטקטורה שמאחורי MCP חשובה, הערך האמיתי מתגלה כאשר אתה מיישם את המושגים האלה כדי לבנות, לבדוק ולפרוס פתרונות הפותרים בעיות אמיתיות. פרק זה גשר בין הידע התיאורטי לפיתוח מעשי, ומנחה אותך בתהליך הבאת יישומים מבוססי MCP לחיים.

בין אם אתה מפתח עוזרים חכמים, משלב AI בתהליכי עבודה עסקיים, או בונה כלים מותאמים לעיבוד נתונים, MCP מספקת בסיס גמיש. העיצוב הנייטרלי לשפה וה-SDKs הרשמיים לשפות תכנות פופולריות הופכים אותו לנגיש למגוון רחב של מפתחים. באמצעות ניצול SDKs אלה, תוכל במהירות ליצור אב-טיפוס, לחזור על תהליכים ולסקייל פתרונות בפלטפורמות וסביבות שונות.

בקטעים הבאים תמצא דוגמאות מעשיות, קודי דוגמה ואסטרטגיות פריסה המדגימות כיצד ליישם MCP ב-C#, Java, TypeScript, JavaScript ו-Python. תלמד גם כיצד לנפות שגיאות ולבדוק את שרתי MCP, לנהל APIs ולפרוס פתרונות לענן באמצעות Azure. המשאבים המעשיים הללו מיועדים להאיץ את הלמידה שלך ולעזור לך לבנות בביטחון יישומי MCP חזקים ומוכנים לפרודקשן.

סקירה כללית

השיעור מתמקד בהיבטים מעשיים של יישום MCP בשפות תכנות שונות. נבחן כיצד להשתמש ב-SDKs של MCP ב-C#, Java, TypeScript, JavaScript ו-Python כדי לבנות יישומים יציבים, לנפות שגיאות ולבדוק שרתי MCP, וליצור משאבים, פרומפטים וכלים שניתן להשתמש בהם שוב.

מטרות הלמידה

בסיום השיעור תוכל:

• ליישם פתרונות MCP באמצעות SDKs רשמיים בשפות תכנות שונות
• לנפות שגיאות ולבדוק שרתי MCP באופן שיטתי
• ליצור ולהשתמש בתכונות שרת (משאבים, פרומפטים וכלים)
• לתכנן תהליכי עבודה יעילים ב-MCP למשימות מורכבות
• לאופטם יישומי MCP לביצועים ואמינות

משאבי SDK רשמיים

Model Context Protocol מציע SDKs רשמיים למספר שפות:

• C# SDK
• Java SDK
• TypeScript SDK
• Python SDK
• Kotlin SDK

עבודה עם SDKs של MCP

בקטע זה מוצגים דוגמאות מעשיות ליישום MCP בשפות תכנות שונות. ניתן למצוא קוד לדוגמה בתיקיית samples הממוינת לפי שפה.

דוגמאות זמינות

הריפוזיטורי כולל יישומים לדוגמה בשפות הבאות:

• C#
• Java
• TypeScript
• JavaScript
• Python

כל דוגמה מדגימה מושגים מרכזיים ודפוסי יישום של MCP בשפה ובאקוסיסטם הספציפיים.

תכונות מרכזיות של השרת

שרתי MCP יכולים ליישם כל שילוב מהתכונות הבאות:

משאבים

משאבים מספקים הקשר ונתונים לשימוש המשתמש או מודל ה-AI:

• מאגרי מסמכים
• בסיסי ידע
• מקורות נתונים מובנים
• מערכות קבצים

פרומפטים

פרומפטים הם תבניות הודעות ותהליכי עבודה למשתמשים:

• תבניות שיחה מוגדרות מראש
• דפוסי אינטראקציה מונחים
• מבני דיאלוג מיוחדים

כלים

כלים הם פונקציות שהמודל מבצע:

• כלי עיבוד נתונים
• אינטגרציות API חיצוניות
• יכולות חישוביות
• פונקציות חיפוש

דוגמאות ליישום: C#

ריפוזיטורי ה-C# הרשמי כולל מספר דוגמאות ליישום המדגימות היבטים שונים של MCP:

• לקוח MCP בסיסי: דוגמה פשוטה שמראה כיצד ליצור לקוח MCP ולהפעיל כלים
• שרת MCP בסיסי: יישום שרת מינימלי עם רישום כלים בסיסי
• שרת MCP מתקדם: שרת מלא עם רישום כלים, אימות וטיפול בשגיאות
• אינטגרציה עם ASP.NET: דוגמאות הממחישות אינטגרציה עם ASP.NET Core
• דפוסי יישום כלים: דפוסים שונים ליישום כלים ברמות מורכבות שונות

ה-SDK של MCP ל-C# נמצא בבטא וייתכנו שינויים ב-APIs. נמשיך לעדכן את הבלוג ככל שה-SDK יתפתח.

תכונות מרכזיות

• C# MCP Nuget ModelContextProtocol
• בניית שרת MCP ראשון שלך.

למימושים מלאים ב-C#, בקר ב-ריפוזיטורי דוגמאות ה-C# הרשמי

דוגמת יישום: Java

ה-SDK של Java מציע אפשרויות יישום MCP מתקדמות עם תכונות ברמת ארגונית.

תכונות מרכזיות

• אינטגרציה עם Spring Framework
• בטיחות טיפוסים גבוהה
• תמיכה בתכנות ריאקטיבי
• טיפול שגיאות מקיף

לדוגמה מלאה של יישום Java, ראה דוגמת Java בתיקיית הדוגמאות.

דוגמת יישום: JavaScript

ה-SDK של JavaScript מספק גישה קלה וגמישה ליישום MCP.

תכונות מרכזיות

• תמיכה ב-Node.js ודפדפן
• API מבוסס Promises
• אינטגרציה פשוטה עם Express ומסגרות נוספות
• תמיכה ב-WebSocket לזרימה

לדוגמה מלאה של יישום JavaScript, ראה דוגמת JavaScript בתיקיית הדוגמאות.

דוגמת יישום: Python

ה-SDK של Python מציע גישה פייתונית ליישום MCP עם אינטגרציות מצוינות למסגרות ML.

תכונות מרכזיות

• תמיכה ב-async/await עם asyncio
• אינטגרציה עם Flask ו-FastAPI
• רישום כלים פשוט
• אינטגרציה טבעית עם ספריות ML פופולריות

לדוגמה מלאה של יישום Python, ראה דוגמת Python בתיקיית הדוגמאות.

ניהול API

Azure API Management היא פתרון מצוין לאבטחת שרתי MCP. הרעיון הוא להניח מופע של Azure API Management מול שרת MCP שלך ולתת לו לטפל בתכונות שאתה צפוי לרצות, כגון:

• הגבלת קצב
• ניהול טוקנים
• ניטור
• איזון עומסים
• אבטחה

דוגמת Azure

זוהי דוגמת Azure שעושה בדיוק את זה, כלומר יצירת שרת MCP ואבטחתו באמצעות Azure API Management.

ראה כיצד מתבצע תהליך האישור בתמונה הבאה:

בתמונה שלמעלה מתרחשים הדברים הבאים:

• אימות/אישור מתבצע באמצעות Microsoft Entra.
• Azure API Management משמש כשער ומנהל תעבורה באמצעות מדיניות.
• Azure Monitor רושם את כל הבקשות לניתוח נוסף.

תהליך האישור

נבחן את תהליך האישור בפירוט רב יותר:

מפרט האישור של MCP

למידע נוסף על מפרט האישור של MCP

פריסת שרת MCP מרוחק ב-Azure

בוא נראה אם נוכל לפרוס את הדוגמה שהזכרנו קודם:

1. שיבוט הריפוזיטורי

   git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
   cd remote-mcp-apim-functions-python

2. רישום ספק השירות Microsoft.App

   `` resource provider.

   • If you are using Azure CLI, run az provider register --namespace Microsoft.App --wait.
   • If you are using Azure PowerShell, run Register-AzResourceProvider -ProviderNamespace Microsoft.App. Then run (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState

   לאחר זמן מה, בדוק אם הרישום הושלם.

3. הרץ את הפקודה azd כדי להקצות את שירות ניהול ה-API, אפליקציית פונקציות (עם קוד) ואת כל משאבי Azure הנדרשים

   azd up

   פקודה זו אמורה לפרוס את כל משאבי הענן ב-Azure

בדיקת השרת שלך עם MCP Inspector

1. בחלון טרמינל חדש, התקן והפעל את MCP Inspector

   npx @modelcontextprotocol/inspector

   תראה ממשק דומה ל:

   

2. לחץ עם CTRL כדי לטעון את אפליקציית הווב של MCP Inspector מה-URL שמוצג על ידי האפליקציה (למשל http://127.0.0.1:6274/#resources)

3. הגדר את סוג התעבורה ל-SSE

4. Set the URL to your running API Management SSE endpoint displayed after azd up ולחץ על Connect:

   https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

5. רשום כלים. לחץ על כלי ובצע Run Tool.

אם כל השלבים עברו בהצלחה, כעת אתה מחובר לשרת MCP והצלחת להפעיל כלי.

שרתי MCP ל-Azure

Remote-mcp-functions: אוסף ריפוזיטורים זה הוא תבנית התחלה מהירה לבניית ופריסת שרתי MCP מרוחקים מותאמים אישית באמצעות Azure Functions ב-Python, C# .NET או Node/TypeScript.

הדוגמאות מספקות פתרון שלם המאפשר למפתחים:

• לבנות ולהריץ מקומית: לפתח ולנטרל שרת MCP במחשב מקומי
• לפרוס ל-Azure: לפרוס בקלות לענן באמצעות פקודת azd up פשוטה
• להתחבר מלקוחות: להתחבר לשרת MCP מלקוחות שונים כולל מצב סוכן Copilot ב-VS Code וכלי MCP Inspector

תכונות מרכזיות:

• אבטחה מובנית: שרת MCP מאובטח באמצעות מפתחות ו-HTTPS
• אפשרויות אימות: תומך ב-OAuth באמצעות אימות מובנה ו/או API Management
• בידוד רשת: מאפשר בידוד רשת באמצעות Azure Virtual Networks (VNET)
• ארכיטקטורה ללא שרת: מנצל Azure Functions לביצוע סקלאבילי ומונחה אירועים
• פיתוח מקומי: תמיכה מקיפה בפיתוח וניפוי שגיאות מקומי
• פריסה פשוטה: תהליך פריסה חלק לענן Azure

הריפוזיטורי כולל את כל קבצי התצורה, קוד המקור והגדרות התשתית הדרושים כדי להתחיל במהירות עם יישום שרת MCP מוכן לפרודקשן.

• Azure Remote MCP Functions Python - דוגמת יישום MCP באמצעות Azure Functions עם Python
• Azure Remote MCP Functions .NET - דוגמת יישום MCP באמצעות Azure Functions עם C# .NET
• Azure Remote MCP Functions Node/Typescript - דוגמת יישום MCP באמצעות Azure Functions עם Node/TypeScript

נקודות מרכזיות לזכור

• SDKs של MCP מספקים כלים ספציפיים לשפות ליישום פתרונות MCP יציבים
• תהליך ניפוי השגיאות והבדיקות קריטי לאמינות יישומי MCP
• תבניות פרומפט שניתנות לשימוש חוזר מאפשרות אינטראקציות עקביות עם ה-AI
• תהליכי עבודה מתוכננים היטב יכולים לתזמר משימות מורכבות באמצעות כלים שונים
• יישום פתרונות MCP דורש התייחסות לאבטחה, ביצועים וטיפול בשגיאות

תרגיל

עצב תהליך עבודה מעשי ב-MCP המתמודד עם בעיה אמיתית בתחום שלך:

1. זהה 3-4 כלים שיהיו שימושיים לפתרון הבעיה
2. צור דיאגרמת תהליך עבודה שמראה כיצד הכלים האלה מתקשרים
3. יישם גרסה בסיסית של אחד הכלים בשפת התכנות המועדפת עליך
4. עצב תבנית פרומפט שתעזור למודל להשתמש בכלי שלך בצורה יעילה

משאבים נוספים

---

הבא: נושאים מתקדמים

כתב ויתור:
מסמך זה תורגם באמצעות שירות תרגום מבוסס בינה מלאכותית Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון כי תרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להתייחס למסמך המקורי בשפתו המקורית כמקור הסמכות. למידע קריטי מומלץ להשתמש בתרגום מקצועי על ידי מתרגם אנושי. אנו לא נושאים באחריות לכל אי-הבנה או פרשנות שגויה הנובעת משימוש בתרגום זה.