Next.js DevTools MCP: Zuerst einen lokalen 16+-Dev-Server entdecken

Für wen

Für alle, die bereits einen Next.js-16+-Entwicklungsserver laufen haben und einen Coding-Agenten (Evidenzbeispiele Claude und Cursor) Live-Laufzeitfehler, Routen und Logs sehen lassen wollen. Die Evidenz besagt: next-devtools-mcp ist ein dünner Konnektor; er entdeckt lokale Next.js-16+-Dev-Server und proxied deren eingebauten MCP-Endpunkt /_next/mcp.

Sie müssen bereits Node.js v20.19 oder ein neueres LTS sowie npm oder pnpm haben. nextjs_index / nextjs_call verlangen außerdem, dass der Entwicklungsserver läuft. Ohne laufenden Next-16+-Prozess keine Laufzeit-Tools erwarten.

Docs und Migrations-Workflows leben nicht mehr in diesem Server: Docs unter node_modules/next/dist/docs/; Upgrade / Cache Components werden als agent skills verteilt.

Ersten Versuch in 3 Minuten abschließen

Folgen Sie dem Installationsbefehl der Seite (nehmen Sie das manuelle JSON nicht gleichzeitig als zweiten Hauptpfad):

npx add-mcp next-devtools-mcp@latest

-y überspringt die Abfrage und installiert auf alle erkannten Agenten; -g installiert projektübergreifend global. Die gleichwertige Client-Konfiguration ist npx -y next-devtools-mcp@latest, nur zum Vergleich; der erste Versuch folgt add-mcp.

Voraussetzungen: Sie haben lokal ein Next.js-16+-Projekt, und next dev läuft bereits. Dies entdeckt den lokalen Entwicklungsserver und liest Laufzeitinformationen; keine Sandbox ohne Netz und ohne lokales Projekt.

Konfigurationsort: add-mcp schreibt in erkannte MCP-Clients; oder manuell unter mcpServers.next-devtools des Clients.

Risikoarmer erster Aufruf: zuerst nextjs_index aufrufen, laufende Dev-Server entdecken und deren Laufzeit-MCP-Tools listen. Nicht zuerst nextjs_call, um Server Actions auszulösen. nextjs_docs und browser_eval sind Gateways, keine arbeitenden Worker.

Erfolgssignal: nextjs_index listet mindestens einen laufenden Next.js-16+-Server und seine Laufzeit-Tools. Ist die Liste leer, zuerst den Dev-Server starten; nicht zur Browserautomatisierung wechseln.

Anwendungsfälle

Fall 1: Prüfen, ob der Agent den aktuellen Dev-Server sieht. nextjs_index aufrufen. Die Evidenz garantiert, dass laufende Server entdeckt und deren Laufzeit-MCP-Tools gelistet werden; kein Portscan-Bereich und keine Mehrprojekt-Parameter. Bestätigen können Sie: Sie sehen die gerade entdeckten Server.

Fall 2: Fehler, Routen oder Logs eines bereits entdeckten Servers lesen. Nach nextjs_index nextjs_call aufrufen. Die Evidenz nennt aufrufbare Laufzeitfähigkeiten errors, routes, logs, Server Actions. Die ersten drei sind beobachtend; Server Actions können den Anwendungszustand ändern. Beim ersten Mal nur errors/routes/logs; Server Actions nicht zuerst. nextjs_docs zeigt den Agenten nur auf die versionsgenaue node_modules/next/dist/docs/.

Nutzungsgrenzen

Dies ist ein Proxy, keine vollständige Next-Doc-Site und kein Browserautomatisierungs-Körper. browser_eval zeigt nur auf die agent-browser-CLI. Docs und Migration leben nicht mehr hier. Laufzeit-Tools brauchen Next.js 16+ und einen laufenden Dev-Server. Die Evidenz schreibt keine nextjs_call-Parameterfelder und hat keinen Undo-Pfad für Server Actions. Eine nur lesende Log-Abfrage und das Auslösen von Server Actions sind nicht dasselbe Risiko.