𝗨𝘀𝗲 𝗟𝗮𝗿𝗮𝘃𝗲𝗹 𝘁𝗼 𝗰𝗿𝗲𝗮𝘁𝗲 𝘆𝗼𝘂𝗿 𝗼𝘄𝗻 𝗠𝗖𝗣 𝘀𝗲𝗿𝘃𝗲𝗿

Claude dapat bekerja dengan aplikasi Laravel Anda. Anda tidak perlu membangun REST API atau menulis klien khusus. Anda dapat mengekspos tools melalui Model Context Protocol (MCP).

Paket laravel/mcp mempermudah hal ini. Anda dapat membangun server MCP dalam satu sore saja.

Server MCP memberikan tiga hal kepada AI: • Tools: Tindakan yang dipanggil oleh model, seperti mencari pesanan. • Resources: Data baca-saja (read-only) yang ditarik model untuk konteks. • Prompts: Templat yang dapat digunakan kembali.

Cara membangunnya:

  1. Setup Instal paket melalui Composer: composer require laravel/mcp

Publikasikan rute Anda: php artisan vendor:publish --tag=ai-routes

  1. Create a Server Server mengelompokkan tools dan resources Anda. Buat satu dengan: php artisan make:mcp-server OrdersServer

Daftarkan di routes/ai.php. Anda dapat menjalankan server web untuk klien jarak jauh atau server lokal untuk alat seperti Claude Code.

  1. Create Tools Tools melakukan pekerjaan yang sebenarnya. Buat sebuah tool dengan: php artisan make:mcp-tool SearchOrdersTool

Sebuah tool membutuhkan dua metode: • Schema: Menentukan argumen apa yang dikirim oleh model. • Handle: Menjalankan logika dan mengembalikan respons.

Tulis deskripsi yang jelas. Model menggunakan deskripsi ini untuk memutuskan kapan harus menggunakan tool Anda.

  1. Use Annotations Gunakan atribut untuk mendeskripsikan perilaku tool: • IsReadOnly: Tool tidak mengubah data. • IsDestructive: Tool mengubah atau menghapus data. • IsIdempotent: Menjalankannya dua kali memberikan hasil yang sama dengan satu kali.

  2. Secure Your Server Server MCP berbasis web adalah endpoint publik. Perlakukan seperti API lainnya. Gunakan middleware untuk melindunginya. Laravel Sanctum atau Passport bekerja dengan baik untuk autentikasi.

  3. Test Your Work Gunakan MCP Inspector untuk menguji server Anda secara manual: php artisan mcp:inspector orders

Anda juga dapat menulis pengujian PHPUnit standar untuk memastikan tool Anda berfungsi dengan benar.

Sekarang Anda memiliki antarmuka standar agar AI dapat berinteraksi dengan aplikasi Anda. Anda tidak perlu menulis kode protokol apa pun. Cukup tambahkan tools, deskripsikan dengan jelas, dan amankan dengan middleware.

Anda telah menghubungkan server MCP ke apa? Beri tahu saya di kolom komentar.

Source: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g