适合谁
- 使用 Next.js 16+ 并希望让编码代理直接读取实时开发服务器状态的前端开发者
- 使用 Claude Code、Cursor、Codex 等支持 MCP 的代理工作流的团队
- 需要版本准确文档而不是联网抓取文档的 Next.js 项目
N
63FMRS · C
这是 Vercel 官方维护的 Next.js DevTools MCP 服务器（MIT 许可，0.4.0 版本）。作为轻量连接器，它自动发现 Next.js 16+ 开发服务器并代理其内置 /_next/mcp 端点，让编码代理获取实时错误、路由与日志，同时通过网关工具指向版本准确文档与 agent-browser CLI。适合使用 Next.js 16+ 且依赖 MCP 编码代理的开发者；不适合非 Next.js 或低于 16 的项目，也不适合期望服务器直接抓取文档或驱动浏览器的用户。需注意默认开启的匿名遥测与 60 秒上游请求超时。
next-devtools-mcp 是 Vercel 维护的 Model Context Protocol (MCP) 服务器，将 Claude、Cursor 等编码代理连接到你正在运行的 Next.js 开发服务器。它是一个轻量连接器：自动发现运行中的 Next.js 16+ 开发服务器，并代理其内置的 MCP 端点 /_next/mcp，让代理获取实时运行时错误、路由和日志。它还提供两个网关工具，把代理指向它们自行运行的工具：版本准确的文档和 agent-browser CLI。0.4.0 起，文档与迁移工作流不再包含在此服务器中，Next.js 自带文档位于 node_modules/next/dist/docs/，升级与 Cache Components 工作流以 agent skills 形式分发。
工具能力
nextjs_index
发现运行中的 Next.js 开发服务器，并列出各服务器的运行时 MCP 工具。
nextjs_call
在已发现的服务器上调用运行时工具（错误、路由、日志、Server Actions）。
nextjs_docs
网关工具。将代理指向 node_modules/next/dist/docs/ 中版本准确的文档。
browser_eval
网关工具。将代理指向 agent-browser CLI 以进行浏览器自动化。
安装接入
- 确认环境满足要求：Node.js v20.19 或更新的 LTS 版本，npm 或 pnpm。
- 使用 add-mcp 为所有编码代理安装：npx add-mcp next-devtools-mcp@latest（加 -y 跳过提示并安装到所有检测到的代理，加 -g 全局安装）。
- 或在 MCP 客户端手动添加配置：{"mcpServers":{"next-devtools":{"command":"npx","args":["-y","next-devtools-mcp@latest"]}}}。
- 各客户端也可用命令安装，例如 Claude Code：claude mcp add next-devtools npx next-devtools-mcp@latest；Cursor 可用一键安装链接或在 Settings → MCP → New MCP Server 中添加。
- 启动 Next.js 开发服务器：npm run dev。Next.js 16+ 默认在 http://localhost:3000/_next/mcp 启用 MCP 端点，服务器会自动发现并连接，无需额外配置。
claude_desktop_config.json
{"mcpServers":{"next-devtools":{"command":"npx","args":["-y","next-devtools-mcp@latest"]}}}
选型与风险
不适合谁
- 未使用 Next.js 或版本低于 16 的项目（nextjs_index / nextjs_call 需要 Next.js 16+ 运行中的开发服务器）
- 期望该服务器自行抓取文档或直接驱动浏览器的用户（nextjs_docs 与 browser_eval 只是网关，不执行实际工作）
- 需要非 stdio 传输方式（如远程 HTTP）的部署场景
所需权限
- 本地读取项目中的 next/package.json 以定位已安装的 Next.js 版本与文档路径
- 通过网络访问本地开发服务器端口（如 localhost:3000）以发现并调用 /_next/mcp 端点
- 在 ~/.next-devtools-mcp/ 下写入本地文件（telemetry-id、telemetry-salt 与调试日志 mcp.log）
- browser_eval 可能提示安装全局 CLI：npm install -g agent-browser
风险与副作用
- 默认收集匿名使用遥测（工具名、匿名错误信息、会话 ID、时间戳、操作系统与 Node.js 版本等基础环境信息）；不收集代码、文件内容或路径、个人数据、凭证或工具参数。可通过 export NEXT_TELEMETRY_DISABLED=1 关闭，或用 rm -rf ~/.next-devtools-mcp 删除本地遥测数据。
- 运行时工具调用的上游请求（包括响应体读取）有 60 秒超时限制。
- nextjs_docs 在已安装版本未附带文档时会回退到 https://nextjs.org/docs，并提示代理对照已安装版本验证 API。
- 使用 next-devtools-mcp@latest 会让客户端始终使用最新版本，可能引入非预期变更。
常见排障
- 出现 ERR_MODULE_NOT_FOUND 并引用 next-devtools-mcp/dist：清除 npx 缓存并重启 MCP 客户端，服务器会重新安装。
- 出现 [error] No server info found：nextjs_index / nextjs_call 需要运行中的 Next.js 16+ 开发服务器，请运行 npm run dev、确认版本为 16+（/_next/mcp 端点仅在该版本存在）并确认启动无错误。
- browser_eval 与 nextjs_docs 无需开发服务器即可使用。
- Windows 11 上使用 Codex 时，可在 .codex/config.toml 中添加环境变量（SystemRoot、PROGRAMFILES）和更长的启动超时（startup_timeout_ms = 20_000）。
- 本地开发时需先 pnpm install 与 pnpm build，然后将 MCP 客户端指向本地构建的 dist/index.js。
使用场景
向代理询问正在运行的 Next.js 应用中的错误（nextjs_index + nextjs_call 调用 get_errors）
查看路由与页面结构（get_page_metadata）
读取开发服务器日志（get_logs）
解析 Server Action ID 对应的源文件（get_server_action_by_id）
获取与已安装版本一致的 Next.js 文档路径（nextjs_docs）
设置 agent-browser 进行浏览器自动化（browser_eval）
支持客户端
Claude Code完整支持
Cursor完整支持
Codex完整支持
Amp完整支持
Gemini完整支持
Google Antigravity完整支持
VS Code / Copilot完整支持
Warp完整支持