Usa Laravel per creare il tuo server MCP
Claude può lavorare con la tua app Laravel. Non hai bisogno di costruire un'API REST o scrivere un client personalizzato. Puoi esporre strumenti tramite il Model Context Protocol (MCP).
Il pacchetto laravel/mcp rende tutto semplice. Puoi costruire un server MCP in un pomeriggio.
Un server MCP fornisce tre cose a un'IA: • Tools: Azioni che il modello chiama, come la ricerca degli ordini. • Resources: Dati di sola lettura che il modello recupera per il contesto. • Prompts: Template riutilizzabili.
Come costruirlo:
- Setup Installa il pacchetto tramite Composer: composer require laravel/mcp
Pubblica le tue rotte: php artisan vendor:publish --tag=ai-routes
- Crea un Server Un server raggruppa i tuoi strumenti e le tue risorse. Generane uno con: php artisan make:mcp-server OrdersServer
Registralo in routes/ai.php. Puoi eseguire un server web per client remoti o un server locale per strumenti come Claude Code.
- Crea Strumenti (Tools) Gli strumenti svolgono il lavoro effettivo. Genera uno strumento con: php artisan make:mcp-tool SearchOrdersTool
Uno strumento richiede due metodi: • Schema: Definisce quali argomenti invia il modello. • Handle: Esegue la logica e restituisce una risposta.
Scrivi descrizioni chiare. Il modello usa queste descrizioni per decidere quando utilizzare il tuo strumento.
Usa le Annotazioni Usa gli attributi per descrivere il comportamento dello strumento: • IsReadOnly: Lo strumento non modifica i dati. • IsDestructive: Lo strumento modifica o elimina i dati. • IsIdempotent: Eseguirlo due volte produce lo stesso risultato di una volta sola.
Proteggi il tuo Server I server MCP web sono endpoint pubblici. Trattali come qualsiasi altra API. Usa i middleware per proteggerli. Laravel Sanctum o Passport funzionano bene per l'autenticazione.
Testa il tuo lavoro Usa l'MCP Inspector per testare manualmente il tuo server: php artisan mcp:inspector orders
Puoi anche scrivere test standard con PHPUnit per assicurarti che i tuoi strumenti funzionino correttamente.
Ora hai un'interfaccia standard per permettere all'IA di interagire con la tua applicazione. Non devi scrivere alcun codice relativo al protocollo. Aggiungi semplicemente strumenti, descrivili chiaramente e proteggili con i middleware.
A cosa hai collegato un server MCP? Fammi sapere nei commenti.
Fonte: https://dev.to/accreditly/use-laravel-to-create-your-own-mcp-server-251g