𝗨𝘀𝗲 𝗟𝗮𝗿𝗮𝘃𝗲𝗹 𝘁𝗼 𝗰𝗿𝗲𝗮𝘁𝗲 𝘆𝗼𝘂𝗿 𝗼𝘄𝗻 𝗠𝗖𝗣 𝘀𝗲𝗿𝘃𝗲𝗿
Claude ਤੁਹਾਡੀ Laravel ਐਪ ਦੇ ਨਾਲ ਕੰਮ ਕਰ ਸਕਦਾ ਹੈ। ਤੁਹਾਨੂੰ REST API ਬਣਾਉਣ ਜਾਂ ਕੋਈ ਕਸਟਮ ਕਲਾਇੰਟ ਲਿਖਣ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ। ਤੁਸੀਂ Model Context Protocol (MCP) ਰਾਹੀਂ ਟੂਲਸ (tools) ਪ੍ਰਦਾਨ ਕਰ ਸਕਦੇ ਹੋ।
laravel/mcp ਪੈਕੇਜ ਇਸ ਨੂੰ ਆਸਾਨ ਬਣਾਉਂਦਾ ਹੈ। ਤੁਸੀਂ ਇੱਕ ਦੁਪਹਿਰ ਵਿੱਚ ਹੀ MCP ਸਰਵਰ ਬਣਾ ਸਕਦੇ ਹੋ।
ਇੱਕ MCP ਸਰਵਰ AI ਨੂੰ ਤਿੰਨ ਚੀਜ਼ਾਂ ਦਿੰਦਾ ਹੈ: • Tools: ਉਹ ਐਕਸ਼ਨ ਜੋ ਮਾਡਲ ਕਾਲ ਕਰਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ ਆਰਡਰਾਂ ਨੂੰ ਲੱਭਣਾ। • Resources: ਰੀਡ-ਓਨਲੀ (read-only) ਡੇਟਾ ਜੋ ਮਾਡਲ ਸੰਦਰਭ (context) ਲਈ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ। • 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: ਇਹ ਲੋਜਿਕ ਚਲਾਉਂਦਾ ਹੈ ਅਤੇ ਜਵਾਬ (response) ਵਾਪਸ ਕਰਦਾ ਹੈ।
ਸਪਸ਼ਟ ਵੇਰਵੇ (descriptions) ਲਿਖੋ। ਮਾਡਲ ਇਹ ਫੈਸਲਾ ਕਰਨ ਲਈ ਕਿ ਤੁਹਾਡੇ ਟੂਲ ਦੀ ਵਰਤੋਂ ਕਦੋਂ ਕਰਨੀ ਹੈ, ਇਹਨਾਂ ਵੇਰਵਿਆਂ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ।
Use Annotations ਟੂਲ ਦੇ ਵਿਵਹਾਰ ਨੂੰ ਦੱਸਣ ਲਈ ਐਟਰੀਬਿਊਟਸ (attributes) ਦੀ ਵਰਤੋਂ ਕਰੋ: • IsReadOnly: ਟੂਲ ਡੇਟਾ ਨੂੰ ਬਦਲਦਾ ਨਹੀਂ ਹੈ। • IsDestructive: ਟੂਲ ਡੇਟਾ ਨੂੰ ਬਦਲਦਾ ਜਾਂ ਡਿਲੀਟ ਕਰਦਾ ਹੈ। • IsIdempotent: ਇਸ ਨੂੰ ਦੋ ਵਾਰ ਚਲਾਉਣ ਦਾ ਨਤੀਜਾ ਇੱਕ ਵਾਰ ਚਲਾਉਣ ਵਾਂਗ ਹੀ ਹੁੰਦਾ ਹੈ।
Secure Your Server ਵੈੱਬ MCP ਸਰਵਰ ਪਬਲਿਕ ਐਂਡਪੁਆਇੰਟਸ (endpoints) ਹੁੰਦੇ ਹਨ। ਉਹਨਾਂ ਨਾਲ ਕਿਸੇ ਵੀ ਹੋਰ API ਵਾਂਗ ਸਲੂਕ ਕਰੋ। ਉਹਨਾਂ ਦੀ ਰੱਖਿਆ ਲਈ ਮਿਡਲਵੇਅਰ (middleware) ਦੀ ਵਰਤੋਂ ਕਰੋ। ਅਥੈਂਟੀਕੇਸ਼ਨ (authentication) ਲਈ Laravel Sanctum ਜਾਂ Passport ਵਧੀਆ ਕੰਮ ਕਰਦੇ ਹਨ।
Test Your Work ਆਪਣੇ ਸਰਵਰ ਦੀ ਮੈਨੂਅਲੀ ਜਾਂਚ ਕਰਨ ਲਈ MCP Inspector ਦੀ ਵਰਤੋਂ ਕਰੋ:
php artisan mcp:inspector orders
ਤੁਸੀਂ ਇਹ ਯਕੀਨੀ ਬਣਾਉਣ ਲਈ ਕਿ ਤੁਹਾਡੇ ਟੂਲ ਸਹੀ ਤਰ੍ਹਾਂ ਕੰਮ ਕਰ ਰਹੇ ਹਨ, ਸਟੈਂਡਰਡ PHPUnit ਟੈਸਟ ਵੀ ਲਿਖ ਸਕਦੇ ਹੋ।
ਹੁਣ ਤੁਹਾਡੇ ਕੋਲ AI ਨੂੰ ਤੁਹਾਡੀ ਐਪਲੀਕੇਸ਼ਨ ਨਾਲ ਇੰਟਰੈਕਟ ਕਰਨ ਲਈ ਇੱਕ ਸਟੈਂਡਰਡ ਇੰਟਰਫੇਸ ਹੈ। ਤੁਹਾਨੂੰ ਕੋਈ ਪ੍ਰੋਟੋਕੋਲ ਕੋਡ ਲਿਖਣ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ। ਬੱਸ ਟੂਲਸ ਜੋੜੋ, ਉਹਨਾਂ ਦਾ ਸਪਸ਼ਟ ਵੇਰਵਾ ਦਿਓ, ਅਤੇ ਮਿਡਲਵੇਅਰ ਨਾਲ ਉਹਨਾਂ ਨੂੰ ਸੁਰੱਖਿਅਤ ਕਰੋ।
ਤੁਸੀਂ MCP ਸਰਵਰ ਨੂੰ ਕਿਸ ਚੀਜ਼ ਨਾਲ ਜੋੜਿਆ ਹੈ? ਮੈਨੂੰ ਕੁਮੈਂਟਸ ਵਿੱਚ ਦੱਸੋ।
Source: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g