descubrimiento-de-plugins-laravel

Descubrimiento de Plugins de Laravel

Encuentra, evalúa y elige paquetes saludables de Laravel usando el servidor MCP de LaraPlugins.io.

Cuándo Usarlo

• El usuario quiere encontrar paquetes de Laravel para una funcionalidad específica (ej. "auth", "permisos", "panel de administración")
• El usuario pregunta "¿qué paquete debería usar para..." o "¿hay un paquete de Laravel para..."
• El usuario quiere verificar si un paquete tiene mantenimiento activo
• El usuario necesita verificar la compatibilidad con una versión de Laravel
• El usuario quiere evaluar la salud de un paquete antes de agregarlo a un proyecto

Requisito MCP

El servidor MCP de LaraPlugins debe estar configurado. Agrega a tu ~/.claude.json en mcpServers:

"laraplugins": {
  "type": "http",
  "url": "https://laraplugins.io/mcp/plugins"
}

No se requiere clave API: el servidor es gratuito para la comunidad de Laravel.

Herramientas MCP

El MCP de LaraPlugins proporciona dos herramientas principales:

SearchPluginTool

Busca paquetes por palabra clave, puntuación de salud, vendedor y compatibilidad de versiones.

Parámetros:

• text_search (cadena, opcional): Palabra clave a buscar (ej. "permission", "admin", "api")
• health_score (cadena, opcional): Filtrar por banda de salud — Healthy, Medium, Unhealthy o Unrated
• laravel_compatibility (cadena, opcional): Filtrar por versión de Laravel — "5", "6", "7", "8", "9", "10", "11", "12", "13"
• php_compatibility (cadena, opcional): Filtrar por versión de PHP — "7.4", "8.0", "8.1", "8.2", "8.3", "8.4", "8.5"
• vendor_filter (cadena, opcional): Filtrar por nombre de vendedor (ej. "spatie", "laravel")
• page (número, opcional): Número de página para paginación

GetPluginDetailsTool

Obtiene métricas detalladas, contenido del README e historial de versiones para un paquete específico.

Parámetros:

• package (cadena, requerido): Nombre completo del paquete de Composer (ej. "spatie/laravel-permission")
• include_versions (booleano, opcional): Incluir historial de versiones en la respuesta

---

Cómo Funciona

Encontrar Paquetes

Cuando el usuario quiere descubrir paquetes para una funcionalidad:

1. Usa SearchPluginTool con palabras clave relevantes
2. Aplica filtros por puntuación de salud, versión de Laravel o versión de PHP
3. Revisa los resultados con nombres de paquetes, descripciones e indicadores de salud

Evaluar Paquetes

Cuando el usuario quiere evaluar un paquete específico:

1. Usa GetPluginDetailsTool con el nombre del paquete
2. Revisa la puntuación de salud, la fecha de la última actualización y la compatibilidad con versiones de Laravel
3. Verifica la reputación del vendedor y los indicadores de riesgo

Verificar Compatibilidad

Cuando el usuario necesita compatibilidad con versiones de Laravel o PHP:

1. Busca con el filtro laravel_compatibility ajustado a su versión
2. O obtén detalles de un paquete específico para ver sus versiones compatibles

---

Ejemplos

Ejemplo: Encontrar Paquetes de Autenticación

SearchPluginTool({
  text_search: "authentication",
  health_score: "Healthy"
})

Devuelve paquetes que coinciden con "authentication" con estado saludable:

• spatie/laravel-permission
• laravel/breeze
• laravel/passport
• etc.

Ejemplo: Encontrar Paquetes Compatibles con Laravel 12

SearchPluginTool({
  text_search: "admin panel",
  laravel_compatibility: "12"
})

Devuelve paquetes compatibles con Laravel 12.

Ejemplo: Obtener Detalles de un Paquete

GetPluginDetailsTool({
  package: "spatie/laravel-permission",
  include_versions: true
})

Devuelve:

• Puntuación de salud y última actividad
• Compatibilidad con versiones de Laravel/PHP
• Reputación del vendedor (puntuación de riesgo)
• Historial de versiones
• Breve descripción

Ejemplo: Encontrar Paquetes por Vendedor

SearchPluginTool({
  vendor_filter: "spatie",
  health_score: "Healthy"
})

Devuelve todos los paquetes saludables del vendedor "spatie".

---

Mejores Prácticas de Filtrado

Por Puntuación de Salud

Banda de Salud	Significado
Healthy	Mantenimiento activo, actualizaciones recientes
Medium	Actualizaciones ocasionales, puede requerir atención
Unhealthy	Abandonado o con mantenimiento poco frecuente
Unrated	Aún no evaluado

Recomendación: Prefiere paquetes Healthy para aplicaciones en producción.

Por Versión de Laravel

Versión	Notas
13	Última versión de Laravel
12	Estable actual
11	Todavía ampliamente usada
10	Heredada pero común
5-9	Obsoletas

Recomendación: Coincide con la versión de Laravel del proyecto objetivo.

Combinando Filtros

// Encontrar paquetes saludables, compatibles con Laravel 12 para permisos
SearchPluginTool({
  text_search: "permission",
  health_score: "Healthy",
  laravel_compatibility: "12"
})

---

Interpretación de Respuestas

Resultados de Búsqueda

Cada resultado incluye:

• Nombre del paquete (ej. spatie/laravel-permission)
• Breve descripción
• Indicador de estado de salud
• Insignias de compatibilidad con versiones de Laravel

Detalles del Paquete

La respuesta detallada incluye:

• Puntuación de Salud: Indicador numérico o por banda
• Última Actividad: Cuándo se actualizó por última vez el paquete
• Soporte de Laravel: Matriz de compatibilidad de versiones
• Soporte de PHP: Compatibilidad con versiones de PHP
• Puntuación de Riesgo: Indicadores de confianza del vendedor
• Historial de Versiones: Línea de tiempo de lanzamientos recientes

---

Casos de Uso Comunes

Escenario	Enfoque Recomendado
"¿Qué paquete para autenticación?"	Buscar "auth" con filtro de salud
"¿Spatie/package sigue mantenido?"	Obtener detalles, verificar puntuación de salud
"Necesito paquetes para Laravel 12"	Buscar con laravel_compatibility: "12"
"Encontrar paquetes de panel de administración"	Buscar "admin panel", revisar resultados
"Verificar reputación de vendedor"	Buscar por vendedor, revisar detalles

---

Mejores Prácticas

1. Filtrar siempre por salud — Usa health_score: "Healthy" para proyectos en producción
2. Coincidir con la versión de Laravel — Verifica siempre que laravel_compatibility coincida con el proyecto objetivo
3. Verificar reputación del vendedor — Prefiere paquetes de vendedores conocidos (spatie, laravel, etc.)
4. Revisar antes de recomendar — Usa GetPluginDetailsTool para una evaluación completa
5. No se necesita clave API — El MCP es gratuito, no requiere autenticación

---

Habilidades Relacionadas

• laravel-patterns — Arquitectura y patrones de Laravel
• laravel-tdd — Desarrollo guiado por pruebas para Laravel
• laravel-security — Mejores prácticas de seguridad en Laravel
• documentation-lookup — Consulta general de documentación de librerías (Context7)