Bmbrick Agent Mosaic Skill

BMBrick 写真からLEGOモザイクを生成するスキル

AI エージェントから、ローカルの写真をLEGO風のブロックモザイクプレビューに直接変換できます。

@bmbrick/photo-to-lego-mosaic-skill は MCP サーバーです。Claude、Cursor、Windsurf などの AI エージェントが、bmbrick.com と同じ標準エンジンを使って、ローカル画像を高精度の3Dブロックモザイクに変換できます。

@bmbrick/agent-mosaic-skill から名称を変更しました（旧名称も引き続き動作しますが、非推奨です。今後の更新を受け取るには、新しい名称に移行してください）。

ビジュアルプレビュー

generate_lego_mosaic ツール（3Dレンダーモード）で生成：

正方形タイル（square_1x1）

元の写真	48x48 プレビュー	64x64 プレビュー

丸型タイル（round_1x1）

元の写真	48x48 プレビュー	64x64 プレビュー

その他の制作事例やモザイクの例については、Pinterest Showcaseをご覧ください。

クイックスタート

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 を介して、すべての処理がご利用のマシン上で行われます
• エージェント対応 — エージェントのワークフローにシームレスに統合できる SKILL.md が付属しています
• 3Dレンダーモード — 現実的なブロックのスタッドを再現する InstancedMesh PBR レンダリング

技術ドキュメント

このスキルとbmbrick.comを支える色量子化パイプラインの詳細な技術資料：

• 色量子化パイプライン：原則、歴史、教訓 — 現在のアーキテクチャ、設計上の決定事項、検証済みの原則、25回以上の反復での失敗した実験、パラメーター感度の資料。
  • 🇬🇧 英語
  • 🇨🇳 中国語

@bmbrick/agent-mosaic-skill からの移行

以前の名前を使用していた場合、移行は検索と置換だけで完了します。

1. パッケージ名： @bmbrick/agent-mosaic-skill → @bmbrick/photo-to-lego-mosaic-skill
2. MCP ツール名（エージェントのツール一覧内）：generate_bmbrick_mosaic → generate_lego_mosaic
3. バイナリ名（まれ）：agent-mosaic-skill → photo-to-lego-mosaic-skill

ツールのパラメーター（imagePath、columns、rows など）と戻り値の形式は変更ありません。

開発

ライセンス

デュアルライセンスです。

• MIT — MCP ラッパー、skill/ ディレクトリ、エージェント統合インターフェース
• 制限付き — dist/ エンジンファイル：そのまま使用および配布できますが、難読化解除、リバースエンジニアリング、変更版の再配布は禁止されています

詳細な条件については、LICENSE をご覧ください。