Nuxt MCP Toolkit — скилл
Скилл от авторов модуля учит агента создавать MCP-сервер в приложении на Nuxt: инструменты, ресурсы, промпты и MCP Apps.
- 182 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл содержит инструкции и примеры кода. Сгенерированный агентом MCP-сервер откроет доступ к данным приложения, поэтому проверяйте авторизацию в инструментах.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/nuxt-mcp-toolkitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл содержит инструкции и примеры кода. Сгенерированный агентом MCP-сервер откроет доступ к данным приложения, поэтому проверяйте авторизацию в инструментах.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Nuxt MCP Toolkit — модуль `@nuxtjs/mcp-toolkit`, который превращает приложение на Nuxt в MCP-сервер: файлы в `server/mcp/` находятся автоматически и регистрируются как инструменты, ресурсы и промпты. В комплекте идет скилл `manage-mcp`. После установки агент настраивает MCP в проекте на Nuxt, пишет инструменты, ресурсы и промпты, делит эндпоинты на несколько обработчиков, добавляет авторизацию, логирование и сессии, собирает интерактивные виджеты MCP Apps на Vue. Он также ревьюит готовую реализацию на антипаттерны, разбирается с автоимпортами и ошибками валидации и составляет наборы проверок: по ним видно, какие инструменты выбирает модель.
Для кого. Разработчикам на Nuxt, которые добавляют MCP-эндпоинт в свое приложение и хотят, чтобы агент писал его по рекомендациям авторов модуля.
Подходит, если
- В Nuxt-проекте еще нет MCP, и агент должен настроить модуль и первый инструмент.
- Эндпоинт делят на публичный и административный, а инструменты фильтруют по пользователю.
- ChatGPT или Cursor должен вызывать интерактивный виджет на Vue из MCP-сервера.
- Агент не находит инструмент после правки, или автоимпорты перестали работать.
- Реализацию MCP перед релизом проверяют на антипаттерны и ошибки в описаниях инструментов.
Не подходит, если
- Сервер пишут не на Nuxt: скилл целиком про `@nuxtjs/mcp-toolkit`.
- Нужен готовый MCP-сервер для подключения: скилл помогает писать код своего сервера.
- Проект на Nitro без Nuxt: для него в репозитории лежит отдельный пакет `nitro-mcp-toolkit`, а скилл описывает модуль для Nuxt.
Пример запроса к агенту
Настрой MCP-сервер в моем Nuxt-приложении и добавь инструмент, который возвращает данные пользователя по id.Ограничения
Скилл работает только с модулем `@nuxtjs/mcp-toolkit` и приложением на Nuxt. Для устанавливаемого пакета нужен `zod`, а в `nuxt.config.ts` включают `nitro.experimental.asyncContext`, иначе не работают `useEvent`, `useMcpServer` и `useMcpLogger`. Установка скилла идет из документации по адресу `mcp-toolkit.nuxt.dev` через `npx skills add`, поэтому нужен доступ к сайту. Файл SKILL.md длинный, около тысячи строк, и вместе со справочными файлами расходует заметную часть контекста.
Как отключить. Удалите папку скилла `manage-mcp` из каталога скиллов агента. Сам модуль убирают из `modules` в `nuxt.config.ts` и удаляют пакетом `@nuxtjs/mcp-toolkit`.
Частые вопросы
Как установить скилл Nuxt MCP Toolkit?
Выполните `npx skills add https://mcp-toolkit.nuxt.dev`. Скилл ставится с сайта документации. Сам модуль подключает команда `npx nuxt add mcp`.
Что агент умеет после установки?
Настроить MCP в Nuxt, создать инструменты, ресурсы и промпты, разбить их на обработчики, добавить авторизацию и логирование, собрать MCP Apps, проверить реализацию и разобрать типичные сбои вроде необнаруженного инструмента.
Куда класть файлы инструментов?
В каталог `server/mcp/` с подпапками `tools`, `resources` и `prompts`. Подпапка внутри `tools` задает группу, например `admin`.
Зачем нужен `zod`?
Модуль проверяет входные и выходные данные инструментов схемами `zod`, поэтому пакет ставят вместе с модулем.
Как проверить, что модель выбирает нужные инструменты?
Скилл умеет составлять наборы проверок: по набору запросов видно, какой инструмент выбирает модель. Так находят инструменты с неясным описанием.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
CLI создает каркас MCP-сервера на TypeScript, добавляет компоненты и проверяет описания схем перед подключением
CLI-компилятор читает код приложения, спецификацию API и схемы баз и генерирует готовый MCP-сервер с проверкой прав инструментов.
Официальный плагин со скиллами для сборки MCP Apps: интерактивных UI поверх инструментов MCP, которые открываются прямо в Claude
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Nuxt MCP Toolkit (эта карточка) | нет | 182 | ||
| FastMCP | нет | 28 405 | фреймворк MCP-серверов на Python; скилл учит агента делать то же внутри приложения на Nuxt | |
| Nuxt MCP Dev | нет | не нужна | 914 | дает агенту сведения о запущенном проекте Nuxt; здесь агент учится писать собственный MCP-сервер |
Коротко о README
Модуль работает без настройки: достаточно создать файлы, и они регистрируются сами. В README перечислены несколько обработчиков в одном приложении, MCP Apps, инспектор в Nuxt DevTools и объявление сервера в `llms.txt` при подключенном `nuxt-llms`.
Бейдж для README
Исходный SKILL.md
--- name: manage-mcp description: Manage MCP servers in Nuxt with @nuxtjs/mcp-toolkit — setup, create tools/resources/prompts, organize with handlers, build interactive MCP Apps, add elicitation/logging/sessions, review, and troubleshoot. --- # Manage MCP Complete skill for managing Model Context Protocol (MCP) servers in Nuxt with [`@nuxtjs/mcp-toolkit`](https://mcp-toolkit.nuxt.dev). Setup, create tools/resources/prompts, organize with multi-handler folder convention, build interactive UI widgets (MCP Apps), wire up sessions and observability, review, and troubleshoot. ## When to Use - **Setup**: "Setup an MCP server in my Nuxt app", "Add MCP to Nuxt" - **Create**: "Add a tool that calculates BMI", "Expose a README as a resource", "Create a code-review prompt" - **Organize**: "Split my MCP into admin + public endpoints", "Filter tools per user" - **Customize**: "Add authentication to my MCP", "Log every tool call to Axiom", "Stream progress to the client" - **Build apps**: "Add an interactive Vue widget callable from ChatGPT/Cursor" - **Persist state**: "Remember the user across tool calls in one session" - **Review**: "Review my MCP implementation", "Check for best practices" - **Troubleshoot**: "My tool isn't discovered", "Auto-imports don't work", "OAuth flow keeps triggering" - **Test**: "Eval which tools the model picks for these prompts" --- ## Setup MCP Server ### Installation ::code-group ```bash [pnpm] pnpm add @nuxtjs/mcp-toolkit zod ``` ```bash [npm] npm install @nuxtjs/mcp-toolkit zod ``` ```bash [yarn] yarn add @nuxtjs/mcp-toolkit zod ``` ```bash [bun] bun add @nuxtjs/mcp-toolkit zod ``` :: Or in one go via the Nuxt CLI: ```bash