Awwwards-mcp: INSANE0777 transforma sites premiados em código

O servidor MCP roda local como processo Node.js e depende de Playwright para capturar páginas reais. Ele indexa sites premiados com base FTS5 de stemmer e ranqueamento BM25, permitindo buscas como "dark 3D portfolio" ou "soft pastel e-commerce". A arquitetura divide-se em duas camadas: uma de inspiração (busca, detalhes, comparação) e outra de reconstrução (band-map, censo de motion, rebuild). Tudo isso funciona offline, exceto o download inicial de screenshots e dados de sites externos.

Arquitetura e funcionamento interno

O núcleo do awwwards-mcp é um servidor MCP escrito em TypeScript que expõe 26 ferramentas. A busca usa um índice FTS5 com stemmer e BM25, onde consultas de múltiplas palavras mantêm semântica AND — cada token precisa aparecer no mesmo site. O sistema captura screenshots reais via Playwright, com estratégias de espera como networkidle e suporte a viewports mobile (390×844) e desktop (1440×900). Para análise de motion, ele gera uma Motion Evidence Sheet com keyframes censurados, máscaras de diferença entre frames, composição em onion-skin e sobreposição de cursor — transformando vídeo em documento legível para modelos. A ferramenta build_project converte capturas em projetos Vite, Astro ou Next.js, com componentes JSX reais, CSS dividido em tokens e site, e carregamento ordenado de scripts. O modo --authored --motion emite motion.manifest.json com gatilhos medidos por seção e hooks de motion inertes. A versão v1.12.0 inclui ainda o binário awwwards-build-project e a ferramenta awwwards-verify com códigos de saída para CI (0 pass até 4 missing tool).

Adoção e maturidade

Instalar o awwwards-mcp exige Node.js e Playwright. O comando npm install -g awwwards-mcp instala o pacote globalmente, incluindo o binário awwwards-build-project. Na primeira execução, o servidor sincroniza o índice local com os sites premiados, o que pode levar alguns minutos dependendo da conexão. Depois disso, toda interação é offline: buscas, capturas e rebuilds rodam sem internet, exceto quando o usuário aponta para URLs externas. O projeto tem 37 dias de idade, 333 estrelas, 18 forks e apenas 2 issues abertas — sinal de comunidade ativa em um código recente. A licença MIT permite uso comercial, modificação e redistribuição sem restrições. No entanto, a ferramenta não serve para quem precisa de garantia de estabilidade a longo prazo ou suporte corporativo formal, já que é um projeto com menos de dois meses de vida. A versão mais recente, v1.12.0, traz melhorias como band-split v2 que reduziu uma banda de 20.631 px para 10 bandas, e modo compacto nas ferramentas mais pesadas com redução de ~38% no consumo de tokens.