Сервер MCP Nuxt

Что такое MCP?

MCP (Model Context Protocol) — стандартизированный протокол, который позволяет ИИ-ассистентам обращаться к внешним источникам данных и инструментам. Nuxt предоставляет MCP-сервер, чтобы ассистенты вроде Claude Code, Cursor и Windsurf могли напрямую получать документацию, записи блога и руководства по развёртыванию.

Сервер MCP даёт структурированный доступ к документации Nuxt, чтобы ИИ-инструментам было проще понимать контекст и помогать в разработке на Nuxt.

Ресурсы

Сервер MCP Nuxt предоставляет такие ресурсы для обнаружения:

• resource://nuxt-com/documentation-pages: все страницы документации (по умолчанию v4.x)
• resource://nuxt-com/blog-posts: записи блога Nuxt, включая релизы и руководства
• resource://nuxt-com/deploy-providers: провайдеры развёртывания и хостинг-платформы

Доступ к ним в Claude Code и аналогах — через @.

Инструменты

Инструменты MCP-сервера Nuxt сгруппированы по категориям:

Документация

• list_documentation_pages: список страниц документации с категориями и краткой информацией; фильтр версий (3.x, 4.x или все)
• get_documentation_page: содержимое и метаданные страницы по пути
• get_getting_started_guide: руководство «с чего начать» для выбранной версии Nuxt

Блог

• list_blog_posts: список постов с датами, категориями и тегами
• get_blog_post: содержимое поста по пути

Развёртывание

• list_deploy_providers: провайдеры и платформы хостинга
• get_deploy_provider: детали и инструкции по пути

Промпты

Готовые сценарии для типовых задач:

• find_documentation_for_topic: найти релевантную документацию по теме
• deployment_guide: инструкции по развёртыванию у выбранного хостера
• migration_help: помощь при миграции между версиями Nuxt

В Claude Code и подобных клиентах — через /.

Настройка

Сервер MCP Nuxt работает по HTTP и подключается в разных средах.

ChatGPT

1. Включите режим разработчика: Настройки → Коннекторы (Connectors) → Дополнительно (Advanced settings) → Режим разработчика (Developer mode)
2. Откройте настройки ChatGPT
3. Вкладка «Коннекторы» → «Создать коннектор» (Create a new connector):
   • Имя: Nuxt
   • URL MCP-сервера: https://nuxt.com/mcp
   • Аутентификация: Нет (None)
4. Создайте коннектор

Коннектор Nuxt появится в инструментах Composer при включённом режиме разработчика.

Claude Code

claude mcp add --transport http nuxt-remote https://nuxt.com/mcp

Claude Desktop

Инструкция по настройке

1. Откройте Claude Desktop → Настройки → Developer (разработчик)
2. Нажмите Edit Config (изменить конфигурацию) — откроется локальная папка Claude
3. Отредактируйте claude_desktop_config.json:
   claude_desktop_config.json

   {
     "mcpServers": {
       "nuxt": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://nuxt.com/mcp"
         ]
       }
     }
   }
   

4. Перезапустите Claude Desktop

Cursor

Вручную:

1. Настройки (Settings) → Инструменты и MCP (Tools & MCP) → добавьте конфигурацию Nuxt MCP

Или .cursor/mcp.json в корне проекта:

{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}

Le Chat Mistral

1. Intelligence → Коннекторы (Connectors)
2. Добавить коннектор (Add Connector) → Пользовательский MCP-коннектор (Custom MCP Connector)
3. Имя коннектора: Nuxt, сервер: https://nuxt.com/mcp

Visual Studio Code

1. Палитра команд (Ctrl/Cmd + Shift + P)
2. Выполните команду Preferences: Open Workspace Settings (JSON)
3. В проекте откройте или создайте папку .vscode
4. Создайте или отредактируйте mcp.json:

{
  "servers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}

GitHub Copilot Agent

Конфигурация аналогична VS Code (для агента используется ключ mcpServers вместо servers), плюс ключ tools для списка доступных инструментов.

1. Перейдите в репозиторий на GitHub
2. Настройки (Settings) → Code & automation → Copilot → Coding agent
3. В разделе конфигурации MCP (MCP configuration) добавьте:

   {
     "mcpServers": {
       "nuxt": {
         "type": "http",
         "url": "https://nuxt.com/mcp",
         "tools": ["*"]
       }
     }
   }
   

4. Нажмите Сохранить (Save)

Проверка конфигурации

Чтобы убедиться, что MCP-сервер настроен верно:

1. Создайте issue в репозитории и назначьте его Copilot
2. Дождитесь, пока Copilot откроет pull request
3. В pull request нажмите View session в событии временной шкалы «Copilot started work»
4. Нажмите кнопку с многоточием (...) в правом верхнем углу, затем откройте Copilot на боковой панели
5. Разверните шаг Start MCP Servers и убедитесь, что отображаются настроенные инструменты Nuxt

Подробнее: расширение агента написания кода с помощью MCP.

Windsurf

1. Настройки (Settings) → Windsurf Settings → Cascade → Управление MCP (Manage MCPs) → Сырой JSON (View raw config)
2. Добавьте:

{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}

Zed

1. Настройки (Settings) → Open Settings → JSON
2. Добавьте context server:

{
  "context_servers": {
    "nuxt": {
      "source": "custom",
      "command": "npx",
      "args": ["mcp-remote", "https://nuxt.com/mcp"],
      "env": {}
    }
  }
}

Opencode

1. В корне проекта создайте opencode.json
2. Добавьте:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nuxt": {
      "type": "remote",
      "url": "https://nuxt.com/mcp",
      "enabled": true
    }
  }
}

Примеры промптов

После настройки можно задавать ассистенту вопросы, например:

• «Перечисли все страницы документации Nuxt»
• «Покажи введение в документации»
• «В чём отличие v3 и v4?»
• «Как развернуть на Vercel?»
• «Последние посты в блоге»
• «Помоги мигрировать с Nuxt 3 на Nuxt 4»
• «Найди документацию по композаблам»
• «Гайды по развёртыванию на Cloudflare»

Ассистент обратится к MCP-серверу за структурированными JSON-данными и сможет дать целенаправленную помощь при разработке на Nuxt.