Bmbrick Photo To Lego Mosaic Skill

BMBrick 照片转 LEGO 马赛克技能

直接通过你的 AI Agent，将任意本地照片转换为 LEGO 风格的积木马赛克预览。

@bmbrick/photo-to-lego-mosaic-skill 是一个 MCP 服务，可让 Claude、Cursor、Windsurf 和其他 AI Agent 使用与 bmbrick.com 相同的标准引擎，将本地图片转换为高保真 3D 积木马赛克。

已从 @bmbrick/agent-mosaic-skill 更名（旧名称仍可使用，但已弃用——请迁移到新名称，以便获取后续更新）。

视觉预览

使用 generate_lego_mosaic 工具生成（3D 渲染模式）：

方形砖块（square_1x1）

原始照片	48x48 预览	64x64 预览

圆形砖块（round_1x1）

原始照片	48x48 预览	64x64 预览

更多案例研究和马赛克示例，请访问我们的 Pinterest 展示页。

快速开始

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

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

工具：generate_lego_mosaic

参数	类型	必填	默认值	描述
imagePath	string	是	—	本地图片的绝对路径
columns	number	否	48	预览宽度，以凸点为单位（最大 64）
rows	number	否	48	预览高度，以凸点为单位（最大 64）
materialMode	string	否	square_1x1	square_1x1 或 round_1x1
renderMode	string	否	3D	渲染风格
removeBackground	boolean	否	false	清理白色／透明背景

返回内容：带本地水印的 PNG 预览，以及用于解锁完整项目的链接，见 bmbrick.com。

解锁完整项目

预览带有水印，旨在用于创意探索。如需获取完整交付内容——无水印高清马赛克、逐块 PDF 说明、附带订购链接的零件清单，以及 CSV/XML 放置矩阵——请访问 bmbrick.com。

功能

• 与 bmbrick.com 使用相同引擎——标准色彩科学、量化和 3D 渲染流程
• 本地处理，保护隐私——所有处理均通过 Node.js 在你的设备上完成
• 为 Agent 做好准备——附带 SKILL.md，可无缝集成到 Agent 工作流中
• 3D 渲染模式——采用 InstancedMesh PBR 渲染，并呈现逼真的积木凸点

工程文档

深入了解为此技能和 bmbrick.com 提供支持的色彩量化流程：

• 色彩量化流程：原理、历史与经验——当前架构、架构决策、经验证的原理、经过 25 多个版本迭代的失败实验，以及参数敏感性参考。
  • 🇬🇧 English
  • 🇨🇳 中文

从 @bmbrick/agent-mosaic-skill 迁移

如果你使用的是旧名称，只需进行一次搜索并替换：

1. 包名称： @bmbrick/agent-mosaic-skill → @bmbrick/photo-to-lego-mosaic-skill
2. MCP 工具名称（在你的 Agent 工具列表中）：generate_bmbrick_mosaic → generate_lego_mosaic
3. 二进制文件名称（少见）：agent-mosaic-skill → photo-to-lego-mosaic-skill

工具参数（imagePath、columns、rows 等）和返回结构保持不变。

开发

许可证

采用双重许可：

• MIT — MCP 封装、skill/ 目录、Agent 集成接口
• 受限 — dist/ 引擎文件：可免费按原样使用和分发，但不得去混淆、逆向工程或重新分发修改后的版本

完整条款请参阅 LICENSE。