nextscan
nextscan
一个 MCP 服务器,用于扫描 Next.js 项目并返回精简摘要。一次工具调用 → 完整项目概览。
它能做什么
未使用 nextscan | 使用 nextscan |
手动逐个文件探索 | 单次 |
多次工具调用才能理解路由 | 带标记的精简路由树 |
容易遗漏安全问题 | 硬编码密钥 + 环境变量泄漏检测 |
API 覆盖情况未知 | 每个端点的认证与校验状态 |
Schema 全靠猜测 | Prisma/Drizzle 关系映射 |
Related MCP server: guardvibe
快速安装
# 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
参数 | 类型 | 必填 | 描述 |
| string | 是 | Next.js 项目根目录的绝对路径 |
| enum | 否 |
|
示例输出
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 应用的安全性”
“显示路由结构”
“分析数据库 schema”
架构
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
Available Tools
1 toolscanA
Scan a Next.js project and return a compact summary of routes, API endpoints, schema, and security issues
Inputs: path (required), focus.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion between tools. The single tool has a clear, distinct purpose of scanning a Next.js project.
Only one tool exists, so naming is inherently consistent. The verb 'scan' clearly indicates the action.
A single tool is extremely thin for a server, suggesting the surface is severely underdeveloped. Even if the purpose is narrow, most useful servers would expose multiple operations.
The scan tool provides a comprehensive overview of a Next.js project, but it is a read-only operation. Missing other aspects like specific security fix suggestions or detailed endpoint management, leaving notable gaps for deeper workflows.
Maintenance
Related MCP Connectors
Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.
Zero-config MCP security scanner for AI-generated apps. 25K+ vulnerability patterns.
Security, SEO and AI-visibility scanner for web apps · free scans and focused checks via MCP.
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA utility tool that analyzes Next.js application routes and provides detailed information about API paths, HTTP methods, parameters, status codes, and request/response schemas.99MIT
- AlicenseBqualityBmaintenanceSecurity MCP server with 300+ rules for AI-generated code. Scans Next.js, Supabase, Clerk, Stripe, Prisma, Hono, GraphQL and 20+ modules. Zero config, runs locally.391,244 npm6Apache 2.0
- AlicenseAqualityDmaintenanceA comprehensive MCP server for frontend analysis. It provides Google Lighthouse audits, code quality checks, SEO metadata verification, accessibility analysis, and bundle optimization for React and Next.js projects.83MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to inspect Next.js codebases, analyze App Router and Pages Router structure, discover API routes, and audit build performance through controlled tools.MIT