bunge-ds-mcp

Servidor MCP (Model Context Protocol) que expone el catálogo de componentes del Design System @bunge/ds-components. Permite que los asistentes de IA listen, busquen y obtengan detalles completos de los componentes — incluyendo inputs, outputs, ejemplos de uso e instrucciones de import.

El servidor se comunica vía stdio (no expone puerto HTTP). La comunicación ocurre a través del propio proceso, integrado directamente en el cliente MCP (ej: VS Code Copilot).

Tools

Tool	Descripción
`list-components`	Lista todos los componentes disponibles, con filtro opcional por categoría (`form`, `layout`, `navigation`, `feedback`, `data-display`, `overlay`)
`get-component`	Devuelve detalles completos de un componente por ID (inputs, outputs, uso, import)
`search-components`	Busca componentes por nombre, descripción o etiquetas
`get-component-usage`	Devuelve ejemplos de uso e instrucciones de import de un componente

Cómo empezar

Requisitos previos

Node.js 18+
npm 9+

Instalación y build

npm install
npm run build

Ejecutar localmente

npm start

El servidor se inicia vía stdio — no hay puerto HTTP. Es consumido por clientes MCP que se conectan al proceso directamente.

Configuración en el cliente MCP (ej: VS Code)

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

O apuntando al build local:

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

Scripts del package.json

Script	Comando	Descripción
`build`	`tsc`	Compila el TypeScript a JavaScript en la carpeta `dist/`
`start`	`node dist/index.js`	Inicia el servidor MCP (requiere build previo)
`dev`	`tsc --watch`	Compila en modo watch — recompila automáticamente ante cada cambio
`dev:inspect`	`tsc && npx @modelcontextprotocol/inspector node dist/index.js`	Compila y abre el MCP Inspector para probar las tools interactivamente
`test`	`vitest run`	Ejecuta los tests unitarios una vez
`test:watch`	`vitest`	Ejecuta los tests en modo watch
`docker:infra:up`	`docker compose up -d --wait`	Levanta Verdaccio (registry npm privado) en el puerto 4873
`docker:infra:down`	`docker compose down`	Detiene y elimina el contenedor de Verdaccio
`registry:login:private`	`npm login --registry http://localhost:4873`	Inicia sesión en el registry privado local (Verdaccio)
`release:private`	`npm version patch && npm publish --registry http://localhost:4873`	Incrementa la versión (patch) y publica en el registry privado local

Infraestructura local (Docker)

El docker-compose.yaml levanta un Verdaccio — registry npm privado — en el puerto 4873 (http://localhost:4873). Se utiliza para simular la publicación del paquete sin enviarlo al npm público.

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

Estructura del proyecto

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

Install Server

A

license - permissive license

A

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

bunge-ds-mcp

bunge-ds-mcp

Tools

Cómo empezar

Requisitos previos

Instalación y build

Ejecutar localmente

Configuración en el cliente MCP (ej: VS Code)

Scripts del package.json

Infraestructura local (Docker)

Estructura del proyecto

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API