Was macht Next.js DevTools?
Inspektiere und debugge Next.js-Anwendungen über einen MCP-Server.
Schnellstart
# Server starten (nach Bedarf spawnen)
bash scripts/start-server.sh
# Oder direkt über den mcp-client verwenden
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
Verfügbare Werkzeuge
| Tool | Beschreibung |
|---|---|
list-routes | Alle App-Routen auflisten |
get-route-info | Details zu einer bestimmten Route abrufen |
list-components | React-Komponenten in der App anzeigen |
get-build-info | Build-Konfiguration anzeigen |
get-config | next.config.js-Einstellungen abrufen |
Workflow-Muster
Muster 1: Routeninspektion
# Alle Routen auflisten
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
# Details einer bestimmten Route abrufen
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-route-info \
-p '{"route": "/api/auth"}'
Muster 2: Build-Probleme debuggen
# Build-Konfiguration prüfen
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-build-info
# next.config.js prüfen
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-config
Muster 3: Komponenten entdecken
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-components
Skripte
start-server.sh
Für einen persistenten Server (mehrere Aufrufe):
bash scripts/start-server.sh
# Der Server läuft auf dem Standard-Port
# Verwende mcp-client.py mit -u-Flag anstelle von -s
Auf Abruf (empfohlen)
Für einzelne Aufrufe das -s-Flag verwenden, das den Server pro Aufruf startet:
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t <tool-name>
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Server startet nicht | Überprüfe, ob npx next-devtools-mcp@latest manuell funktioniert |
| Keine Routen gefunden | Stelle sicher, dass du vom Next.js-Projektstammverzeichnis aus ausführst |
| Build-Info leer | Führe zuerst next build aus |