MCP-сервер Nuxt

Использование документации Nuxt в ИИ-ассистентах через Model Context Protocol.

Что такое 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-сервер предоставляет инструменты по категориям:

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

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

Блог

  • list_blog_posts: список постов блога с метаданными (даты, категории, теги)
  • get_blog_post: получение поста по пути

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

  • list_deploy_providers: список провайдеров и платформ для развёртывания Nuxt
  • get_deploy_provider: детали и инструкции по провайдеру по пути

Промпты

MCP-сервер предоставляет промпты для типовых сценариев:

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

В инструментах вроде Claude Code к ним можно обращаться через /.

Настройка

MCP-сервер Nuxt использует HTTP и может быть подключён в разных ИИ-ассистентах.

ChatGPT

Кастомные коннекторы по MCP доступны в ChatGPT для аккаунтов Pro и Plus в веб-версии.

Настройка Nuxt как коннектора в ChatGPT:

  1. Включите режим разработчика: Настройки → Connectors → Дополнительно → Режим разработчика
  2. Откройте настройки ChatGPT
  3. Во вкладке Connectors создайте коннектор:
    • Имя: Nuxt
    • URL MCP-сервера: https://nuxt.com/mcp
    • Аутентификация: None
  4. Нажмите Create

Коннектор Nuxt появится в инструменте «Режим разработчика» в композере.

Claude Code

Установите Claude Code — инструкции в документации Anthropic.

Добавьте сервер через CLI:

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

Установите MCP-сервер Nuxt в Cursor по кнопке ниже:

Установить MCP-сервер

Ручная настройка:

  1. Cursor → Настройки → Tools & MCP
  2. Добавьте конфигурацию MCP-сервера Nuxt

Или создайте/измените .cursor/mcp.json в корне проекта:

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

Le Chat Mistral

  1. Intelligence → Connectors
  2. Add Connector → Custom MCP Connector
  3. Укажите: Name — Nuxt, Server — https://nuxt.com/mcp

Visual Studio Code

Нужны расширенияGitHub Copilot и GitHub Copilot Chat.
  1. Command Palette (Ctrl/Cmd + Shift + P)
  2. «Preferences: Open Workspace Settings (JSON)»
  3. В папке проекта .vscode создайте или отредактируйте mcp.json:
.vscode/mcp.json
{
  "servers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}

GitHub Copilot Agent

Нужны права администратора репозитория для настройки MCP в GitHub Copilot coding agent.

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

  1. Репозиторий на GitHub → Settings → Code & automation → Copilot → Coding agent
  2. В разделе MCP configuration добавьте:
    {
      "mcpServers": {
        "nuxt": {
          "type": "http",
          "url": "https://nuxt.com/mcp",
          "tools": ["*"]
        }
      }
    }
    
  3. Save

Проверка: создайте issue, назначьте Copilot, дождитесь PR → View session → ... → Copilot → шаг Start MCP Servers. Подробнее: Extend coding agent with MCP.

Windsurf

  1. Settings → Windsurf Settings → Cascade → Manage MCPs → View raw config
  2. Добавьте в настройки MCP:
.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "nuxt": {
      "type": "http",
      "url": "https://nuxt.com/mcp"
    }
  }
}

Zed

  1. Settings → Open Settings → JSON
  2. Добавьте context server:
.config/zed/settings.json
{
  "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-серверу за структурированными данными и подсказками по Nuxt.