اپنا MCP سرور بنانے کے لیے Laravel کا استعمال کریں
Claude آپ کی Laravel ایپ کے ساتھ کام کر سکتا ہے۔ آپ کو REST API بنانے یا کوئی کسٹم کلائنٹ لکھنے کی ضرورت نہیں ہے۔ آپ Model Context Protocol (MCP) کے ذریعے ٹولز (tools) فراہم کر سکتے ہیں۔
laravel/mcp پیکیج اس کام کو آسان بنا دیتا ہے۔ آپ ایک دوپہر میں MCP سرور بنا سکتے ہیں۔
ایک MCP سرور AI کو تین چیزیں فراہم کرتا ہے: • Tools: وہ ایکشنز جنہیں ماڈل کال کرتا ہے، جیسے آرڈرز تلاش کرنا۔ • Resources: صرف پڑھنے کے قابل (read-only) ڈیٹا جسے ماڈل سیاق و سباق (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 جیسے ٹولز کے لیے لوکل سرور چلا سکتے ہیں۔
- ٹولز بنائیں
ٹولز اصل کام کرتے ہیں۔ ایک ٹول اس طرح جنریٹ کریں:
php artisan make:mcp-tool SearchOrdersTool
ایک ٹول کے لیے دو میتھڈز (methods) کی ضرورت ہوتی ہے: • Schema: یہ طے کرتا ہے کہ ماڈل کون سے آرگومنٹ (arguments) بھیجے گا۔ • Handle: لاجک کو چلاتا ہے اور جواب (response) واپس کرتا ہے۔
واضح تفصیلات لکھیں۔ ماڈل یہ فیصلہ کرنے کے لیے ان تفصیلات کا استعمال کرتا ہے کہ اسے آپ کا ٹول کب استعمال کرنا ہے۔
اینوٹیشنز (Annotations) کا استعمال کریں ٹول کے طرزِ عمل کو بیان کرنے کے لیے ایٹریبیوٹس (attributes) کا استعمال کریں: • IsReadOnly: ٹول ڈیٹا تبدیل نہیں کرتا۔ • IsDestructive: ٹول ڈیٹا تبدیل یا ڈیلیٹ کرتا ہے۔ • IsIdempotent: اسے دو بار چلانے کا نتیجہ وہی ہوتا ہے جو ایک بار چلانے کا تھا۔
اپنے سرور کو محفوظ بنائیں ویب MCP سرورز عوامی اینڈ پوائنٹس (public endpoints) ہوتے ہیں۔ انہیں کسی بھی دوسرے API کی طرح سمجھیں۔ انہیں محفوظ بنانے کے لیے مڈل ویئر (middleware) کا استعمال کریں۔ Laravel Sanctum یا Passport آتھنٹیکیشن (authentication) کے لیے بہترین ہیں۔
اپنے کام کی جانچ کریں اپنے سرور کو دستی طور پر ٹیسٹ کرنے کے لیے MCP Inspector کا استعمال کریں:
php artisan mcp:inspector orders
آپ اپنے ٹولز کے درست طریقے سے کام کرنے کو یقینی بنانے کے لیے معیاری PHPUnit ٹیسٹ بھی لکھ سکتے ہیں۔
اب آپ کے پاس AI کے لیے اپنی ایپلی کیشن کے ساتھ بات چیت کرنے کے لیے ایک معیاری انٹرفیس موجود ہے۔ آپ کو کوئی پروٹوکول کوڈ لکھنے کی ضرورت نہیں ہے۔ بس ٹولز شامل کریں، انہیں واضح طور پر بیان کریں، اور مڈل ویئر کے ذریعے انہیں محفوظ بنائیں۔
آپ نے MCP سرور کو کس چیز کے ساتھ منسلک کیا ہے؟ مجھے کمنٹس میں بتائیں۔
حوالہ: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g