𝗨𝘀𝗲 𝗟𝗮𝗿𝗮𝘃𝗲𝗹 𝘁𝗼 𝗰𝗿𝗲𝗮𝘁𝗲 𝘆𝗼𝘂𝗿 𝗼𝘄𝗻 𝗠𝗖𝗣 𝘀𝗲𝗿𝘃𝗲𝗿
Claude మీ Laravel యాప్తో కలిసి పనిచేయగలదు. మీరు REST APIని నిర్మించాల్సిన లేదా కస్టమ్ క్లయింట్ను వ్రాయాల్సిన అవసరం లేదు. మీరు Model Context Protocol (MCP) ద్వారా టూల్స్ను అందుబాటులోకి తీసుకురావచ్చు.
laravel/mcp ప్యాకేజీ దీనిని సులభతరం చేస్తుంది. మీరు కేవలం ఒక మధ్యాహ్నం సమయంలోనే ఒక MCP సర్వర్ను నిర్మించవచ్చు.
ఒక MCP సర్వర్ AIకి మూడు అంశాలను అందిస్తుంది: • Tools: ఆర్డర్లను వెతకడం వంటి మోడల్ పిలిచే చర్యలు (actions). • Resources: సందర్భం (context) కోసం మోడల్ పొందే రీడ్-ఓన్లీ (read-only) డేటా. • Prompts: మళ్లీ ఉపయోగించదగిన టెంప్లేట్లు (reusable templates).
దీనిని ఎలా నిర్మించాలి:
- Setup
Composer ద్వారా ప్యాకేజీని ఇన్స్టాల్ చేయండి:
composer require laravel/mcp
మీ రూట్లను (routes) పబ్లిష్ చేయండి:
php artisan vendor:publish --tag=ai-routes
- Create a Server
ఒక సర్వర్ మీ టూల్స్ మరియు రిసోర్స్లను సమూహపరుస్తుంది. దీనిని ఈ క్రింది విధంగా జనరేట్ చేయండి:
php artisan make:mcp-server OrdersServer
దీనిని routes/ai.phpలో రిజిస్టర్ చేయండి. రిమోట్ క్లయింట్ల కోసం మీరు వెబ్ సర్వర్ను లేదా Claude Code వంటి టూల్స్ కోసం లోకల్ సర్వర్ను రన్ చేయవచ్చు.
- Create Tools
టూల్స్ అసలైన పనిని చేస్తాయి. ఒక టూల్ను ఈ క్రింది విధంగా జనరేట్ చేయండి:
php artisan make:mcp-tool SearchOrdersTool
ఒక టూల్కు రెండు మెథడ్స్ (methods) అవసరం: • Schema: మోడల్ పంపే ఆర్గ్యుమెంట్లను (arguments) ఇది నిర్వచిస్తుంది. • Handle: లాజిక్ను రన్ చేసి రెస్పాన్స్ను తిరిగి ఇస్తుంది.
స్పష్టమైన వివరణలను (descriptions) వ్రాయండి. మీ టూల్ను ఎప్పుడు ఉపయోగించాలో నిర్ణయించుకోవడానికి మోడల్ ఈ వివరణలను ఉపయోగిస్తుంది.
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 టెస్ట్లను కూడా వ్రాయవచ్చు.
ఇప్పుడు మీ అప్లికేషన్తో ఇంటరాక్ట్ అవ్వడానికి AI కోసం ఒక స్టాండర్డ్ ఇంటర్ఫేస్ సిద్ధంగా ఉంది. మీరు ఎటువంటి ప్రోటోకాల్ కోడ్ను వ్రాయాల్సిన అవసరం లేదు. కేవలం టూల్స్ను జోడించండి, వాటిని స్పష్టంగా వివరించండి మరియు middlewareతో సురక్షితం చేయండి.
మీరు MCP సర్వర్ను దేనికి కనెక్ట్ చేశారు? కామెంట్లలో నాకు తెలియజేయండి.
Source: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g