Laravel MCP

Visión general

Laravel MCP es el paquete oficial desarrollado por el equipo de Laravel para permitir a los desarrolladores construir servidores del Model Context Protocol (MCP) directamente dentro de aplicaciones Laravel. Lanzado en 2025 como parte del conjunto de herramientas de IA de Laravel, proporciona una interfaz fluida y nativa de Laravel para definir servidores, herramientas, recursos y prompts que permiten a cualquier cliente de IA compatible con MCP (Claude, ChatGPT, Cursor, GitHub Copilot, etc.) interactuar de forma segura y eficiente con tu aplicación Laravel.

Al integrar Laravel MCP, las aplicaciones obtienen la capacidad de exponer capacidades estructuradas a agentes de IA sin necesidad de APIs personalizadas, siguiendo el estándar abierto MCP introducido originalmente por Anthropic y ahora gestionado bajo la Linux Foundation.

Características principales

• Definición expresiva de servidores: Usa atributos y APIs fluidas para configurar metadatos del servidor (nombre, versión, instrucciones).
• Herramientas, Recursos & Prompts: Registra clases personalizadas para herramientas ejecutables, recursos legibles y plantillas de prompts reutilizables.
• Scaffolding con Artisan: Genera esqueletos completos de servidores MCP con php artisan make:mcp-server.
• Integración nativa de Laravel: Aprovecha Eloquent, caché, colas, autenticación Sanctum y el contenedor de servicios.
• Soporte para HTTP y SSE transmitidos: Construido sobre transportes MCP modernos para interacciones en tiempo real y escalables.
• Seguridad & Autenticación: Integración sencilla con Laravel Sanctum o Passport para autenticación basada en tokens.
• Soporte para pruebas: Funciona perfectamente con Pest/PHPUnit para probar herramientas y el comportamiento del servidor.

Instalación & Inicio rápido

Instala mediante Composer:

composer require laravel/mcp

Publica rutas y configuración (opcional):

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

Crea tu primer servidor:

php artisan make:mcp-server WeatherServer

Ejemplo de clase servidor:

<?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,
    ];
}

Casos de Uso

• Herramientas de Desarrollo con IA: Expón el contexto específico de Laravel (rutas, modelos, migraciones) a agentes de código como Claude Code o Cursor.
• Integración de Aplicaciones Empresariales: Permite que los asistentes de IA consulten datos del CRM, gestionen tareas o interactúen con funcionalidades de comercio electrónico.
• Servidores Locales y Remotos: Ejecuta servidores MCP localmente para desarrollo o despliégalos de forma remota para integraciones de IA en producción.
• Compatibilidad Multi-Cliente: Un mismo servidor funciona en todas las principales plataformas de IA que admiten MCP (Anthropic, OpenAI, Google, Microsoft).

Los puntos de referencia de la comunidad muestran que Laravel MCP reduce el tiempo de integración para funciones de IA entre 5 y 8 veces en comparación con endpoints personalizados, sin dependencia de proveedores gracias al protocolo abierto.

Consejos Avanzados y Errores Comunes

• Utiliza el middleware de Sanctum para servidores en producción, a fin de asegurar la ejecución de herramientas.
• Implementa limitación de tasa en las llamadas a herramientas para evitar abusos.
• Aprovecha las plantillas de recursos para la exposición dinámica de datos (por ejemplo, resultados de consultas Eloquent).
• Error: Olvidar registrar las rutas — siempre ejecuta php artisan route:cache después de realizar cambios.
• Avanzado: Combínalo con Laravel Boost (otro servidor MCP de primera parte) para mejorar la experiencia de desarrollo local.

Conclusión y Recursos

Laravel MCP representa el compromiso oficial de Laravel con el ecosistema emergente de agentes de IA. A medida que crece la adopción de MCP en 2026, tener un servidor MCP en tu aplicación Laravel la posiciona como una infraestructura nativa para IA.

Comienza a construir hoy:

• Documentación Oficial: https://laravel.com/docs/12.x/mcp
• GitHub: https://github.com/laravel/mcp
• Explora la app demo Locket: https://github.com/laravel/locket

Contribuye al paquete o construye tu primer servidor MCP — el futuro del desarrollo en Laravel asistido por IA está aquí.