Laravel Codebase Introspection

Servidor MCP para Inteligencia e Introspección de Codebases Laravel

Para que las IAs puedan dar sentido a tu codebase, necesitan poder saber qué contiene. Si bien la búsqueda vectorial es una herramienta poderosa para buscar en el código, utiliza muchos tokens y ni siquiera te da la imagen completa de tu codebase para cosas como vistas o rutas. Este paquete implementa un servidor Model Context Protocol (MCP) para el paquete mateffy/laravel-introspect, que te permite inspeccionar tu codebase y obtener información estructurada sobre él.

• 🔍 Permite que la IA consulte vistas, rutas, clases y modelos sin necesidad de leer todo el código
• 🔍 Incluso puede usar comodines (*) para coincidir con múltiples vistas, rutas, clases y modelos
• 🔍 Admite consultas para elementos de paquetes de Laravel, algo que la mayoría de los buscadores de archivos no pueden hacer
• 🪄 Le da a tu IA descripciones rápidas de tu modelo de datos y sus relaciones
• 🤖 Compatible con cualquier agente de IA que implemente el protocolo MCP

Consulta	Filtros disponibles
Vistas	nombre, ruta, usada por vista, usa vista, extiende
Rutas	nombre, URI, controlador + función, métodos, middleware
Clases	nombre / espacio de nombres, extiende padre, implementa interfaces, usa traits
⤷ Modelos	... relaciones, propiedades, casts, fillable, hidden, lectura/escritura
⤷ Comandos	... firma, descripción (próximamente)

El nombre y algunas otras consultas incluso admiten consultas con comodines (p. ej. components.*.paragraph)

¿Para quién es esto?

Si usas herramientas de IA como Aider, Cursor, Windsurf o Claude Code para ayudarte a construir tu aplicación, este paquete es para ti. Simplemente configura el servidor MCP en tu agente y podrá consultar automáticamente tu codebase para buscar vistas, rutas, clases y modelos.

Esto es especialmente útil para codebases grandes donde simplemente buscar en el código es menos práctico.

Ejemplos de tareas

• Dale a tu IA una descripción general de tu modelo de datos y sus relaciones
• Refactorizar vistas y asegurarte de que no se usen en ningún otro lugar
• Encontrar todas las rutas que usan un controlador específico
• Encontrar modelos que usan un trait o interfaz específico
• Asegurarte de que todas las rutas usen el middleware correcto

laravel-codebase-mcp vs. laravel-introspect

El servidor MCP usa el paquete laravel-introspect para inspeccionar tu codebase y obtener información estructurada sobre él. Si quieres escribir pruebas o ejecutar las mismas consultas varias veces, también puedes usar el paquete directamente.

Instalación

Instala el paquete mediante composer:

composer require mateffy/laravel-codebase-mcp --dev

[!NOTE]

Por el momento, hay un problema de dependencia con php-mcp/server (#23) y ReactPHP (#542). Es posible que necesites usar temporalmente estos forks parcheados si encuentras problemas al instalar laravel-codebase-mcp agregando lo siguiente a tu composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/leantime/php-mcp-server.git"
    },
    {
      "type": "vcs",
      "url": "https://github.com/Leantime/reactphp-http.git"
    }
  ]
}

Y luego agrégalo a la configuración MCP de tu agente de IA:

{
  "mcpServers": {
    "laravel-introspect": {
      "command": "php",
      "args": [
        "/path/to/your/codebase/artisan",
        "introspect:mcp"
      ]
    }
  }
}

[!IMPORTANT]
El servidor MCP aún está en beta, ¡probablemente habrá errores!

Consultas disponibles

Si quieres ver todas las consultas disponibles, consulta la documentación del paquete laravel-introspect.

Agradecimientos

El servidor MCP usa el paquete php-mcp/server para implementar el protocolo MCP.

Licencia

La Licencia MIT (MIT). Consulta el Archivo de Licencia para más información.