השתמשו ב-Laravel כדי ליצור שרת MCP משלכם
Claude יכול לעבוד עם אפליקציית ה-Laravel שלכם. אין צורך לבנות REST API או לכתוב client מותאם אישית. ניתן לחשוף כלים באמצעות Model Context Protocol (MCP).
חבילת laravel/mcp הופכת את זה לקל. ניתן לבנות שרת MCP בצהריים אחדים.
שרת MCP מספק שלושה דברים ל-AI: • Tools (כלים): פעולות שהמודל מפעיל, כמו חיפוש הזמנות. • Resources (משאבים): נתונים לקריאה בלבד שהמודל שואב לצורך הקשר (context). • Prompts (הנחיות): תבניות ניתנות לשימוש חוזר.
איך בונים אותו:
- Setup (הגדרה)
התקינו את החבילה באמצעות Composer:
composer require laravel/mcp
פרסמו את הניתובים (routes) שלכם:
php artisan vendor:publish --tag=ai-routes
- יצירת שרת
שרת מקבץ את הכלים והמשאבים שלכם. צרו שרת באמצעות:
php artisan make:mcp-server OrdersServer
רשמו אותו ב-routes/ai.php. ניתן להריץ שרת אינטרנט עבור לקוחות מרוחקים או שרת מקומי עבור כלים כמו Claude Code.
- יצירת כלים (Tools)
הכלים מבצעים את העבודה בפועל. צרו כלי באמצעות:
php artisan make:mcp-tool SearchOrdersTool
כלי זקוק לשתי מתודות: • Schema: מגדירה אילו ארגומנטים המודל שולח. • Handle: מריצה את הלוגיקה ומחזירה תגובה.
כתבו תיאורים ברורים. המודל משתמש בתיאורים אלו כדי להחליט מתי להשתמש בכלי שלכם.
שימוש ב-Annotations השתמשו ב-attributes כדי לתאר את התנהגות הכלי: • IsReadOnly: הכלי אינו משנה נתונים. • IsDestructive: הכלי משנה או מוחק נתונים. • IsIdempotent: הרצה פעמיים נותנת את אותה תוצאה כמו הרצה פעם אחת.
אבטחת השרת שלכם שרתי MCP באינטרנט הם נקודות קצה (endpoints) ציבוריות. התייחסו אליהם כמו לכל API אחר. השתמשו ב-middleware כדי להגן עליהם. Laravel Sanctum או Passport יעבדו היטב לצורך אימות (authentication).
בדיקת העבודה השתמשו ב-MCP Inspector כדי לבדוק את השרת שלכם באופן ידני:
php artisan mcp:inspector orders
ניתן גם לכתוב בדיקות PHPUnit סטנדרטיות כדי לוודא שהכלים שלכם עובדים כראוי.
כעת יש לכם ממשק סטנדרטי לאינטראקציה של AI עם האפליקציה שלכם. אין צורך לכתוב קוד פרוטוקול כלשהו. פשוט הוסיפו כלים, תארו אותם בבירור ואבטחו אותם באמצעות middleware.
למה חיברתם שרת MCP? ספרו לי בתגובות.
Source: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g