Skip to main content
Glama

nextscan

一个 MCP 服务器,用于扫描 Next.js 项目并返回精简摘要。一次工具调用 → 完整项目概览。

它能做什么

未使用 nextscan

使用 nextscan

手动逐个文件探索

单次 scan 调用

多次工具调用才能理解路由

带标记的精简路由树

容易遗漏安全问题

硬编码密钥 + 环境变量泄漏检测

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

参数

类型

必填

描述

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 应用的安全性”

  • “显示路由结构”

  • “分析数据库 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 tool
scanA

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

    A3.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Only one tool exists, so naming is inherently consistent. The verb 'scan' clearly indicates the action.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A utility tool that analyzes Next.js application routes and provides detailed information about API paths, HTTP methods, parameters, status codes, and request/response schemas.
      99
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Security 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.
      39
      1,244 npm
      6
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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