[Draft]feat: add mcp server package

[EldarMuhamethanov]

• close [Draft][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	407.6 KB (0%)
JS (gzip)	125.16 KB (0%)
JS (brotli)	103.23 KB (0%)
JS import Div (tree shaking)	811 B (0%)
CSS	372.32 KB (0%)
CSS (gzip)	46.08 KB (0%)
CSS (brotli)	36.46 KB (0%)

[github-actions]

e2e tests

Playwright Report

[github-actions]

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

Commit 294f85f

[github-actions]

👀 Docs deployed

• ✅ Website
• ✅ Playground

📦 Package ✅

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

Commit 294f85f

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.41%. Comparing base (a0c5bd5) to head (294f85f).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #9512   +/-   ##
=======================================
  Coverage   95.41%   95.41%           
=======================================
  Files         439      439           
  Lines       12029    12029           
  Branches     4354     4354           
=======================================
  Hits        11477    11477           
  Misses        552      552           

Flag	Coverage Δ
unittests	95.41% <ø> (ø)

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.