English Français العربية

io.github.Able-rip/agent-mosaic-skill

Official registry Media and design

Convert photos to LEGO-style brick mosaic previews with AI-powered color quantization.

Source code Documentation

What can you do with io.github.Able-rip/agent-mosaic-skill?

  • Same Engine as bmbrick.com — canonical color science, quantization, and 3D rendering pipeline
  • Local & Private — all processing happens on your machine via Node.js
  • Agent-Ready — ships with a SKILL.md for seamless agent workflow integration
  • 3D Render Mode — InstancedMesh PBR rendering with realistic brick studs

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @bmbrick/agent-mosaic-skill
Claude Code 
claude mcp add agent-mosaic-skill -- npx -y @bmbrick/agent-mosaic-skill@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "agent-mosaic-skill": {
            "command": "npx",
            "args": [
                "-y",
                "@bmbrick/agent-mosaic-skill@1.0.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BMBrick Photo-to-LEGO-Mosaic Skill
  2. Visual Previews
  3. Quick Start
  4. Tool: generate_lego_mosaic
  5. Unlock Full Project
  6. Features
  7. Engineering Docs
  8. Migrating from @bmbrick/agent-mosaic-skill
  9. Development
  10. License

BMBrick Photo-to-LEGO-Mosaic Skill

Convert any local photo into a LEGO-style brick mosaic preview — directly from your AI agent.

@bmbrick/photo-to-lego-mosaic-skill is an MCP server that lets Claude, Cursor, Windsurf, and other AI agents transform local images into high-fidelity 3D brick mosaics using the same canonical engine as bmbrick.com.

Renamed from @bmbrick/agent-mosaic-skill (the old name still works but is deprecated — please migrate to the new name for future updates).

Visual Previews

Generated with the generate_lego_mosaic tool (3D render mode):

Square Tiles (square_1x1)

Original Photo48x48 Preview64x64 Preview

Round Tiles (round_1x1)

Original Photo48x48 Preview64x64 Preview

For more case studies and mosaic examples, check out our Pinterest Showcase.

Quick Start

npx -y @bmbrick/photo-to-lego-mosaic-skill
MCP Client Configuration

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"]
    }
  }
}

Tool: generate_lego_mosaic

ParameterTypeRequiredDefaultDescription
imagePathstringYes—Absolute path to a local image
columnsnumberNo48Preview width in studs (max 64)
rowsnumberNo48Preview height in studs (max 64)
materialModestringNosquare_1x1square_1x1 or round_1x1
renderModestringNo3DRender style
removeBackgroundbooleanNofalseClean up white/transparent backgrounds

Returns: a local watermarked PNG preview + a link to unlock the full project at bmbrick.com.

Unlock Full Project

The preview is watermarked and intended for creative exploration. To get the complete deliverables — HD unwatermarked mosaic, brick-by-brick PDF instructions, parts list with ordering links, and CSV/XML placement matrices — visit bmbrick.com.

Features

  • Same Engine as bmbrick.com — canonical color science, quantization, and 3D rendering pipeline
  • Local & Private — all processing happens on your machine via Node.js
  • Agent-Ready — ships with a SKILL.md for seamless agent workflow integration
  • 3D Render Mode — InstancedMesh PBR rendering with realistic brick studs

Engineering Docs

Deep technical reference for the color quantization pipeline that powers this skill and bmbrick.com:

  • Color quantization pipeline: principles, history, and lessons — current architecture, architectural decisions, verified principles, failed experiments from 25+ versions of iteration, and parameter sensitivity reference.

Migrating from @bmbrick/agent-mosaic-skill

If you were using the old name, the migration is one search/replace:

  1. Package name: @bmbrick/agent-mosaic-skill → @bmbrick/photo-to-lego-mosaic-skill
  2. MCP tool name (in your agent's tool list): generate_bmbrick_mosaic → generate_lego_mosaic
  3. Binary name (rare): agent-mosaic-skill → photo-to-lego-mosaic-skill

The tool parameters (imagePath, columns, rows, etc.) and return shape are unchanged.

Development

License

Dual-licensed:

  • MIT — MCP wrapper, skill/ directory, agent integration surface
  • Restricted — dist/ engine files: free to use and distribute as-is, but no de-obfuscation, reverse engineering, or redistribution of modified versions

See LICENSE for full terms.

Frequently asked questions

What is io.github.Able-rip/agent-mosaic-skill?

Convert photos to LEGO-style brick mosaic previews with AI-powered color quantization.

How do I install io.github.Able-rip/agent-mosaic-skill?

It runs on your machine. In Claude Code: claude mcp add agent-mosaic-skill -- npx -y @bmbrick/agent-mosaic-skill@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Able-rip/agent-mosaic-skill need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Able-rip/agent-mosaic-skill open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Able-rip/agent-mosaic-skill?

It is published by Able-rip. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.