Nuxt MCP Toolkit — скилл

Скилл от авторов модуля учит агента создавать MCP-сервер в приложении на Nuxt: инструменты, ресурсы, промпты и MCP Apps.

  • 182 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл содержит инструкции и примеры кода. Сгенерированный агентом MCP-сервер откроет доступ к данным приложения, поэтому проверяйте авторизацию в инструментах.
Все причины и проверки

nuxt-modules/mcp-toolkit

Установка

В терминале, через 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: агент создает, дорабатывает, отлаживает и проверяет их

ПлагинРасширенный доступ10,9 тыс.Звезды репозитория

CLI создает каркас MCP-сервера на TypeScript, добавляет компоненты и проверяет описания схем перед подключением

CLIРасширенный доступ931Звезды репозитория

CLI-компилятор читает код приложения, спецификацию API и схемы баз и генерирует готовый MCP-сервер с проверкой прав инструментов.

CLIРасширенный доступ107Звезды репозитория
Выбор редакции

Официальный плагин со скиллами для сборки MCP Apps: интерактивных UI поверх инструментов MCP, которые открываются прямо в Claude

ПлагинМинимальный доступ3,1 тыс.Звезды репозитория

MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке

MCP-серверШирокий доступ1,2 тыс.Звезды репозитория

CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты

CLIРасширенный доступ750Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
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

Сообщить о проблеме