{"_id":"@bmbrick/agent-mosaic-skill","_rev":"5-938c75a95beb19ed593a10e3df164cf9","name":"@bmbrick/agent-mosaic-skill","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@bmbrick/agent-mosaic-skill","version":"1.0.0","keywords":["bmbrick","mosaic","lego","mcp","agent-skill"],"author":{"name":"BMBrick"},"license":"SEE LICENSE IN LICENSE","_id":"@bmbrick/agent-mosaic-skill@1.0.0","maintainers":[{"name":"ripable","email":"A659120996@gmail.com"}],"bin":{"agent-mosaic-skill":"dist/mcp-server.js"},"dist":{"shasum":"2da2004e19b2d7379b1a64393ad596deb0a5cfb8","tarball":"https://registry.npmjs.org/@bmbrick/agent-mosaic-skill/-/agent-mosaic-skill-1.0.0.tgz","fileCount":14,"integrity":"sha512-BFWnka/7auxGtumlEm3gD8ejat7d+imD/pKo3ND/ZJUfkqBPhXN7MWqVU02my6Rz62Z6RmYzjb36o9d/7HG/UA==","signatures":[{"sig":"MEUCIEExOuvPJmkpF7VITUiaH6lhPj//6PsFoF0x1OqAJL4gAiEA8VSLrwfZ5Fy3t9+JkYbEwwpekPONTUTpdds8ss+ErfA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":367514},"main":"./dist/index.js","type":"module","exports":{".":"./dist/index.js","./mcp":"./dist/mcp-server.js"},"scripts":{"test":"node --test test/*.test.mjs"},"_npmUser":{"name":"ripable","email":"A659120996@gmail.com"},"_npmVersion":"11.9.0","description":"Preview-only local BMBrick mosaic generator for Agent and MCP workflows.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"sharp":"^0.34.5","canvas":"^3.2.3","javascript-obfuscator":"^5.4.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-mosaic-skill_1.0.0_1778516239874_0.06091267399766509","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @bmbrick/photo-to-lego-mosaic-skill. Please migrate: npm install @bmbrick/photo-to-lego-mosaic-skill"},"1.0.1":{"name":"@bmbrick/agent-mosaic-skill","version":"1.0.1","keywords":["bmbrick","mosaic","lego","mcp","model-context-protocol","agent-skill","pixel-art","image-processing","bricks"],"author":{"name":"BMBrick"},"license":"SEE LICENSE IN LICENSE","_id":"@bmbrick/agent-mosaic-skill@1.0.1","maintainers":[{"name":"ripable","email":"A659120996@gmail.com"}],"bin":{"agent-mosaic-skill":"dist/mcp-server.js"},"dist":{"shasum":"600b41446e5d7cd17f1134f2b817d1b9f2e8ab11","tarball":"https://registry.npmjs.org/@bmbrick/agent-mosaic-skill/-/agent-mosaic-skill-1.0.1.tgz","fileCount":12,"integrity":"sha512-umU4g6wOlb1W4aaDsz6UISk1edWMqTAw/m2ov8sC6zvAzAZGaT3obMBXnyMyFANbtt9m4CO7VkJ1DJ+bmYUPqg==","signatures":[{"sig":"MEQCIBhi83bZ6630cn96YOOk9AkN2RTjVBIOvTWnq5fecN4MAiAo7S4jhFOxMF3vBDuRZQDMs2UHPqRn4zDXJJCefxD53Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":365502},"main":"./dist/index.js","type":"module","exports":{".":"./dist/index.js","./mcp":"./dist/mcp-server.js"},"gitHead":"f88956a160b09eedc422e6eb24a696c14949e25f","scripts":{"test":"npm run build && node --test test/*.test.mjs","build":"node scripts/build.js","smoke":"node test/smoke.mjs","prepack":"npm test","sync:core":"node scripts/sync-core.js"},"_npmUser":{"name":"ripable","email":"A659120996@gmail.com"},"_npmVersion":"11.9.0","description":"The official BMBrick AI engine for converting local images into high-fidelity LEGO-style mosaic previews.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"sharp":"^0.34.5","canvas":"^3.2.3","javascript-obfuscator":"^5.4.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-mosaic-skill_1.0.1_1778522581348_0.9663405083651657","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @bmbrick/photo-to-lego-mosaic-skill. Please migrate: npm install @bmbrick/photo-to-lego-mosaic-skill"},"1.0.2":{"name":"@bmbrick/agent-mosaic-skill","version":"1.0.2","keywords":["bmbrick","mosaic","lego","mcp","model-context-protocol","agent-skill","pixel-art","image-processing","bricks"],"author":{"name":"BMBrick"},"license":"SEE LICENSE IN LICENSE","_id":"@bmbrick/agent-mosaic-skill@1.0.2","maintainers":[{"name":"ripable","email":"A659120996@gmail.com"}],"homepage":"https://github.com/Able-rip/agent-mosaic-skill#readme","bugs":{"url":"https://github.com/Able-rip/agent-mosaic-skill/issues"},"bin":{"agent-mosaic-skill":"dist/mcp-server.js"},"dist":{"shasum":"40c4c631cd379ff455df6683023a1d159c019913","tarball":"https://registry.npmjs.org/@bmbrick/agent-mosaic-skill/-/agent-mosaic-skill-1.0.2.tgz","fileCount":12,"integrity":"sha512-uobQRfQOVHCvL6wN4YtkSPnLiFxQHzo0oIgs/u5aDxJLpoTb00aWseLrm9JhtBbKOK7IFPrxxpsRWLKZAABjfA==","signatures":[{"sig":"MEYCIQDW7aPzVgk39IWEzw5XmsKI0jpwcNMkQWLUfxcfBQW8hAIhAKgwaxbNpTlC2A+ToQ3ExUqV5KKtIPRJjpv/dPdfLSZw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":365662},"main":"./dist/index.js","type":"module","exports":{".":"./dist/index.js","./mcp":"./dist/mcp-server.js"},"gitHead":"5d238f46056a157b3fae0d3a7937dcdbe6903f7a","mcpName":"io.github.Able-rip/agent-mosaic-skill","scripts":{"test":"npm run build && node --test test/*.test.mjs","build":"node scripts/build.js","smoke":"node test/smoke.mjs","prepack":"npm test","sync:core":"node scripts/sync-core.js"},"_npmUser":{"name":"ripable","email":"A659120996@gmail.com"},"repository":{"url":"git+https://github.com/Able-rip/agent-mosaic-skill.git","type":"git"},"_npmVersion":"11.9.0","description":"The official BMBrick AI engine for converting local images into high-fidelity LEGO-style mosaic previews.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"sharp":"^0.34.5","canvas":"^3.2.3","javascript-obfuscator":"^5.4.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-mosaic-skill_1.0.2_1778600911732_0.2034709126917773","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @bmbrick/photo-to-lego-mosaic-skill. Please migrate: npm install @bmbrick/photo-to-lego-mosaic-skill"},"1.1.0":{"name":"@bmbrick/agent-mosaic-skill","version":"1.1.0","keywords":["bmbrick","mosaic","lego","mcp","model-context-protocol","agent-skill","pixel-art","image-processing","bricks"],"author":{"name":"BMBrick"},"license":"SEE LICENSE IN LICENSE","_id":"@bmbrick/agent-mosaic-skill@1.1.0","maintainers":[{"name":"ripable","email":"A659120996@gmail.com"}],"homepage":"https://github.com/Able-rip/agent-mosaic-skill#readme","bugs":{"url":"https://github.com/Able-rip/agent-mosaic-skill/issues"},"bin":{"agent-mosaic-skill":"dist/mcp-server.js"},"dist":{"shasum":"9a769837a630b4d66e66364e377bce3a3ac4107a","tarball":"https://registry.npmjs.org/@bmbrick/agent-mosaic-skill/-/agent-mosaic-skill-1.1.0.tgz","fileCount":12,"integrity":"sha512-O5jgiur8nb1JvmV1ZBoiNyPLcMBTDdaTPf0tvSsVGAjfra/YCSOD5vwd2Kt6wA3IhvoSb7fTtk2zLrYvQbZ1ng==","signatures":[{"sig":"MEUCIEnGCHjBCKXwGzDh74kF4LDgIqoZyLzodUGpY7D81alJAiEAgzsCuEon+cTN4G0q+eTlWLjV8oX/2MUYi1O27oEJg8U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":536857},"main":"./dist/index.js","type":"module","exports":{".":"./dist/index.js","./mcp":"./dist/mcp-server.js"},"gitHead":"ef4d1cca02da81ea9a9d96e36f3fe2185e948590","mcpName":"io.github.Able-rip/agent-mosaic-skill","scripts":{"test":"npm run build && node --test test/*.test.mjs","build":"node scripts/build.js","smoke":"node test/smoke.mjs","prepack":"npm test","sync:core":"node scripts/sync-core.js"},"_npmUser":{"name":"ripable","email":"A659120996@gmail.com"},"repository":{"url":"git+https://github.com/Able-rip/agent-mosaic-skill.git","type":"git"},"_npmVersion":"11.9.0","description":"The official BMBrick AI engine for converting local images into high-fidelity LEGO-style mosaic previews.","directories":{},"_nodeVersion":"24.14.0","dependencies":{"sharp":"^0.34.5","canvas":"^3.2.3","javascript-obfuscator":"^5.4.2","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-mosaic-skill_1.1.0_1778685741872_0.3989118098992428","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Renamed to @bmbrick/photo-to-lego-mosaic-skill. Please migrate: npm install @bmbrick/photo-to-lego-mosaic-skill"}},"time":{"created":"2026-05-11T16:17:19.711Z","modified":"2026-05-24T08:49:57.603Z","1.0.0":"2026-05-11T16:17:20.123Z","1.0.1":"2026-05-11T18:03:01.500Z","1.0.2":"2026-05-12T15:48:31.896Z","1.1.0":"2026-05-13T15:22:22.097Z"},"bugs":{"url":"https://github.com/Able-rip/agent-mosaic-skill/issues"},"author":{"name":"BMBrick"},"license":"SEE LICENSE IN LICENSE","homepage":"https://github.com/Able-rip/agent-mosaic-skill#readme","keywords":["bmbrick","mosaic","lego","mcp","model-context-protocol","agent-skill","pixel-art","image-processing","bricks"],"repository":{"url":"git+https://github.com/Able-rip/agent-mosaic-skill.git","type":"git"},"description":"The official BMBrick AI engine for converting local images into high-fidelity LEGO-style mosaic previews.","maintainers":[{"name":"ripable","email":"A659120996@gmail.com"}],"readme":"# BMBrick Agent Mosaic Skill\n\n[![npm version](https://img.shields.io/npm/v/@bmbrick/agent-mosaic-skill)](https://www.npmjs.com/package/@bmbrick/agent-mosaic-skill)\n[![License](https://img.shields.io/badge/license-MIT%20%2B%20Restricted-blue)](#license)\n\nConvert any local photo into a LEGO-style brick mosaic preview — directly from your AI agent.\n\n`@bmbrick/agent-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](https://bmbrick.com).\n\n## Visual Previews\n\nGenerated with the `generate_bmbrick_mosaic` tool (3D render mode):\n\n**Square Tiles (`square_1x1`)**\n\n| Original Photo | 48x48 Preview | 64x64 Preview |\n| :--- | :--- | :--- |\n| ![Original](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_original_photo.png) | ![48x48](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_mosaic_preview.png) | ![64x64](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_mosaic_64x64.png) |\n\n**Round Tiles (`round_1x1`)**\n\n| Original Photo | 48x48 Preview | 64x64 Preview |\n| :--- | :--- | :--- |\n| ![Original](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_original_photo.png) | ![48x48 Round](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_mosaic_round_48x48.png) | ![64x64 Round](https://raw.githubusercontent.com/Able-rip/agent-mosaic-skill/main/assets/cat_mosaic_round_64x64.png) |\n\n## Quick Start\n\n```bash\nnpx -y @bmbrick/agent-mosaic-skill\n```\n\n### MCP Client Configuration\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"bmbrick-mosaic\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bmbrick/agent-mosaic-skill\"]\n    }\n  }\n}\n```\n\n**Cursor** (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"bmbrick-mosaic\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bmbrick/agent-mosaic-skill\"]\n    }\n  }\n}\n```\n\n## Tool: `generate_bmbrick_mosaic`\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `imagePath` | string | Yes | — | Absolute path to a local image |\n| `columns` | number | No | 48 | Preview width in studs (max 64) |\n| `rows` | number | No | 48 | Preview height in studs (max 64) |\n| `materialMode` | string | No | `square_1x1` | `square_1x1` or `round_1x1` |\n| `renderMode` | string | No | `3D` | Render style |\n| `removeBackground` | boolean | No | false | Clean up white/transparent backgrounds |\n\nReturns: a local watermarked PNG preview + a link to unlock the full project at [bmbrick.com](https://bmbrick.com).\n\n## Unlock Full Project\n\nThe 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](https://bmbrick.com).\n\n## Features\n\n- **Same Engine as bmbrick.com** — canonical color science, quantization, and 3D rendering pipeline\n- **Local & Private** — all processing happens on your machine via Node.js\n- **Agent-Ready** — ships with a `SKILL.md` for seamless agent workflow integration\n- **3D Render Mode** — InstancedMesh PBR rendering with realistic brick studs\n\n## Development\n\n## License\n\nDual-licensed:\n\n- **MIT** — MCP wrapper, `skill/` directory, agent integration surface\n- **Restricted** — `dist/` engine files: free to use and distribute as-is, but no de-obfuscation, reverse engineering, or redistribution of modified versions\n\nSee [LICENSE](LICENSE) for full terms.\n","readmeFilename":"README.md"}