BMBrick Agent Mosaic Skill

Habilidad BMBrick de Foto a Mosaico LEGO

Convierte cualquier foto local en una vista previa de mosaico de ladrillos estilo LEGO, directamente desde tu agente de IA.

@bmbrick/photo-to-lego-mosaic-skill es un servidor MCP que permite a Claude, Cursor, Windsurf y otros agentes de IA transformar imágenes locales en mosaicos de ladrillos 3D de alta fidelidad utilizando el mismo motor canónico que bmbrick.com.

Renombrado desde @bmbrick/agent-mosaic-skill (el nombre antiguo sigue funcionando pero está obsoleto; migra al nuevo nombre para futuras actualizaciones).

Vistas previas visuales

Generadas con la herramienta generate_lego_mosaic (modo de renderizado 3D):

Baldosas cuadradas (square_1x1)

Foto original	Vista previa 48x48	Vista previa 64x64

Baldosas redondas (round_1x1)

Foto original	Vista previa 48x48	Vista previa 64x64

Para más casos de estudio y ejemplos de mosaicos, consulta nuestro Escaparate de Pinterest.

Inicio rápido

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

Configuración del 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"]
    }
  }
}

Herramienta: generate_lego_mosaic

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
imagePath	string	Sí	—	Ruta absoluta a una imagen local
columns	number	No	48	Ancho de la vista previa en studs (máx. 64)
rows	number	No	48	Alto de la vista previa en studs (máx. 64)
materialMode	string	No	square_1x1	square_1x1 o round_1x1
renderMode	string	No	3D	Estilo de renderizado
removeBackground	boolean	No	false	Limpiar fondos blancos/transparentes

Devuelve: una vista previa PNG local con marca de agua + un enlace para desbloquear el proyecto completo en bmbrick.com.

Desbloquear el proyecto completo

La vista previa tiene marca de agua y está pensada para la exploración creativa. Para obtener los entregables completos — mosaico HD sin marca de agua, instrucciones PDF ladrillo a ladrillo, lista de piezas con enlaces de pedido y matrices de colocación CSV/XML — visita bmbrick.com.

Características

• Mismo motor que bmbrick.com — ciencia del color canónica, cuantización y pipeline de renderizado 3D
• Local y privado — todo el procesamiento ocurre en tu máquina mediante Node.js
• Listo para agentes — incluye un SKILL.md para una integración fluida con flujos de trabajo de agentes
• Modo de renderizado 3D — renderizado PBR InstancedMesh con studs de ladrillo realistas

Documentación de ingeniería

Referencia técnica detallada del pipeline de cuantización de color que impulsa esta habilidad y bmbrick.com:

• Pipeline de cuantización de color: principios, historia y lecciones — arquitectura actual, decisiones arquitectónicas, principios verificados, experimentos fallidos de más de 25 versiones de iteración y referencia de sensibilidad de parámetros.
  • 🇬🇧 English
  • 🇨🇳 中文

Migración desde @bmbrick/agent-mosaic-skill

Si estabas usando el nombre antiguo, la migración es una búsqueda/reemplazo:

1. Nombre del paquete: @bmbrick/agent-mosaic-skill → @bmbrick/photo-to-lego-mosaic-skill
2. Nombre de la herramienta MCP (en la lista de herramientas de tu agente): generate_bmbrick_mosaic → generate_lego_mosaic
3. Nombre del binario (raro): agent-mosaic-skill → photo-to-lego-mosaic-skill

Los parámetros de la herramienta (imagePath, columns, rows, etc.) y la forma de retorno no cambian.

Desarrollo

Licencia

Con doble licencia:

• MIT — envoltorio MCP, directorio skill/, superficie de integración de agentes
• Restringida — archivos del motor dist/: uso y distribución libres tal como están, pero sin desofuscación, ingeniería inversa ni redistribución de versiones modificadas

Consulta LICENSE para conocer los términos completos.