Nuxt MCP Dev

Установка

Работает в

• Claude Code
• Cursor
• Windsurf
• VS Code
• SourceCraft
• Koda
• Coddy

Ручная установка

Что делает

Репозиторий Энтони Фу содержит два пакета. `nuxt-mcp-dev` подключается к проекту на Nuxt строкой в `modules` файла `nuxt.config.ts`, `vite-plugin-mcp` добавляется плагином `ViteMcp()` в `vite.config`. Пока работает dev-сервер, на нем доступен MCP-сервер по адресу вида `http://localhost:3000/__mcp/sse` для Nuxt или `http://localhost:5173/__mcp/sse` для Vite. Отдельного процесса не нужно. В Nuxt агент получает инструменты `get-nuxt-config` (параметры `ssr`, `srcDir`, `rootDir`, псевдонимы, публичный `runtimeConfig`, подключенные модули), `list-nuxt-pages`, `list-nuxt-components` и `list-nuxt-auto-imports-items`. Последние три нужны, чтобы агент использовал существующие страницы, компоненты и функции, а не выдумывал импорты. Инструмент `nuxt-scaffold` вызывает `nuxi add` и создает компонент, страницу, слой, плагин, серверный маршрут и другие шаблоны. Плагин Vite добавляет `get-vite-config` и `get-vite-module-info`: для файла он возвращает импортирующие и импортируемые модули и результат компиляции. Модуль сам прописывает сервер в конфигурации клиентов. Файлы зависят от клиента: `.cursor/mcp.json`, `.vscode/settings.json`, `~/.codeium/windsurf/mcp_config.json` и `.mcp.json` для Claude Code. Вместе с ним по умолчанию добавляется удаленный сервер документации `https://nuxt.com/mcp`, отключается опцией `includeNuxtDocsMcp: false`. Другие модули Nuxt могут дополнить набор инструментов через хук `mcp:setup`.

Для кого. Для разработчиков на Nuxt и Vite, которые пишут код с Cursor, Claude Code, Windsurf или VS Code и хотят, чтобы агент знал устройство их приложения.

Пример запроса к агенту

Посмотри, какие компоненты и автоимпорты уже есть в приложении, и создай страницу профиля, не дублируя существующее

MCP

Транспорт

sse

Авторизация

не нужна

Ограничения

• Автор помечает `nuxt-mcp-dev` экспериментальным и просит осторожности, а `vite-plugin-mcp` — не готовым к продакшену.
• Сервер доступен, только пока запущен dev-сервер. Проверка идет на порту dev-сервера, по умолчанию 3000 для Nuxt и 5173 для Vite, адрес выводится в консоль.
• Режим `updateConfig: 'auto'` сам правит конфигурации клиентов, в том числе глобальный файл Windsurf в домашней папке. Чтобы не менять файлы, задайте `updateConfig: false`.
• Вместе с модулем в конфигурации клиентов появляется удаленный сервер `nuxt-docs` на `https://nuxt.com/mcp`. Отключается опцией `includeNuxtDocsMcp: false`.
• Инструмент `nuxt-scaffold` создает файлы проекта. Проверьте результат в git, прежде чем коммитить.

Как отключить. Уберите `nuxt-mcp-dev` из `modules` в `nuxt.config.ts` или `ViteMcp()` из плагинов Vite. Записи сервера, которые модуль добавил в `.cursor/mcp.json`, `.vscode/settings.json`, `.mcp.json` и конфигурацию Windsurf, удаляйте вручную. Чтобы модуль не менял файлы клиентов, задайте `updateConfig: false`.

Коротко о README

Корневая документация коротко представляет монорепозиторий с двумя пакетами, предупреждает об экспериментальном статусе и отсылает к `@nuxtjs/mcp-toolkit` и к документации Nuxt по ИИ. В документации каждого пакета есть пример подключения, адрес сервера, описание автоматической настройки клиентов, а у Nuxt еще и хук `mcp:setup`. В репозитории лежат исходники на TypeScript, песочницы для обоих пакетов и тесты экспорта.