Vue d'ensemble

Laravel MCP est le package officiel développé par l'équipe Laravel pour permettre aux développeurs de créer des serveurs Model Context Protocol (MCP) directement au sein des applications Laravel. Lancé en 2025 dans le cadre de la suite d'outils d'IA de Laravel, il fournit une interface fluide et native à Laravel pour définir des serveurs, des outils, des ressources et des invites (prompts) qui permettent à tout client IA compatible MCP (Claude, ChatGPT, Cursor, GitHub Copilot, etc.) d'interagir de manière sécurisée et efficace avec votre application Laravel.

En intégrant Laravel MCP, les applications acquièrent la capacité d'exposer des capacités structurées aux agents IA sans nécessiter d'API personnalisées, en suivant le standard MCP ouvert initialement introduit par Anthropic et désormais gouverné sous l'égide de la Linux Foundation.

Fonctionnalités principales

Définition expressive de serveur : Utilisez des attributs et des API fluides pour configurer les métadonnées du serveur (nom, version, instructions).
Outils, Ressources & Invites : Enregistrez des classes personnalisées pour des outils exécutables, des ressources lisibles et des modèles d'invite réutilisables.
Échafaudage Artisan : Générez des squelettes complets de serveurs MCP avec php artisan make:mcp-server.
Intégration native à Laravel : Tire parti d'Eloquent, du cache, des files d'attente, de l'authentification Sanctum et du conteneur de services.
Support HTTP et SSE avec streaming : Construit sur des transports MCP modernes pour des interactions en temps réel et évolutives.
Sécurité & Authentification : Intégration facile avec Laravel Sanctum ou Passport pour une authentification basée sur des jetons.
Support des tests : Fonctionne parfaitement avec Pest/PHPUnit pour tester les outils et le comportement du serveur.

Installation & Démarrage rapide

Installez via Composer :

composer require laravel/mcp

Publiez les routes et la configuration (optionnel) :

php artisan vendor:publish --tag=mcp-config
php artisan vendor:publish --tag=mcp-routes

Créez votre premier serveur :

php artisan make:mcp-server WeatherServer

Exemple de classe serveur :

<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Attributes\Version;
use Laravel\Mcp\Server\Attributes\Instructions;

#[Name('Weather Server')]
#[Version('1.0.0')]
#[Instructions('Provides current weather and forecasts for locations worldwide.')]
class WeatherServer extends Server
{
    protected array $tools = [
        \App\Mcp\Tools\GetCurrentWeather::class,
    ];

    protected array $resources = [
        \App\Mcp\Resources\WeatherGuidelines::class,
    ];
}

Cas d'utilisation

Outils de développement pilotés par l'IA : Exposer le contexte spécifique à Laravel (routes, modèles, migrations) aux agents de codage comme Claude Code ou Cursor.
Intégration d'applications métier : Permettre aux assistants IA d'interroger les données CRM, de gérer des tâches ou d'interagir avec les fonctionnalités e-commerce.
Serveurs locaux et distants : Exécuter des serveurs MCP localement pour le développement ou les déployer à distance pour des intégrations IA en production.
Compatibilité multi-clients : Un même serveur fonctionne sur toutes les principales plateformes IA prenant en charge MCP (Anthropic, OpenAI, Google, Microsoft).

Les benchmarks de la communauté montrent que Laravel MCP réduit le temps d'intégration des fonctionnalités IA par un facteur de 5 à 8 par rapport à des endpoints personnalisés, sans aucun enfermement propriétaire grâce au protocole ouvert.

Astuces avancées et pièges courants

Utiliser le middleware Sanctum pour sécuriser l'exécution des outils en production.
Mettre en place une limitation de débit sur les appels d'outils pour prévenir les abus.
Exploiter les modèles de ressources pour une exposition dynamique des données (ex : résultats de requêtes Eloquent).
Piège : Oublier d'enregistrer les routes — toujours exécuter php artisan route:cache après des modifications.
Avancé : Combiner avec Laravel Boost (un autre serveur MCP officiel) pour une expérience de développement local améliorée.

Conclusion et ressources

Laravel MCP représente l'engagement officiel de Laravel envers l'écosystème émergent des agents IA. Alors que l'adoption de MCP croît en 2026, intégrer un serveur MCP à votre application Laravel la positionne comme une infrastructure native à l'IA.

Commencez à construire dès aujourd'hui :

Documentation officielle : https://laravel.com/docs/12.x/mcp
GitHub : https://github.com/laravel/mcp
Découvrez l'application de démonstration Locket : https://github.com/laravel/locket

Contribuez au package ou construisez votre premier serveur MCP — l'avenir du développement Laravel assisté par l'IA est arrivé.