Next.js DevTools
Inspecciona y depura aplicaciones Next.js a través del servidor MCP.
Inicio Rápido
# Iniciar servidor (se genera bajo demanda)
bash scripts/start-server.sh
# O usar directamente a través de mcp-client
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
Herramientas Disponibles
| Herramienta | Descripción |
|---|---|
list-routes | Obtener todas las rutas de la aplicación |
get-route-info | Detalles de una ruta específica |
list-components | Componentes React en la aplicación |
get-build-info | Configuración de compilación |
get-config | Ajustes de next.config.js |
Patrones de Flujo de Trabajo
Patrón 1: Inspección de Rutas
# Listar todas las rutas
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
# Obtener detalles de una ruta específica
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-route-info \
-p '{"route": "/api/auth"}'
Patrón 2: Depurar Problemas de Compilación
# Verificar configuración de compilación
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-build-info
# Verificar next.config.js
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-config
Patrón 3: Descubrimiento de Componentes
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-components
Scripts
start-server.sh
Para servidor persistente (múltiples llamadas):
bash scripts/start-server.sh
# El servidor se ejecuta en el puerto predeterminado
# Usa mcp-client.py con la bandera -u en lugar de -s
Bajo Demanda (Recomendado)
Para llamadas individuales, usa la bandera -s que genera el servidor por cada llamada:
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t <nombre-herramienta>
Solución de Problemas
| Problema | Solución |
|---|---|
| El servidor no inicia | Verifica que npx next-devtools-mcp@latest funcione manualmente |
| No se encuentran rutas | Asegúrate de ejecutar desde la raíz del proyecto Next.js |
| Información de compilación vacía | Ejecuta next build primero |