Configuración de Laravel Boost MCP en Mac: La Guía Completa de Desarrollo con IA

Introducción

Imagina reducir tu tiempo de desarrollo en Laravel a la mitad mientras escribes código más limpio y confiable. Para muchos desarrolladores, programar puede sentirse como un ciclo de configuraciones repetitivas, cacería de bugs y tareas monótonas. Pero, ¿y si tuvieras un asistente impulsado por IA que entienda el contexto de tu proyecto Laravel y ofrezca sugerencias significativas y listas para producción, directamente en tu IDE?

Eso es exactamente lo que Laravel Boost con MCP (Model Context Protocol) ofrece. Al integrar Boost en tu proyecto Laravel en Mac, desbloqueas un flujo de trabajo de desarrollo impulsado por la conciencia contextual de la IA, haciendo tu programación más inteligente, rápida y eficiente.

En esta guía, aprenderás cómo configurar Laravel Boost MCP en Mac paso a paso, por qué es importante y cómo aprovecharlo para potenciar tus proyectos Laravel con IA.

¿Qué es Laravel Boost MCP?

Laravel Boost es un toolkit de desarrollo asistido por IA que se integra con MCP (Model Context Protocol). MCP actúa como el "puente" entre tu código base y modelos de IA como Claude u OpenAI. En lugar de recibir sugerencias vagas de IA, MCP proporciona respuestas precisas y ricas en contexto adaptadas a tu aplicación Laravel.

Piensa en MCP como un traductor: alimenta a la IA con el contexto exacto de Laravel (rutas, migraciones, modelos, configuraciones) para que cuando hagas una pregunta como "¿Cómo consulto los usuarios activos?", responda con código específico de Laravel alineado con tu proyecto real.

Por qué Importa el Desarrollo Asistido por IA

• Velocidad: Automatiza codificación repetitiva, configuración y corrección de bugs.
• Precisión: Las sugerencias de IA respetan las convenciones de Laravel y el contexto del proyecto.
• Aprendizaje: Incluso los desarrolladores junior pueden construir como profesionales con guía de IA.
• Productividad: Libera espacio mental para resolver lógica de negocio real.

Requisitos Previos para la Configuración

Antes de comenzar, asegúrate de que tu entorno Mac esté listo:

• macOS Ventura o posterior
• PHP 8.2+ instalado (Herd o Brew recomendado)
• Composer instalado globalmente
• Node.js 18 o posterior
• Un proyecto Laravel funcional
• IDE (PhpStorm, VSCode o Cursor recomendado)

Paso 1: Instalar Laravel Boost

Primero, incorpora Boost en tu proyecto Laravel con Composer:

composer require laravel/boost --dev
php artisan boost:install

Esto configura el servidor MCP de Boost dentro de tu aplicación Laravel.

Paso 2: Configurar MCP en tu IDE

Laravel Boost se conecta a los IDEs a través de la configuración MCP. Los editores soportados incluyen:

• PhpStorm
• VSCode
• Cursor
• Claude Code

Una vez instalado Boost, agrega los detalles del servidor MCP en .mcp.json:

{
  "mcpServers": {
    "laravel-boost": {
      "command": "/Users/yourname/Library/Application Support/Herd/bin/php83",
      "args": [
        "/Users/yourname/your-project/artisan",
        "boost:mcp"
      ]
    }
  }
}

Esto le dice a tu IDE cómo ejecutar Boost y conectar modelos de IA.

Paso 3: Agregar tus Directrices de IA

Laravel Boost brilla cuando defines directrices de IA adaptadas a tu proyecto. Crea una carpeta llamada .ai/guidelines/ en la raíz de tu proyecto:

mkdir -p .ai/guidelines

Dentro, agrega archivos de directrices:

touch .ai/guidelines/purpose.blade.php

Aquí puedes instruir a la IA:

• Qué hace tu aplicación
• Preferencias de estilo de código
• Reglas de seguridad (p.ej., nunca exponer valores de env)

Ejemplo de fragmento de directriz:

{{-- Purpose: Guide AI for this Laravel CRM project --}}
{{-- Rule 1: Use Eloquent for database queries --}}
{{-- Rule 2: Follow PSR-12 coding standards --}}
{{-- Rule 3: Never expose sensitive .env keys --}}

Paso 4: Iniciar y Verificar

Ejecuta:

claude

O usa la integración MCP de tu IDE. Si es exitoso, verás Boost conectado:

Laravel-boost -> database-query (MCP)

Ahora puedes preguntar:

"¿Cuántos usuarios hay en mi base de datos?"

Y Boost ejecutará una consulta SQL real, devolviendo el número exacto.

Ejemplo del Mundo Real

Sin Boost: Abrirías phpMyAdmin, escribirías una consulta o revisarías tu seeder.

Con Boost: Simplemente escribes:

¿Cuántos usuarios están activos este mes?

Y la IA responde con tanto la consulta como el resultado.

Beneficios de Laravel Boost en Mac

• Rendimiento nativo: Herd hace PHP ultrarrápido.
• IA en la terminal: Haz preguntas sobre el proyecto directamente.
• Potencia cross-IDE: Úsalo en PhpStorm, VSCode o Cursor.
• IA personalizable: Adapta directrices a los estándares de codificación de tu equipo.

Comparación: Con vs Sin Boost

Problemas Comunes y Soluciones

• Error: MCP no encontrado → Asegúrate de que .mcp.json apunte a la ruta PHP correcta.

• Claude no responde → Agrega fondos a la cuenta de Anthropic o configura la clave de OpenAI.

• Las reglas personalizadas de IA no funcionan → Verifica la estructura de la carpeta .ai/guidelines/.

Puntos Clave / Resumen Rápido

• Laravel Boost + MCP = IA que entiende tu proyecto.
• Funciona perfectamente en Mac con Herd, Composer y Node.js.
• Configura .mcp.json para vincular Laravel con tu IDE.
• Agrega .ai/guidelines/ para personalizar las respuestas de IA.
• Potencia la productividad automatizando tareas repetitivas.

Llamada a la Acción (CTA)

¿Listo para desbloquear el desarrollo Laravel impulsado por IA? Configura Laravel Boost MCP en tu Mac hoy y experimenta una programación más inteligente. Comparte esta guía con tu equipo para preparar tu flujo de trabajo para el futuro.

Opcional: Sección de Preguntas Frecuentes

P: ¿Puedo usar OpenAI en lugar de Claude? Sí. Laravel Boost funciona con cualquier IA compatible con MCP, incluyendo los modelos GPT de OpenAI.

P: ¿Es Laravel Boost gratuito? Boost en sí es gratuito, pero necesitarás créditos de API de Claude, OpenAI u otro proveedor compatible con MCP.

P: ¿Necesito PhpStorm? No, Boost también funciona con VSCode, Cursor y Claude Code.

P: ¿Puede Boost ejecutar consultas en mi base de datos de producción? Sí, pero debes configurar cuidadosamente los permisos y evitar comandos destructivos.