bunge-ds-mcp

MCP-сервер (Model Context Protocol), который предоставляет доступ к каталогу компонентов дизайн-системы @bunge/ds-components. Он позволяет ИИ-ассистентам перечислять, искать и получать полные сведения о компонентах, включая входные и выходные данные, примеры использования и инструкции по импорту.

Сервер взаимодействует через stdio (не открывает HTTP-порт). Обмен данными происходит через сам процесс, интегрированный непосредственно в MCP-клиент (например, VS Code Copilot).

Инструменты

Инструмент	Описание
`list-components`	Перечисляет все доступные компоненты с опциональной фильтрацией по категории (`form`, `layout`, `navigation`, `feedback`, `data-display`, `overlay`)
`get-component`	Возвращает полные сведения о компоненте по его ID (входные/выходные данные, использование, импорт)
`search-components`	Поиск компонентов по имени, описанию или тегам
`get-component-usage`	Возвращает примеры использования и инструкции по импорту компонента

Как начать

Предварительные требования

Node.js 18+
npm 9+

Установка и сборка

npm install
npm run build

Локальный запуск

npm start

Сервер запускается через stdio — HTTP-порт отсутствует. Он используется MCP-клиентами, которые подключаются к процессу напрямую.

Настройка в MCP-клиенте (например, VS Code)

{
  "mcpServers": {
    "bunge-ds-mcp": {
      "command": "npx",
      "args": ["bunge-ds-mcp"]
    }
  }
}

Или указав путь к локальной сборке:

{
  "mcpServers": {
    "bunge-ds-mcp": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

Скрипты package.json

Скрипт	Команда	Описание
`build`	`tsc`	Компилирует TypeScript в JavaScript в папку `dist/`
`start`	`node dist/index.js`	Запускает MCP-сервер (требуется предварительная сборка)
`dev`	`tsc --watch`	Компилирует в режиме watch — автоматически пересобирает при каждом изменении
`dev:inspect`	`tsc && npx @modelcontextprotocol/inspector node dist/index.js`	Компилирует и открывает MCP Inspector для интерактивного тестирования инструментов
`test`	`vitest run`	Запускает модульные тесты один раз
`test:watch`	`vitest`	Запускает тесты в режиме watch
`docker:infra:up`	`docker compose up -d --wait`	Запускает Verdaccio (приватный npm-реестр) на порту 4873
`docker:infra:down`	`docker compose down`	Останавливает и удаляет контейнер Verdaccio
`registry:login:private`	`npm login --registry http://localhost:4873`	Выполняет вход в локальный приватный реестр (Verdaccio)
`release:private`	`npm version patch && npm publish --registry http://localhost:4873`	Увеличивает версию (patch) и публикует в локальный приватный реестр

Локальная инфраструктура (Docker)

Файл docker-compose.yaml запускает Verdaccio — приватный npm-реестр — на порту 4873 (http://localhost:4873). Используется для имитации публикации пакета без отправки в публичный npm.

npm run docker:infra:up    # sobe o Verdaccio
npm run registry:login:private  # autentica no registry local
npm run release:private    # publica o pacote localmente

Структура проекта

src/
├── index.ts              # Entrada: cria o McpServer e conecta ao transport
├── tools/                # Registro das tools (uma por arquivo)
│   ├── index.ts          # Barrel — registra todas as tools
│   ├── list-components.ts
│   ├── get-component.ts
│   ├── search-components.ts
│   └── get-component-usage.ts
├── data/
│   └── components.ts     # Catálogo de componentes do DS
├── models/
│   └── mcp-server.model.ts  # Interfaces e tipos
└── tests/
    ├── data.spec.ts
    └── tools.spec.ts

bunge-ds-mcp

bunge-ds-mcp

Инструменты

Как начать

Предварительные требования

Установка и сборка

Локальный запуск

Настройка в MCP-клиенте (например, VS Code)

Скрипты package.json

Локальная инфраструктура (Docker)

Структура проекта

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API