உங்கள் சொந்த MCP சர்வரை உருவாக்க Laravel-ஐப் பயன்படுத்தவும்
Claude உங்கள் Laravel செயலியில் (app) இணைந்து செயல்பட முடியும். நீங்கள் ஒரு REST API-ஐ உருவாக்கவோ அல்லது ஒரு தனிப்பயன் (custom) கிளையண்ட்டை எழுதவோ தேவையில்லை. Model Context Protocol (MCP) மூலம் கருவிகளை (tools) நீங்கள் வெளிப்படுத்தலாம்.
laravel/mcp தொகுப்பு (package) இதை எளிதாக்குகிறது. நீங்கள் ஒரே ஒரு மதிய வேளையில் ஒரு MCP சர்வரை உருவாக்கிவிடலாம்.
ஒரு MCP சர்வர் AI-க்கு மூன்று விஷயங்களை வழங்குகிறது: • Tools: ஆர்டர்களைத் தேடுவது போன்ற மாடல் அழைக்கும் செயல்கள். • Resources: சூழலுக்காக (context) மாடல் எடுக்கும் படிக்க மட்டும் அனுமதி கொண்ட (read-only) தரவுகள். • Prompts: மீண்டும் பயன்படுத்தக்கூடிய டெம்ப்ளேட்டுகள் (templates).
இதை உருவாக்குவது எப்படி:
- அமைத்தல் (Setup)
Composer மூலம் தொகுப்பை நிறுவவும்:
composer require laravel/mcp
உங்கள் ரூட்களை (routes) வெளியிடவும்:
php artisan vendor:publish --tag=ai-routes
- ஒரு சர்வரை உருவாக்குதல் (Create a Server)
ஒரு சர்வர் உங்கள் கருவிகள் மற்றும் ஆதாரங்களை (resources) குழுவாக ஒருங்கிணைக்கிறது. இதைப் பின்வருமாறு உருவாக்கலாம்:
php artisan make:mcp-server OrdersServer
இதை routes/ai.php-இல் பதிவு செய்யவும். தொலைதூர கிளையண்ட்டுகளுக்காக (remote clients) ஒரு வெப் சர்வரையும் அல்லது Claude Code போன்ற கருவிகளுக்காக ஒரு லோக்கல் சர்வரையும் நீங்கள் இயக்கலாம்.
- கருவிகளை உருவாக்குதல் (Create Tools)
கருவிகள் தான் உண்மையான வேலையைச் செய்கின்றன. ஒரு கருவியை உருவாக்க:
php artisan make:mcp-tool SearchOrdersTool
ஒரு கருவிக்கு இரண்டு முறைகள் (methods) தேவை: • Schema: மாடல் அனுப்பும் வாதங்களை (arguments) வரையறுக்கிறது. • Handle: தர்க்கத்தை (logic) இயக்கி ஒரு பதிலை வழங்குகிறது.
தெளிவான விளக்கங்களை எழுதவும். உங்கள் கருவியை எப்போது பயன்படுத்த வேண்டும் என்று தீர்மானிக்க மாடல் இந்த விளக்கங்களைப் பயன்படுத்தும்.
அனோடேஷன்களைப் பயன்படுத்துதல் (Use Annotations) கருவியின் செயல்பாட்டை விவரிக்க அட்ரிபியூட்களைப் (attributes) பயன்படுத்தவும்: • IsReadOnly: கருவி தரவை மாற்றாது. • IsDestructive: கருவி தரவை மாற்றும் அல்லது நீக்கும். • IsIdempotent: இதை இரண்டு முறை இயக்குவது ஒருமுறை இயக்குவதற்கு இணையான முடிவைத் தரும்.
உங்கள் சர்வரைப் பாதுகாத்தல் (Secure Your Server) வெப் MCP சர்வர்கள் பொதுவான எண்ட்பாயிண்ட்கள் (public endpoints) ஆகும். அவற்றை மற்ற API-களைப் போலவே கையாளவும். அவற்றைப் பாதுகாக்க மிட்ல்வேரை (middleware) பயன்படுத்தவும். அங்கீகாரத்திற்கு (authentication) Laravel Sanctum அல்லது Passport சிறப்பாகச் செயல்படும்.
உங்கள் வேலையைச் சோதித்தல் (Test Your Work) உங்கள் சர்வரை கைமுறையாகச் சோதிக்க MCP Inspector-ஐப் பயன்படுத்தவும்:
php artisan mcp:inspector orders
உங்கள் கருவிகள் சரியாகச் செயல்படுவதை உறுதி செய்ய நீங்கள் நிலையான PHPUnit சோதனைகளையும் (tests) எழுதலாம்.
இப்போது உங்கள் செயலியில் AI உடன் தொடர்பு கொள்ள ஒரு நிலையான இடைமுகத்தை (interface) உங்களிடம் உள்ளது. நீங்கள் எந்த புரோட்டோகால் குறியீட்டையும் (protocol code) எழுதத் தேவையில்லை. கருவிகளைச் சேர்த்து, அவற்றைத் தெளிவாக விவரித்து, மிட்ல்வேர் மூலம் பாதுகாத்தால் போதுமானது.
நீங்கள் எதனுடன் ஒரு MCP சர்வரை இணைத்துள்ளீர்கள்? கருத்துகளில் (comments) எனக்குத் தெரியப்படுத்துங்கள்.
Source: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g