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).
Настройка клиентов
{
"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— шлюз: проверяет, установлен ли CLIagent-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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.