feat: add mcp server package

[EldarMuhamethanov]

• close [Tech][AI]: создать пакет @vkontakte/vkui-mcp #9260

---

• Unit-тесты
• e2e-тесты
• Дизайн-ревью
• Документация фичи
• Release notes

Описание

Добавлен новый пакет @vkontakte/vkui-mcp — MCP-сервер (Model Context Protocol) для документации VKUI. Он даёт AI-ассистентам (например, в Cursor) доступ к списку компонентов и хуков, их свойствам, примерам кода и рекомендациям по миграции на v8.

Сервер можно запускать через npx @vkontakte/vkui-mcp и подключать в конфиг MCP-клиента. Данные по компонентам и примерам подгружаются с сайта документации (по умолчанию https://vkui.io), базовый URL настраивается через переменную окружения VKUI_DOCS_BASE_URL.

Изменения

• Новый пакет packages/vkui-mcp:
  • Инструменты (tools): list_components, get_component_metadata, list_hooks, get_hook_metadata, list_examples, get_example, list_migration_targets, get_migration_target.
  • Ресурсы (resources): vkui://migration/v8 — список целей миграции; vkui://component/{slug} — карточка компонента; vkui://migration/{name} — рекомендации по миграции по имени компонента/хука.
  • Провайдер данных загружает JSON с документации по HTTP (компоненты, хуки, примеры); данные по миграции v8 заданы статически в migrations/v8.ts.
  • CLI (cli.ts) запускает stdio-сервер для общения с MCP-клиентом.
• Интеграционные тесты (stdio.integration.test.ts): запросы к серверу через stdio с моком HTTP-документации (компоненты, хуки, примеры, миграции).
• Публикация: в .github/workflows/publish.yml добавлен пакет @vkontakte/vkui-mcp в список публикуемых; в .gitignore добавлена папка mcp/.

Release notes

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

• Добавлен @vkontakte/vkui-mcp: MCP-сервер для документации VKUI — даёт AI-ассистентам доступ к списку компонентов и хуков, их props, примерам кода и рекомендациям по миграции на v8. Подключение: npx @vkontakte/vkui-mcp и настройка в конфиге MCP-клиента (например, Cursor).

[github-actions]

size-limit report 📦

Path	Size
JS	409.75 KB (+0.26% 🔺)
JS (gzip)	125.61 KB (+0.35% 🔺)
JS (brotli)	103.69 KB (+0.08% 🔺)
JS import Div (tree shaking)	811 B (0%)
CSS	374.69 KB (0%)
CSS (gzip)	46.18 KB (0%)
CSS (brotli)	36.57 KB (0%)

[github-actions]

e2e tests

Playwright Report

[github-actions]

✅ Изменений в собранных файлах нет

Commit cfc15f5

[github-actions]

👀 Docs deployed

• ✅ Website
• ✅ Playground

📦 Package ✅

yarn add @vkontakte/vkui@https://development.s3.prodcloud.vk.team/pull/9512/cfc15f5286c143095f99b3bc357b41a556663935/pkg/@vkontakte/vkui/_pkg.tgz

Commit cfc15f5

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.30%. Comparing base (47d3770) to head (cfc15f5).
⚠️ Report is 12 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #9512      +/-   ##
==========================================
- Coverage   95.31%   95.30%   -0.01%     
==========================================
  Files         440      440              
  Lines       12104    12085      -19     
  Branches     4405     4403       -2     
==========================================
- Hits        11537    11518      -19     
  Misses        567      567              

Flag	Coverage Δ
unittests	95.30% <ø> (-0.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[inomdzhon]

 🤖
🦾🔥
 🦿🦿