@alphatechia/mcp

Servidor MCP (Model Context Protocol) do AlphaTech Design System. Expõe o DS — componentes, tokens da marca e a linguagem visual "Traço Contínuo" — para qualquer agente de IA (Claude Code, Cursor, Windsurf, etc.), para que ele construa interfaces no padrão da marca, sem recriar componentes nem inventar CSS genérico.

É um servidor read-only / de conhecimento: ele informa, o agente é que escreve a tela e roda o shadcn add. Não escreve arquivos no seu projeto.

Tools

| Tool | O que faz | | --- | --- | | list_components | Catálogo completo (nome, tipo, descrição, plataformas). | | search_components | Busca por palavra-chave (ex: "senha", "modal"). | | get_component | Código-fonte de um componente + deps + comando de install. | | get_tokens | Cores, gradientes, superfícies, elevação, raios, motion, tipografia. | | get_design_language | As regras "Traço Contínuo" (princípios + regras de ouro). | | get_setup_guide | Receita de bootstrap para app nova (CSS vars + Tailwind extend). |

Configuração

pnpm --filter @alphatechia/mcp build

Claude Code

.mcp.json na raiz do projeto onde você for desenvolver:

{
  "mcpServers": {
    "alphatech-ds": {
      "command": "node",
      "args": ["/caminho/para/alphatech-ds/packages/mcp/dist/index.js"]
    }
  }
}

(ou claude mcp add alphatech-ds -- node /caminho/.../dist/index.js)

Cursor / Windsurf

~/.cursor/mcp.json (ou equivalente), mesmo formato command + args.

Variáveis de ambiente

| Var | Default | Uso | | --- | --- | --- | | ALPHATECH_REGISTRY_URL | https://test-alphatech-ds.lh6c5d.easypanel.host/r | Aponta para outro registry. Para dev local, use o caminho absoluto de apps/docs/public/r. |

"env": { "ALPHATECH_REGISTRY_URL": "/abs/alphatech-ds/apps/docs/public/r" }

Fonte de verdade

• Componentes: lidos ao vivo do registry (URL acima) — sempre em sincronia com registry:build.
• Tokens e linguagem: hoje embutidos em src/data/ (espelho fiel de registry/tokens/colors.ts e LANGUAGE.md). Tokens de marca são estáveis, mas para drift-zero o passo seguinte é o build-registry emitir tokens.json + language.json em /r/ e este pacote passar a lê-los como faz com os componentes.