next-devtools-mcp

next-devtools-mcp — официальный MCP-сервер от vercel. Инструменты разработки для Next.js через MCP. Ставится через npx. Лицензия NOASSERTION.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
vercel
Лицензия
NOASSERTION
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: medium

Читает ошибки, логи и метаданные локальных dev-серверов Next.js; анонимная телеметрия (NEXT_TELEMETRY_DISABLED=1).

Настройка клиентов

codex
{
    "code": "codex mcp add next-devtools -- npx next-devtools-mcp@latest",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Next.js DevTools MCP — MCP-сервер от Vercel, который подключает агентов для программирования, например Claude и Cursor, к запущенному dev-серверу Next.js. Это тонкий коннектор. Он находит запущенные dev-серверы Next.js 16+ и проксирует их встроенный MCP-эндпоинт /_next/mcp, так что агент видит ошибки, маршруты и логи работающего приложения.

Четыре инструмента:

  • nextjs_index — сканирует распространённые порты, находит dev-серверы Next.js 16+ и показывает их встроенные инструменты;
  • nextjs_call — вызывает инструмент найденного сервера. Набор зависит от версии Next.js: get_errors (ошибки сборки, выполнения и типов), get_logs (путь к логу dev-сервера), get_page_metadata (маршруты и страницы), get_project_metadata (структура и конфигурация проекта), get_server_action_by_id (исходный файл Server Action);
  • nextjs_docs — шлюз: указывает агенту на документацию, которая поставляется с Next.js в node_modules/next/dist/docs/ и соответствует установленной версии. Сам документацию не загружает;
  • browser_eval — шлюз: проверяет, установлен ли CLI agent-browser, и даёт команду запуска или установки. Браузером сам не управляет.

С версии 0.4.0 документация и сценарии миграции (обновление до Next.js 16, Cache Components) вынесены из сервера в навыки для агентов.

Кому подойдёт

  • Разработчикам на Next.js 16+: агент видит реальные ошибки и логи приложения, а не только код.
  • Тем, кто отлаживает маршруты и Server Actions: быстро найти исходник по ID действия.
  • Командам на актуальной версии Next.js: агент берёт документацию, совпадающую с установленной версией.

Похожие серверы — в категории разработка.

Установка

Нужны Node.js 20.19 или новее (LTS), npm или pnpm и Next.js 16+ с запущенным dev-сервером — это для nextjs_index и nextjs_call. Быстрая установка сразу во все агенты: npx add-mcp next-devtools-mcp@latest. Затем запустите npm run dev: Next.js 16+ по умолчанию открывает MCP-эндпоинт http://localhost:3000/_next/mcp, и сервер находит его сам.

Подключение к клиентам

Команды приведены дословно из README. Общий порядок — в инструкции как подключить MCP.

claude mcp add next-devtools npx next-devtools-mcp@latest

Для Cursor, Gemini CLI, Amp, Google Antigravity и Warp в README есть отдельные инструкции. Для Codex на Windows 11 добавьте в .codex/config.toml переменные окружения и увеличенный тайм-аут запуска.

Проверка

Запустите npm run dev и спросите: «Next Devtools, какие ошибки в моём приложении?» Агент вызовет nextjs_index, а затем nextjs_call с get_errors.

Примеры задач

Next Devtools, покажи структуру маршрутов моего приложения.
Что в логах dev-сервера? Найди причину ошибки на странице /checkout.

Риски

Сервер подключается к локальным dev-серверам и читает их ошибки, логи и метаданные проекта. Сам он ничего не меняет, но агент дальше правит код по этим данным, поэтому просматривайте изменения. Логи и сообщения об ошибках могут содержать данные из приложения: не запускайте сервер рядом с dev-сервером, который работает с продакшен-секретами. По README собирается анонимная телеметрия: какие инструменты вызваны, ошибки и базовые данные окружения, но без кода, путей и аргументов. Отключить её можно переменной NEXT_TELEMETRY_DISABLED=1, а удалить локальные данные — командой rm -rf ~/.next-devtools-mcp.

Частые вопросы

Почему «No server info found»?

nextjs_index и nextjs_call нужен запущенный dev-сервер Next.js 16+. Эндпоинт /_next/mcp есть только в этих версиях.

Работает ли без dev-сервера?

Частично: nextjs_docs и browser_eval работают без него.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники