Next.js DevTools
Inspecione e depure aplicações Next.js via servidor MCP.
Início Rápido
# Iniciar servidor (inicia sob demanda)
bash scripts/start-server.sh
# Ou use diretamente via mcp-client
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
Ferramentas Disponíveis
| Ferramenta | Descrição |
|---|---|
list-routes | Obter todas as rotas da aplicação |
get-route-info | Detalhes de uma rota específica |
list-components | Componentes React na aplicação |
get-build-info | Configuração de build |
get-config | Configurações do next.config.js |
Padrões de Fluxo de Trabalho
Padrão 1: Inspeção de Rotas
# Listar todas as rotas
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-routes
# Obter detalhes de uma rota específica
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t get-route-info \
-p '{"route": "/api/auth"}'
Padrão 2: Depuração de Problemas de Build
# Verificar configuração de build
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
Padrão 3: Descoberta de Componentes
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t list-components
Scripts
start-server.sh
Para servidor persistente (várias chamadas):
bash scripts/start-server.sh
# Servidor executa na porta padrão
# Use mcp-client.py com a flag -u em vez de -s
On-Demand (Recomendado)
Para chamadas únicas, use a flag -s que inicia o servidor por chamada:
python3 scripts/mcp-client.py call \
-s "npx next-devtools-mcp@latest" \
-t <tool-name>
Solução de Problemas
| Problema | Solução |
|---|---|
| Servidor não inicia | Verifique se npx next-devtools-mcp@latest funciona manualmente |
| Nenhuma rota encontrada | Certifique-se de estar executando a partir da raiz do projeto Next.js |
| Informações de build vazias | Execute next build primeiro |