SigmaUI DS MCP Server
Provides tools for developing screens with Nuxt 3 using SigmaUI DS components, including listing, searching, and getting component examples.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SigmaUI DS — MCP Server
Servidor MCP (Model Context Protocol) que expõe os componentes do SigmaUI DS para assistentes de IA consultarem durante o desenvolvimento de telas Vue 3 e Nuxt 3.
Stack
Tecnologia | Papel |
Bun | Runtime, bundler, test runner e gerenciador de pacotes |
Framework HTTP + adaptador MCP | |
SDK MCP (tools, resources, prompts) | |
AI SDK ( | Curadoria automática provider-agnostic |
Zod | Validação de schemas |
Formatação de SFC (Vue) e TypeScript gerado | |
Parser oficial para extração de slots via AST |
Related MCP server: MCP Vue UI Kit Server
Instalação
git clone <url-do-repositorio>
cd sigmaui-ds-mcp-server
bun install
cp .env.example .env
bun run devO servidor sobe em http://localhost:3333.
Docker
docker compose up -dO script
catalog:generateprecisa de acesso ao repositóriopd-sigmaui-ds— rode-o localmente antes de buildar a imagem.
Scripts
Script | Descrição |
| Desenvolvimento com hot-reload (HTTP) |
| Produção (HTTP) |
| Integração local com IDEs/CLIs (stdio) |
| MCP Inspector |
| Gera e curada componentes no catálogo |
| Executa testes |
| Testes em modo watch |
| Testes com cobertura |
Variáveis de ambiente
Variável | Padrão | Descrição |
|
| Porta do servidor HTTP |
|
| Origens CORS (separadas por vírgula) |
|
| Caminho para o repositório do DS |
|
| Pula curadoria IA |
|
| Provider: |
|
| Modelo do provider |
| — | API key Google AI Studio |
| — | API key Anthropic |
| — | API key OpenAI |
Ferramentas MCP
Ferramenta | Parâmetros | Descrição |
|
| Lista componentes com filtro por categoria |
|
| Documentação completa: props, eventos, slots, exemplo |
|
| Busca textual por nome, descrição ou categoria |
|
| Exemplo SFC completo (vue/nuxt) |
| — | Variantes de cor e tamanhos |
|
| Padrão de formulário com vee-validate + Zod |
|
| Sugere componentes para um caso de uso |
|
| Compara dois componentes lado a lado |
|
| Gera definição de colunas para DataTable |
Recursos MCP
URI | Descrição |
| Catálogo resumido (nome, categoria, descrição) |
| Detalhes JSON de um componente |
Prompts MCP
Prompt | Descrição |
| Gera prompt para implementar uma tela |
| Gera prompt para formulário com vee-validate + Zod |
| Revisa uso correto dos componentes |
| Guia curadoria de uma entrada do catálogo |
O argumento framework aceita "vue" (padrão) ou "nuxt".
Integração com clientes MCP
stdio (recomendado para uso local)
claude mcp add sigmaui-ds bun /caminho/absoluto/para/sigmaui-ds-mcp-server/src/stdio.tsHTTP (debug, deploy remoto)
bun run dev
claude mcp add sigmaui-ds --transport http http://localhost:3333/mcpManutenção do catálogo
O source of truth é src/data/catalog.json. O arquivo src/data/catalog.ts é derivado (gerado automaticamente).
Adicionando componentes
export GOOGLE_GENERATIVE_AI_API_KEY=sua-chave
bun run catalog:generateO pipeline:
Extrai metadados via
@vue/compiler-sfc(props, emits, slots via AST) e Storybook storiesCurada via AI SDK (provider-agnostic): corrige tipos, gera descrição/whenToUse/notes/exemplo
Formata exemplos SFC com Prettier (Vue parser,
singleAttributePerLine)Serializa
catalog.tscom Prettier (TypeScript parser)Detecta mudanças via hash SHA-256 (só reprocessa componentes alterados)
Componentes já curados são preservados — SKIP_CURATE=true não sobrescreve dados enriquecidos.
Outro provider
CURATE_PROVIDER=openai CURATE_MODEL=gpt-4.1-mini bun run catalog:generateTestes
bun run testArquivo | Cobertura |
| Health check, middleware origin validation |
| Markdown output, lookup, sugestões |
| matchesQuery, integração com catálogo |
| Branching vue/nuxt, formulários, curadoria |
| Utils do pipeline (toPascalCase, poolMap, hash) |
| resolveComponentName, parseSubComponents |
| formatSfcExample (Prettier) |
| Curadoria IA (MockLanguageModelV3) |
Estrutura
sigmaui-ds-mcp-server/
├── src/
│ ├── index.ts # Entry HTTP (Bun.serve + graceful shutdown)
│ ├── stdio.ts # Entry stdio (stderr logging)
│ ├── app.ts # Hono (CORS, origin validation, transport)
│ ├── mcp.ts # Orquestrador McpServer
│ ├── config.ts # Constantes (PORT, CORS)
│ ├── types.ts # ComponentInfo interface
│ ├── data/
│ │ ├── catalog.json # Source of truth (71 componentes)
│ │ └── catalog.ts # Derivado (gerado por Prettier)
│ ├── tools/ # 9 ferramentas MCP
│ ├── resources/ # Resources MCP (sigmaui://)
│ └── prompts/ # 4 prompts MCP
├── scripts/
│ ├── generate-catalog.ts # Orquestrador do pipeline
│ └── lib/
│ ├── extractors.ts # Parsing via @vue/compiler-sfc + Storybook
│ ├── curate.ts # AI SDK (provider-agnostic, .nullable() schema)
│ ├── serialize.ts # JSON.stringify + Prettier (Vue + TS)
│ ├── hashes.ts # SHA-256 change detection
│ ├── utils.ts # toPascalCase, poolMap, readSafe
│ └── preload.ts # Bun plugin (mock .vue/.css)
├── Dockerfile
├── docker-compose.yml
└── .env.exampleTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Build and manage your design system with AI: tokens, themes, components, icons, Figma and code.
Find UI components and themes, retrieve code, and generate with hosted 21st AI when enabled.
Serves your design system and coding standards to coding agents, so they stop guessing.
Orvain UI design system for React and Vue: real component props, variants and tokens for AI tools
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides AI assistants with access to WordPress Design System component information and design guidance.9GPL 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access documentation of Vue UI components, including props, events, and slots, for generating correct usage code.7MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, understand, and generate code for design system components by syncing and indexing a component library.ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access and manipulate Figma designs, including extracting design systems, creating and debugging UI components, and syncing design tokens bidirectionally.10,106 npmMIT