bunge-ds-mcp

@bunge/ds-components 디자인 시스템의 컴포넌트 카탈로그를 노출하는 MCP(Model Context Protocol) 서버입니다. AI 어시스턴트가 입력, 출력, 사용 예시 및 가져오기 지침을 포함한 컴포넌트의 전체 세부 정보를 나열, 검색 및 가져올 수 있도록 합니다.

이 서버는 stdio를 통해 통신하며(HTTP 포트를 노출하지 않음), MCP 클라이언트(예: VS Code Copilot)에 직접 통합되어 프로세스를 통해 통신합니다.

도구 (Tools)

도구	설명
`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를 `dist/` 폴더의 JavaScript로 컴파일합니다.
`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`	4873 포트에서 Verdaccio(비공개 npm 레지스트리)를 실행합니다.
`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은 4873 포트(http://localhost:4873)에서 Verdaccio(비공개 npm 레지스트리)를 실행합니다. 공개 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

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)

시작하기

사전 요구 사항

설치 및 빌드

로컬 실행

MCP 클라이언트 설정 (예: VS Code)

package.json 스크립트

로컬 인프라 (Docker)

프로젝트 구조

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API