拼豆工坊· Beadloom
OceanZhengYang/beadloom-mcp
0 Stars
17 次浏览
OceanZhengYang
更新于 2026-08-23
该服务暂未提供标准配置，请参考 README 手动接入
服务介绍
拼豆工坊· Beadloom MCP
把任意照片、角色图、宠物图或像素画转换为真正可施工的拼豆方案。工具不只做“像素化”：它会完成自适应取色或主题色板映射、裁切、去背景、渐变抖动、杂点清理、用豆统计和 29×29 标准底板规划，并输出一整套制作文件。
能做什么
- 生成带真实豆孔质感的拼豆成品预览
- 生成逐格编号的高清施工图
- 自动统计总豆数、各颜色用量与成品尺寸
- 自动计算 29×29 底板行列与分页施工范围
- 一次返回 ZIP 成套文件：预览 PNG、编号 PNG、材料 CSV、分页 PDF、JSON 清单
- 支持 12–128 格、4–64 色、Midi 5.0 mm 与 Mini 2.6 mm
MCP 地址
本服务使用 Streamable HTTP：
https://studio-oceanzhengyang-beadloom-studio.api-inference.modelscope.net/gradio_api/mcp/
客户端配置示例：
{
"mcpServers": {
"beadloom": {
"type": "streamable_http",
"url": "https://studio-oceanzhengyang-beadloom-studio.api-inference.modelscope.net/gradio_api/mcp/",
"headers": {
"Authorization": "Bearer ${MODELSCOPE_API_TOKEN}"
}
}
}
}
将环境变量 MODELSCOPE_API_TOKEN 设置为你自己的 ModelScope Access Token。可在
ModelScope 访问令牌页面创建令牌；请求头中的
Bearer 与令牌之间必须保留一个空格。请勿把令牌写入仓库或公开分享的配置。
工具：create_bead_pattern
上传图片并生成完整拼豆图纸。远程调用时，image 应为服务器能够访问的 HTTP/HTTPS 图片 URL。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
image |
URL | 必填 | JPG、PNG、WebP 等常见图片 |
width |
整数 | 58 | 横向豆数，12–128 |
max_colors |
整数 | 16 | 最大颜色数，4–64 |
palette |
枚举 | smart_original |
配色策略，见下表 |
crop |
枚举 | square |
构图裁切方式 |
detail |
枚举 | illustration |
图像细节处理方式 |
dithering |
布尔 | false |
是否用色点混合表现渐变 |
cleanup |
整数 | 1 | 去杂点强度，0–3 |
remove_background |
布尔 | false |
是否去除与边缘相连的纯色背景 |
background_tolerance |
整数 | 22 | 去背景容差，4–60 |
bead_size_mm |
数值 | 5.0 | 5.0（Midi）或 2.6（Mini） |
配色色板
| 值 | 效果 | 适合 |
|---|---|---|
smart_original |
从原图自适应提取主色 | 照片、插画，通用首选 |
universal_48 |
在 48 色通用工艺色板中匹配 | 希望颜色更容易采购 |
candy_24 |
明亮、甜美、高饱和 | Q 版角色、宠物、可爱图案 |
morandi_24 |
柔雾、低饱和 | 人像、家居装饰、文艺插画 |
retro_16 |
复古游戏机式有限色板 | 像素画、游戏角色 |
构图与细节
crop：keep保留完整画面；square方形居中；portrait_4_5头像比例；landscape_16_9横幅比例。detail：illustration强化轮廓；photo保留柔和渐变；pixel使用最近邻缩放，避免像素边缘变糊。dithering：照片建议开启；Logo、图标和像素画通常关闭，图纸会更干净。cleanup：0 完全保留细节；1–2 更适合实际施工；3 会明显合并孤立色块。remove_background：仅建议用于纯色或近似纯色背景；边缘与主体颜色接近时请关闭。
输出说明
一次调用返回四项：拼豆质感预览图、编号施工图、ZIP 下载文件和 JSON 清单。
ZIP 内包含：
beadloom_preview.png：成品质感预览；beadloom_pattern.png：逐格编号图，粗紫线表示 29×29 底板接缝；beadloom_materials.csv：颜色编号、应用色号、HEX、数量和占比；beadloom_printable.pdf：按底板分页的打印版施工图；beadloom_manifest.json：网格、成品尺寸、底板、色板和生成参数；README.txt：文件用途速查。
推荐参数
| 场景 | 推荐设置 |
|---|---|
| 钥匙扣 / 徽章 | 24–40 格，8–16 色，关闭抖动，清理 1–2 |
| 头像 / 宠物 | 40–64 格，16–24 色，方形裁切，插画模式 |
| 照片 | 58–96 格，24–40 色，照片模式，可开启抖动 |
| 像素画 | 原图比例，像素模式，关闭抖动，清理 0 |
使用提示
- 图片主体越清晰、背景越简单，低分辨率图纸越好看。
- 颜色不是越多越好；小作品控制在 8–16 色通常更容易制作。
- 应用内 D/A 色号用于图纸编号，不代表任何品牌官方色号。
- 屏幕与实物会有色差，批量购豆前请用实物色卡核对。
