bunge-ds-mcp

MCP-Server (Model Context Protocol), der den Komponenten-Katalog des Design Systems @bunge/ds-components bereitstellt. Er ermöglicht es KI-Assistenten, Komponenten aufzulisten, zu suchen und vollständige Details abzurufen – einschließlich Inputs, Outputs, Anwendungsbeispielen und Importanweisungen.

Der Server kommuniziert über stdio (kein HTTP-Port). Die Kommunikation erfolgt über den Prozess selbst, der direkt in den MCP-Client (z. B. VS Code Copilot) integriert ist.

Tools

Tool	Beschreibung
`list-components`	Listet alle verfügbaren Komponenten auf, mit optionalem Filter nach Kategorie (`form`, `layout`, `navigation`, `feedback`, `data-display`, `overlay`)
`get-component`	Gibt vollständige Details einer Komponente nach ID zurück (Inputs, Outputs, Verwendung, Import)
`search-components`	Sucht Komponenten nach Name, Beschreibung oder Tags
`get-component-usage`	Gibt Anwendungsbeispiele und Importanweisungen einer Komponente zurück

Erste Schritte

Voraussetzungen

Node.js 18+
npm 9+

Installation und Build

npm install
npm run build

Lokal ausführen

npm start

Der Server startet über stdio — es gibt keinen HTTP-Port. Er wird von MCP-Clients konsumiert, die sich direkt mit dem Prozess verbinden.

Konfiguration im MCP-Client (z. B. VS Code)

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

Oder durch Verweis auf den lokalen Build:

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

package.json Skripte

Skript	Befehl	Beschreibung
`build`	`tsc`	Kompiliert TypeScript zu JavaScript im Ordner `dist/`
`start`	`node dist/index.js`	Startet den MCP-Server (erfordert vorherigen Build)
`dev`	`tsc --watch`	Kompiliert im Watch-Modus — kompiliert bei jeder Änderung automatisch neu
`dev:inspect`	`tsc && npx @modelcontextprotocol/inspector node dist/index.js`	Kompiliert und öffnet den MCP Inspector, um die Tools interaktiv zu testen
`test`	`vitest run`	Führt die Unit-Tests einmalig aus
`test:watch`	`vitest`	Führt die Tests im Watch-Modus aus
`docker:infra:up`	`docker compose up -d --wait`	Startet Verdaccio (privates npm-Registry) auf Port 4873
`docker:infra:down`	`docker compose down`	Stoppt und entfernt den Verdaccio-Container
`registry:login:private`	`npm login --registry http://localhost:4873`	Meldet sich am lokalen privaten Registry (Verdaccio) an
`release:private`	`npm version patch && npm publish --registry http://localhost:4873`	Erhöht die Version (Patch) und veröffentlicht im lokalen privaten Registry

Lokale Infrastruktur (Docker)

Die docker-compose.yaml startet ein Verdaccio — ein privates npm-Registry — auf Port 4873 (http://localhost:4873). Dies wird verwendet, um die Veröffentlichung des Pakets zu simulieren, ohne es an das öffentliche npm zu senden.

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

Projektstruktur

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

Erste Schritte

Voraussetzungen

Installation und Build

Lokal ausführen

Konfiguration im MCP-Client (z. B. VS Code)

package.json Skripte

Lokale Infrastruktur (Docker)

Projektstruktur

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API