Nextscan

io.github.berkayderinPublished by GitHub account berkayderinv1.0.1Updated Oct 24, 2026

MCP server that scans Next.js projects and returns a compact summary

VerifiedSTDIODesktop onlyDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

Local MCP server that scans a Next.js project and returns one compact summary of its routes, API endpoints, ORM schema and security issues.

What you can do
  • Scan a Next.js project root and get a single compact overview
  • Inspect the route tree with page, layout, API, dynamic, static, client and server flags
  • Review API endpoints with auth and validation status per endpoint
  • Map Prisma or Drizzle models and relations, including orphan models
  • Check security findings such as hardcoded secrets, env leaks, missing auth and missing rate limiting
  • Narrow the scan to routes, api, schema or security with a focus parameter
When to use it
Useful when an assistant needs to understand an unfamiliar Next.js codebase quickly, or when you want a fast structural and security review of routes, API endpoints and database schema without file-by-file exploration.
Requirements
Runs as a local stdio process installed from the npm package; needs Node.js 18+ and an MCP-compatible client. The scan tool requires an absolute path to the Next.js project root. No authentication, environment variables or headers are declared.
Before you install
The scan reads project files on the local machine, including source that may contain hardcoded secrets; results are returned to the assistant and its model provider. It is read-only analysis, but review what the client logs or sends onward.

Installation

In SourceWeft

  1. Open Nextscan in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

nextscan

MCP server that scans Next.js projects and returns a compact summary. One tool call → full project overview.

What it does

Without nextscanWith nextscan
Manual file-by-file explorationSingle scan call
Multiple tool calls to understand routesCompact route tree with flags
Missing security issuesHardcoded secrets + env leak detection
Unknown API coverageAuth + validation status per endpoint
Schema guessworkPrisma/Drizzle relation mapping

Quick Install

bash
# Clone and buildcd nextscannpm installnpm run build
# Add to Claude Codeclaude mcp add nextscan -- node /path/to/nextscan/dist/index.js

Tool: scan

ParameterTypeRequiredDescription
pathstringYesAbsolute path to Next.js project root
focusenumNoroutes | api | schema | security

Example Output

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

Example Prompts

  • "Scan my Next.js project at /Users/dev/my-app"
  • "Check the security of my Next.js app"
  • "Show me the route structure"
  • "Analyze the database schema"

Architecture

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

Requirements

  • Node.js 18+
  • An MCP-compatible client (Claude Code, Claude Desktop, etc.)

Development

bash
npm installnpm run buildnpm testnpm run test:coverage

Author

Berkay Derin — github.com/berkayderin

License

MIT

Source: README.md at commit 04953fb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts