bunge-ds-mcp

@bunge/ds-components デザインシステムのコンポーネントカタログを公開するMCP (Model Context Protocol) サーバーです。AIアシスタントがコンポーネントのリスト表示、検索、および入力、出力、使用例、インポート手順を含む詳細情報の取得を行えるようにします。

このサーバーは stdio を介して通信します（HTTPポートは公開しません）。通信はプロセス自体を通じて行われ、MCPクライアント（例：VS Code Copilot）に直接統合されます。

Tools

Tool	説明
`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`	ウォッチモードでコンパイルします（変更のたびに自動再コンパイル）
`dev:inspect`	`tsc && npx @modelcontextprotocol/inspector node dist/index.js`	コンパイルしてMCP Inspectorを開き、ツールを対話的にテストします
`test`	`vitest run`	ユニットテストを1回実行します
`test:watch`	`vitest`	ウォッチモードでテストを実行します
`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