Vue Prime MCP Server

MCP сервер для доступа к документации PrimeVue через Model Context Protocol.

Возможности

Сервер предоставляет доступ к трем основным эндпоинтам документации PrimeVue:

1. /llms.txt - Структурированный список ключевых страниц документации (индустриальный стандарт для помощи AI моделям)
2. /llms-full.txt - Полная документация PrimeVue со всеми страницами
3. /components/{component}.md - Документация конкретного компонента в формате Markdown

Ресурсы

• primevue://llms-txt - Структурированный список ключевых страниц из https://primevue.org/llms/llms.txt
• primevue://llms-full-txt - Полная документация из https://primevue.org/llms/llms-full.txt
• primevue://component/{componentName} - Документация компонента из https://primevue.org/llms/components/{component}.md

Инструменты

get-primevue-component

Получает документацию конкретного компонента PrimeVue в формате Markdown.

Параметры:

• componentName (string) - Название компонента в нижнем регистре (например: "menu", "button", "datatable")

Пример:

{
  "componentName": "menu"
}

Эндпоинт: https://primevue.org/llms/components/menu.md

get-primevue-llms-txt

Получает структурированный список ключевых страниц документации PrimeVue.

Параметры: Нет

Эндпоинт: https://primevue.org/llms/llms.txt

get-primevue-llms-full-txt

Получает полную документацию PrimeVue.

Параметры: Нет

Эндпоинт: https://primevue.org/llms/llms-full.txt

search-primevue-docs

Ищет информацию в полной документации PrimeVue по ключевому слову или фразе.

Параметры:

• query (string) - Поисковый запрос

Пример:

{
  "query": "Button component"
}

Промпты

primevue-help

Создает промпт для получения помощи по PrimeVue.

Параметры:

• topic (string, опционально) - Конкретная тема или вопрос

Установка

pnpm install

Сборка

pnpm run build

Запуск

Разработка

pnpm run dev

Продакшн

pnpm start

Использование с MCP клиентами

Режим работы: HTTP (сетевой)

Сервер работает как HTTP сервер и доступен по сети на порту 3000 (по умолчанию).

Быстрый старт

1. Установите зависимости и соберите проект:

   pnpm install
   pnpm run build

2. Запустите сервер:

   pnpm start
   # или для разработки
   pnpm run dev

3. Проверьте работу:

   curl http://localhost:3000/health

4. Подключите MCP клиент (см. инструкции ниже)

Claude Desktop (HTTP режим)

Linux

1. Создайте или откройте файл конфигурации:

   mkdir -p ~/.config/Claude
   nano ~/.config/Claude/claude_desktop_config.json

2. Добавьте конфигурацию:

   {
     "mcpServers": {
       "vue-prime-mcp": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }

3. Убедитесь, что сервер запущен, и перезапустите Claude Desktop

macOS

1. Создайте или откройте файл конфигурации:

   mkdir -p ~/Library/Application\ Support/Claude
   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Добавьте конфигурацию:

   {
     "mcpServers": {
       "vue-prime-mcp": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }

3. Убедитесь, что сервер запущен, и перезапустите Claude Desktop

Windows

1. Откройте файл конфигурации:

   %APPDATA%\Claude\claude_desktop_config.json
   

2. Добавьте конфигурацию:

   {
     "mcpServers": {
       "vue-prime-mcp": {
         "url": "http://localhost:3000/mcp"
       }
     }
   }

3. Убедитесь, что сервер запущен, и перезапустите Claude Desktop

Удаленное подключение

Если сервер запущен на другой машине, используйте IP адрес:

{
  "mcpServers": {
    "vue-prime-mcp": {
      "url": "http://192.168.1.100:3000/mcp"
    }
  }
}

Настройка порта и хоста

Измените порт и хост через переменные окружения:

PORT=8080 HOST=0.0.0.0 pnpm start

Endpoints

• POST /mcp - Основной MCP endpoint для Streamable HTTP
• GET /mcp - Информация о сервере (для GET запросов)
• GET /health - Health check endpoint
• GET / - Информация о сервере и доступных ресурсах/инструментах

Подробная инструкция: См. файл CONNECTION.md

Эндпоинты PrimeVue

Сервер использует следующие официальные эндпоинты PrimeVue:

• llms.txt: https://primevue.org/llms/llms.txt - Структурированный список ключевых страниц для AI моделей
• llms-full.txt: https://primevue.org/llms/llms-full.txt - Полная документация
• Component Markdown: https://primevue.org/llms/components/{component}.md - Документация компонента в Markdown

Добавление .md к URL страницы возвращает Markdown версию этой страницы.

Кэширование

Сервер кэширует загруженную документацию для быстрого доступа:

• llms.txt кэшируется после первой загрузки
• llms-full.txt кэшируется после первой загрузки
• Документация компонентов кэшируется индивидуально

Разработка

Проект использует TypeScript и компилируется в JavaScript. Исходный код находится в src/, скомпилированный код - в dist/.

Деплой на Vercel

Проект готов к деплою на Vercel. Подробные инструкции см. в VERCEL.md.

Быстрый деплой

# Установите Vercel CLI
npm i -g vercel

# Войдите
vercel login

# Деплой
vercel --prod

После деплоя endpoints будут доступны по адресу:

• https://your-project.vercel.app/api/mcp - Основной MCP endpoint
• https://your-project.vercel.app/api/health - Health check

Примечание: Сервер использует stateless режим - каждый запрос независим и не требует сессий.

Лицензия

MIT