next-devtools-mcp 是一个模型上下文协议（MCP）服务器，连接了像 Claude 和 Cursor 这样的编码代理与你正在运行的Next.js开发服务器。

它是一个薄连接器。它检测运行Next.js 16+开发服务器，并代理其内置MCP端点（/_next/mcp），使代理获得实时运行时错误、路由和日志。它还附带两个网关，指向代理直接运行的工具：版本准确文档和agent-browserCLI。

[!注] 文档和迁移工作流不再存在于该服务器中。Next.js 在 node_modules/next/dist/docs/ 捆绑了自己的文档，升级/缓存组件工作流作为代理技能分发。参见从 0.3.x 迁移。

要求

• Node.js v20.19 或更新的 LTS 版本
• NPM 或 PNPM
• Next.js 16+ 运行开发服务器（适用于 nextjs_index / nextjs_call）

安装

为所有编码代理安装 add-mcp ：

添加 -y 以跳过提示并安装到所有检测到的代理。添加 -g 以在所有项目中进行全局安装。

或者手动把配置添加到你的MCP客户端：

[!注] next-devtools-mcp@latest 让你的客户保持最新版本。

客户特定设置

放大器

Next.js DevTools MCP

next-devtools-mcp is a Model Context Protocol (MCP) server that connects coding agents like Claude and Cursor to your running Next.js dev server.

It is a thin connector. It discovers running Next.js 16+ dev servers and proxies their built-in MCP endpoint (/_next/mcp) so agents get live runtime errors, routes, and logs. It also ships two gateways that point agents at tools they run directly: version-accurate docs and the agent-browser CLI.

[!NOTE] Docs and migration workflows no longer live in this server. Next.js bundles its own docs at node_modules/next/dist/docs/, and upgrade / Cache Components workflows are distributed as agent skills. See Migrating from 0.3.x.

Requirements

• Node.js v20.19 or a newer LTS version
• npm or pnpm
• Next.js 16+ with a running dev server (for nextjs_index / nextjs_call)

Install

Install for all your coding agents with add-mcp:

npx add-mcp next-devtools-mcp@latest

Add -y to skip the prompt and install to all detected agents. Add -g to install globally across all projects.

Or add the config to your MCP client manually:

{
  "mcpServers": {
    "next-devtools": {
      "command": "npx",
      "args": ["-y", "next-devtools-mcp@latest"]
    }
  }
}

[!NOTE] next-devtools-mcp@latest keeps your client on the latest version.

Client-specific setup