Next.js MCP Server

专为Next.js应用设计的API路由信息提取与分析工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Next.js MCP Server。
它的用途是:专为Next.js应用设计的API路由信息提取与分析工具
完整的 Skill 内容见:https://321skill.com/skills/next-js-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我分析当前Next.js项目`/src/app`目录下的所有API路由结构。” 它会调用该Skill,扫描指定目录,生成一份包含所有API路由路径、支持的HTTP方法(GET、POST等)、路径参数以及所在文件位置的详细报告,帮助你快速了解项目后端接口的全貌。

介绍

这个Skill主要解决开发者在维护或分析Next.js应用时,难以快速、清晰地掌握项目中所有API路由(包括App Router和Pages Router)的完整结构、参数、方法等信息的痛点。它通过静态分析项目源代码,自动提取并整理API路由的详细信息。

使用时,开发者只需将Skill指向其Next.js项目目录,它便能自动扫描并生成一份结构化的API路由报告。报告内容包括路由路径、支持的HTTP方法、动态参数、中间件使用情况等,帮助开发者一目了然地理解API架构。

该Skill非常适合负责Next.js应用开发、维护或进行架构审查的工程师。无论是接手一个遗留项目,还是需要为自己的项目编写技术文档,或是进行代码审计,它都能提供关键的路由层信息。

建议在项目开发中期或重构前使用,以建立对API边界的清晰认知。注意,它主要基于静态代码分析,对于运行时动态生成的路由可能无法完全捕获,分析前请确保项目依赖已正确安装。

核心特点

与通用的代码结构分析工具不同,它深度集成Next.js框架特性,能精准识别App Router和Pages Router两种模式下的API路由定义,并提供针对Next.js API约定的结构化输出(如路由处理器、动态分段等),而非泛泛的代码扫描。

注意事项

不适合分析非Next.js项目或主要依赖运行时动态生成API路由的应用。

常见问题

这个工具能分析使用App Router和Pages Router混合的项目吗?

可以,它能同时识别并分析Next.js项目中App Router和Pages Router两种模式下的API路由。

分析结果包含API路由的内部逻辑代码吗?

不包含,它主要提取路由的元数据信息(如路径、方法、参数),不会深入分析每个路由处理函数的具体业务逻辑。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/next-js-mcp-server/raw/index.md 读取 Next.js MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。