Next.js DevTools
Inspectez et débuguez les applications Next.js via un serveur MCP.
Démarrage rapide
# Démarrer le serveur (lancé à la demande)
bash scripts/start-server.sh
# Ou utilisez directement via le client MCP
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
Outils disponibles
| Outil | Description |
|---|---|
list-routes | Obtenir toutes les routes de l'application |
get-route-info | Détails pour une route spécifique |
list-components | Composants React dans l'application |
get-build-info | Configuration de build |
get-config | Paramètres de next.config.js |
Patterns de workflow
Pattern 1 : Inspection des routes
# Lister toutes les routes
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
# Obtenir les détails d'une route spécifique
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-route-info \
-p '{"route": "/api/auth"}'
Pattern 2 : Débogage des problèmes de build
# Vérifier la configuration de build
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-build-info
# Vérifier next.config.js
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-config
Pattern 3 : Découverte des composants
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-components
Scripts
start-server.sh
Pour un serveur persistant (plusieurs appels) :
bash scripts/start-server.sh
# Le serveur tourne sur le port par défaut
# Utilisez mcp-client.py avec le flag -u au lieu de -s
À la demande (recommandé)
Pour des appels uniques, utilisez le flag -s qui lance un serveur par appel :
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t <nom-outil>
Dépannage
| Problème | Solution |
|---|---|
| Le serveur ne démarre pas | Vérifiez que npx next-devtools-mcp@latest fonctionne manuellement |
| Aucune route trouvée | Assurez-vous d'exécuter depuis la racine du projet Next.js |
| Informations de build vides | Exécutez d'abord next build |