next-devtools-mcpはモデルコンテキストプロトコル(MCP)サーバーで、ClaudeやCursorのようなコーディングエージェントをあなたのNext.js開発サーバーに接続します。

これは薄いコネクターです。16+の開発サーバー Next.js実行を検出し、組み込みのMCPエンドポイント(/_next/mcp)をプロキシしてエージェントにライブランタイムエラー、ルート、ログを受信させます。また、エージェントが直接実行するツール、バージョンアキュアドキュメントとagent-browserCLIを指し示す2つのゲートウェイも提供しています。

[!注] ドキュメントおよび移行ワークフローはもはやこのサーバーには存在していません。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