Nextscan

nextscan

Next.js プロジェクトをスキャンし、簡潔な概要を返す MCP サーバーです。ツールを1回呼び出すだけで、プロジェクト全体を把握できます。

できること

nextscan を使わない場合	nextscan を使う場合
ファイルを1つずつ手動で調査	scan を1回呼び出すだけ
ルートの把握に複数のツール呼び出しが必要	フラグ付きの簡潔なルートツリー
セキュリティ上の問題を見落とす	ハードコードされたシークレットと環境変数の漏えいを検出
API のカバレッジが不明	エンドポイントごとの認証と検証の状態
スキーマの推測が必要	Prisma／Drizzle のリレーションをマッピング

クイックインストール

# Clone and build
cd nextscan
npm install
npm run build

# Add to Claude Code
claude mcp add nextscan -- node /path/to/nextscan/dist/index.js

ツール：scan

パラメーター	型	必須	説明
path	string	はい	Next.js プロジェクトルートの絶対パス
focus	enum	いいえ	routes | api | schema | security

出力例

nextscan — my-app
────────────────────────────────────────
Root: /Users/dev/my-app
   src/ : yes  app/ : yes  middleware: yes
   ORM  : prisma

Routes
   Pages: 12  Layouts: 3  API: 5
   Dynamic: 4  Static: 8
   Client: 3  Server: 9
   Groups: (marketing), (auth)
   Matchers: /dashboard/:path*, /api/:path*
   ┌─ Pages
   ├─ /
   ├─ /about
   ├─ /dashboard [client]
   ├─ /blog/[slug] [dyn,SSG]
   └─ /settings [client]

API Endpoints
   Total: 5  Unprotected: 1
   ├─ GET,POST /api/users [auth:next-auth | val:zod]
   ├─ GET /api/health [no-auth,no-rate-limit]
   └─ POST /api/webhook [no-auth,no-validation]

Schema
   Models: 5  Relations: 4
   Orphans: AuditLog
   User ─< Post (1:N)
   User ─ Profile (1:1)
   Post >─< Tag (N:N)

Security
   Score: 75/100  Headers: yes  Middleware: yes
   [high] API route /api/health has no auth: [GET]
   [medium] No rate limiting on /api/users

プロンプトの例

• 「/Users/dev/my-app にある Next.js プロジェクトをスキャンしてください」
• 「Next.js アプリのセキュリティを確認してください」
• 「ルート構造を表示してください」
• 「データベーススキーマを分析してください」

アーキテクチャ

src/
├── index.ts              # MCP server entry point
├── tools/scan.ts         # Orchestrator
├── analyzers/
│   ├── routes.ts         # App router analysis
│   ├── api.ts            # API endpoint analysis
│   ├── schema.ts         # Schema orchestration
│   └── security.ts       # Security scanning
├── parsers/
│   ├── typescript.ts     # ts-morph utilities
│   ├── prisma.ts         # Regex-based Prisma parser
│   └── drizzle.ts        # AST-based Drizzle parser
├── formatters/
│   └── compact.ts        # Unicode tree formatter
└── utils/
    ├── fs.ts             # File system utilities
    └── detect.ts         # Project detection

要件

• Node.js 18+
• MCP 互換のクライアント（Claude Code、Claude Desktop など）

開発

npm install
npm run build
npm test
npm run test:coverage

作者

Berkay Derin — github.com/berkayderin

ライセンス

MIT