mcp-builder
מדריך רשמי של Anthropic ל-Claude להנחיה עצמית בבניית שרתי MCP (Model Context Protocol) איכותיים בפייתון או ב-TypeScript, מהתכנון ועד ליצירת בדיקות הערכה.
עובד עם
מה זה הסקיל mcp-builder?
mcp-builder הוא סקיל טכני-פנימי שנועד להנחות את Claude עצמו כיצד לבנות שרתי MCP (Model Context Protocol) איכותיים - שרתים המאפשרים למודלי שפה לתקשר עם שירותים חיצוניים באמצעות כלים (tools) מוגדרים היטב. זהו לא כלי שהמשתמש מפעיל ישירות על נתונים שלו, אלא מדריך תהליכי עבודה (workflow guide) שגורם ל-Claude לפעול בשיטתיות בעת פיתוח שרת MCP חדש, בין אם ב-Python (עם FastMCP) ובין אם ב-Node/TypeScript (עם MCP SDK).
ארבעת שלבי העבודה
הסקיל מפרק את בניית שרת ה-MCP לארבעה שלבים מרכזיים: מחקר ותכנון - הבנת עקרונות תכנון MCP מודרניים, קריאת תיעוד הפרוטוקול והבחירה בין TypeScript ל-Python; מימוש - הקמת מבנה הפרויקט, בניית תשתית משותפת (לקוח API, טיפול בשגיאות, פורמט תשובות, דפדוף) ומימוש הכלים עצמם עם סכמות קלט ופלט (Zod או Pydantic); סקירה ובדיקה - בדיקת קוד לפי עקרון DRY, טיפוסים מלאים ותיאורי כלים ברורים, כולל בנייה ובדיקה עם MCP Inspector; ויצירת הערכות (evaluations) - חיבור 10 שאלות בדיקה מורכבות ומציאותיות לאימות שהמודל מצליח להשתמש בשרת בצורה יעילה.
עקרונות תכנון מרכזיים
- איזון בין כיסוי מקיף של נקודות קצה ב-API לבין כלי עבודה ממוקדים למשימות ספציפיות
- שמות כלים עקביים וברורים (למשל
github_create_issue) לשיפור היכולת של הסוכן לאתר את הכלי הנכון - ניהול קונטקסט חכם - תיאורי כלים תמציתיים ותמיכה בסינון ובדפדוף תוצאות
- הודעות שגיאה פרקטיות שמכוונות את הסוכן לפתרון
- הגדרת אנוטציות לכלים (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
קבצי עזר נלווים
הסקיל מפנה למספר קבצי מדריך נוספים: מדריך שיטות עבודה מומלצות ל-MCP, מדריכי מימוש מפורטים לפייתון ול-TypeScript, ומדריך ליצירת הערכות (evaluations) בפורמט XML קבוע. השילוב המומלץ הוא TypeScript עם Streamable HTTP לשרתים מרוחקים או stdio לשרתים מקומיים.
איך להשתמש בסקיל הזה
- 1.לחצו על "הורדת ZIP" למעלה כדי להוריד את קבצי הסקיל.
- 2.חילצו את הקובץ ומקמו אותו בתיקיית הסקילים המקומית של הכלי שלכם, לפי התיעוד הרשמי שלו.
- 3.הפעילו מחדש את הסשן/השיחה - הסקיל יזוהה אוטומטית כשהנושא רלוונטי.
פרומפטים לדוגמה
בניית שרת MCP ל-API חיצוני
בעזרת הסקיל mcp-builder, תכנן ובנה שרת MCP ב-TypeScript שמאפשר גישה ל-API של GitHub, עם כלים לניהול issues ו-repositories
מימוש שרת MCP בפייתון
השתמש ב-mcp-builder כדי לבנות שרת MCP עם FastMCP בפייתון שמתחבר לשירות מזג אוויר חיצוני, כולל טיפול בשגיאות ודפדוף תוצאות
יצירת קובץ הערכה לשרת MCP
בהתאם לשלב 4 של mcp-builder, צור עבורי קובץ XML עם 10 שאלות הערכה מורכבות לבדיקת שרת ה-MCP שבניתי
שאלות נפוצות
האם mcp-builder הוא כלי שהמשתמש מפעיל בעצמו?
לא במובן הרגיל - זהו מדריך תהליכי עבודה (skill) שמנחה את Claude כיצד לתכנן, לממש ולבדוק שרתי MCP בעצמו, בין אם עבור פיתוח ב-Python או ב-TypeScript.
באילו שפות תכנות תומך הסקיל?
הסקיל מכיל הנחיות מפורטות עבור שתי שפות: TypeScript עם MCP SDK (המומלצת בשל תמיכת SDK טובה וטיפוסים סטטיים) ו-Python עם FastMCP.
מהם ארבעת השלבים שהסקיל מגדיר?
מחקר ותכנון, מימוש (Implementation), סקירה ובדיקה (Review and Test), ולבסוף יצירת הערכות (Evaluations) לבדיקת יעילות השרת שנבנה.
מה כוללת שלב יצירת ההערכות?
הרכבת 10 שאלות בדיקה מורכבות ומציאותיות, פתרון עצמי שלהן לאימות התשובה, ותיעודן בקובץ XML במבנה של qa_pair עם question ו-answer.
מוכנים להתקין את mcp-builder?
סקילס נוספים בכלי פיתוח
מנהל משלוחים ישראלי
כלי שמחבר את חנות האונליין שלכם לחברות המשלוחים הישראליות המובילות - דואר ישראל, צ'יטה, HFD, מהיר לי, UPS ישראל ו-GetPackage - ומייצר עבורכם תוויות משלוח, מעקב ואפשרויות איסוף מלוקרים בלחיצת כפתור.
docx
סקיל רשמי של Anthropic שמלמד את Claude ליצור, לקרוא, לערוך ולנתח קבצי Word (.docx/.dotx) - כולל טבלאות, עימוד, מעקב שינויים והערות - באמצעות כלים כמו docx (npm), pandoc ו-LibreOffice.
SDK של Base44
Base44 SDK היא ספריית התכנות שדרכה האפליקציה שלכם מדברת עם מערכות Base44 - נתונים, פונקציות שרת וסוכני AI. זהו הבסיס הטכני שכל פיצ'ר בפרויקט נשען עליו.
claude-api
סקיל ייחוס טכני של Anthropic שמנחה את Claude עצמו כיצד לכתוב קוד תקין מול Claude API / Anthropic SDK - בחירת מודל, תמחור, streaming, tool use ופרטים ספציפיים לכל שפת תכנות.