BMBrick Agent Mosaic Skill

BMBrick Photo-to-LEGO-Mosaic Skill

Converta qualquer foto local em uma prévia de mosaico de tijolos estilo LEGO — diretamente do seu agente de IA.

@bmbrick/photo-to-lego-mosaic-skill é um servidor MCP que permite que Claude, Cursor, Windsurf e outros agentes de IA transformem imagens locais em mosaicos de tijolos 3D de alta fidelidade usando o mesmo mecanismo canônico do bmbrick.com.

Renomeado de @bmbrick/agent-mosaic-skill (o nome antigo ainda funciona, mas está obsoleto — migre para o novo nome para futuras atualizações).

Pré-visualizações Visuais

Gerado com a ferramenta generate_lego_mosaic (modo de renderização 3D):

Peças Quadradas (square_1x1)

Foto Original	Prévia 48x48	Prévia 64x64

Peças Redondas (round_1x1)

Foto Original	Prévia 48x48	Prévia 64x64

Para mais estudos de caso e exemplos de mosaicos, confira nosso Pinterest Showcase.

Início Rápido

npx -y @bmbrick/photo-to-lego-mosaic-skill

Configuração do Cliente MCP

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "lego-mosaic": {
      "command": "npx",
      "args": ["-y", "@bmbrick/photo-to-lego-mosaic-skill"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "lego-mosaic": {
      "command": "npx",
      "args": ["-y", "@bmbrick/photo-to-lego-mosaic-skill"]
    }
  }
}

Ferramenta: generate_lego_mosaic

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
imagePath	string	Sim	—	Caminho absoluto para uma imagem local
columns	number	Não	48	Largura da prévia em studs (máx. 64)
rows	number	Não	48	Altura da prévia em studs (máx. 64)
materialMode	string	Não	square_1x1	square_1x1 ou round_1x1
renderMode	string	Não	3D	Estilo de renderização
removeBackground	boolean	Não	false	Limpar fundos brancos/transparentes

Retorna: uma prévia PNG local com marca d'água + um link para desbloquear o projeto completo em bmbrick.com.

Desbloquear Projeto Completo

A prévia tem marca d'água e é destinada à exploração criativa. Para obter os entregáveis completos — mosaico HD sem marca d'água, instruções em PDF tijolo por tijolo, lista de peças com links de pedido e matrizes de posicionamento CSV/XML — visite bmbrick.com.

Recursos

• Mesmo mecanismo do bmbrick.com — pipeline canônico de ciência de cores, quantização e renderização 3D
• Local e Privado — todo o processamento acontece na sua máquina via Node.js
• Pronto para Agentes — acompanha um SKILL.md para integração perfeita com fluxos de trabalho de agentes
• Modo de Renderização 3D — renderização PBR InstancedMesh com studs de tijolo realistas

Documentação de Engenharia

Referência técnica aprofundada para o pipeline de quantização de cores que alimenta esta habilidade e o bmbrick.com:

• Pipeline de quantização de cores: princípios, história e lições — arquitetura atual, decisões arquiteturais, princípios verificados, experimentos falhos de mais de 25 versões de iteração e referência de sensibilidade de parâmetros.
  • 🇬🇧 English
  • 🇨🇳 中文

Migrando de @bmbrick/agent-mosaic-skill

Se você estava usando o nome antigo, a migração é uma busca/substituição:

1. Nome do pacote: @bmbrick/agent-mosaic-skill → @bmbrick/photo-to-lego-mosaic-skill
2. Nome da ferramenta MCP (na lista de ferramentas do seu agente): generate_bmbrick_mosaic → generate_lego_mosaic
3. Nome do binário (raro): agent-mosaic-skill → photo-to-lego-mosaic-skill

Os parâmetros da ferramenta (imagePath, columns, rows, etc.) e o formato de retorno permanecem inalterados.

Desenvolvimento

Licença

Licenciamento duplo:

• MIT — wrapper MCP, diretório skill/, superfície de integração de agentes
• Restrito — arquivos do mecanismo dist/: uso e distribuição livres como estão, mas sem desofuscação, engenharia reversa ou redistribuição de versões modificadas

Consulte LICENSE para os termos completos.