generate_lego_mosaicLABSCO SUMMARY
One tool, one job, and the real engine behind it.
The colour science and rendering are the same ones the vendor's own site runs, so the preview is a faithful look at what the physical build would be rather than an approximation made for the agent. Treat it as the exploration step: the buildable outputs — instructions, parts list, placement matrices — come from the paid site.
What it is
A single-tool MCP server that converts a local image into a 3D-rendered brick mosaic. It runs the same colour-quantization and rendering pipeline as bmbrick.com, on your own machine through Node, and returns a watermarked PNG preview plus a link to unlock the full project. The tool was renamed from generate_bmbrick_mosaic to generate_lego_mosaic, and the package from @bmbrick/agent-mosaic-skill to @bmbrick/photo-to-lego-mosaic-skill; parameters and return shape are unchanged.
What you get
- A brick mosaic rendered from an absolute path to a local image —
generate_lego_mosaic - A stud grid you choose:
columnsandrowsdefault to 48 and go up to 64 - Square or round tiles via
materialMode, set tosquare_1x1orround_1x1 - 3D rendering with realistic studs, rather than a flat pixel grid
- Optional background removal for white or transparent backgrounds, via
removeBackground - Local processing — the image is read from your disk and the render happens on your machine
- A
SKILL.mdin the package, so agents that read skill files pick up the workflow without extra prompting
Requirements
No account and no key. Run npx -y @bmbrick/photo-to-lego-mosaic-skill (published as @bmbrick/photo-to-lego-mosaic-skill 2.0.2) over stdio; the tool takes an absolute path, so the image has to be on the same machine. What comes back is a watermarked preview: the unwatermarked mosaic, the brick-by-brick PDF instructions, the parts list with ordering links and the placement matrices are bought at bmbrick.com. The npm wrapper and skill directory are MIT; the engine files in dist/ are free to use and redistribute as-is but not to reverse-engineer or modify.
Setup effort
One command — npx -y @bmbrick/photo-to-lego-mosaic-skill
USE CASES
01
Seeing whether a photo works as a mosaic at all
Render it at the default grid and look at whether the subject survives quantization. Faces and high-contrast subjects hold up; busy backgrounds usually do not, which is what removeBackground is for.
02
Choosing a size before you commit to buying bricks
Render the same image at a smaller and a larger stud count and compare detail side by side, up to the 64 ceiling on each axis.
03
Deciding between square and round tiles
Run the image once as square_1x1 and once as round_1x1 — the two read very differently at the same resolution, and the choice changes the parts you would order.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @bmbrick/photo-to-lego-mosaic-skillMCP Clients
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"lego-mosaic": {
"command": "npx",
"args": [
"-y",
"@bmbrick/photo-to-lego-mosaic-skill"
]
}
}
}
