Communitygithub.com

Next.js DevTools

MCP를 통해 Next.js 개발 도구를 제공합니다. 라우트, 컴포넌트, 빌드 정보를 검사하고 Next.js 앱을 디버깅할 수 있습니다. Next.js 애플리케이션 작업 시, 라우팅 디버깅 또는 앱 구조 검사에 사용하세요. 일반 React 또는 비 Next.js 프로젝트에는 적합하지 않습니다.

Next.js DevTools란 무엇인가요?

이 스킬은 Next.js 개발자를 위한 MCP 서버 기반 DevTools입니다. Next.js 애플리케이션의 라우트, 컴포넌트, 빌드 구성 및 next.config.js 설정을 검사하고 디버깅할 수 있는 다양한 도구를 제공합니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트가 Next.js 프로젝트를 분석하거나 문제를 진단할 때 유용하게 사용됩니다. `list-routes`, `get-route-info`, `list-components`, `get-build-info`, `get-config` 등의 도구를 통해 앱 구조를 파악하고 빌드 문제를 신속하게 해결할 수 있습니다. 또한, 필요할 때만 서버를 실행하는 온디맨드 방식과 지속적인 서버 실행 방식을 모두 지원하여 유연하게 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/92bilal26/nextjs-devtools

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Next.js DevTools은(는) 무엇을 하나요?

MCP 서버를 통해 Next.js 애플리케이션을 검사하고 디버깅합니다.

빠른 시작

# 서버 시작 (필요 시에만 실행)
bash scripts/start-server.sh

# 또는 mcp-client를 통해 직접 사용
python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t list-routes

사용 가능한 도구

도구설명
list-routes모든 앱 라우트 가져오기
get-route-info특정 라우트의 세부 정보
list-components앱 내 React 컴포넌트 목록
get-build-info빌드 구성 확인
get-confignext.config.js 설정 확인

워크플로 패턴

패턴 1: 라우트 검사

# 모든 라우트 나열
python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t list-routes

# 특정 라우트 세부 정보 가져오기
python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t get-route-info \
  -p '{"route": "/api/auth"}'

패턴 2: 빌드 문제 디버깅

# 빌드 구성 확인
python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t get-build-info

# next.config.js 확인
python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t get-config

패턴 3: 컴포넌트 검색

python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t list-components

스크립트

start-server.sh

지속적인 서버 실행 (여러 호출):

bash scripts/start-server.sh
# 서버가 기본 포트에서 실행됩니다.
# mcp-client.py에 -s 대신 -u 플래그를 사용하세요.

온디맨드 (권장)

단일 호출의 경우 -s 플래그를 사용하면 호출마다 서버가 실행됩니다:

python3 scripts/mcp-client.py call \
  -s "npx next-devtools-mcp@latest" \
  -t <도구-이름>

문제 해결

문제해결 방법
서버가 시작되지 않음npx next-devtools-mcp@latest가 수동으로 작동하는지 확인하세요
라우트를 찾을 수 없음Next.js 프로젝트 루트에서 실행 중인지 확인하세요
빌드 정보가 비어 있음먼저 next build를 실행하세요

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬