Perler SVG Pattern MCP 路由

本项目的生产接口是 mcp_server.py，不是厚重的对话 Skill。客户端通过 MCP 工具调用确定、可测试的处理链路；源码图片保持原位，产物写入调用者明确 指定的输出目录。

维护团队：柯影数智团队。

工具路由

| 用户目标 | MCP 工具 | | --- | --- | | 查询支持的 Perler / Hama / Artkal 色板 | list_brand_palettes | | 查看某个品牌色板的真实色号、名称和 HEX 参考 | get_brand_palette | | 将图片生成可拼制 SVG 图纸、购物清单与报告 | convert_image | | 校验已有 SVG 是否为合格拼豆矢量图纸 | validate_svg_artifact |

调用准则

• 生成图纸时优先调用 convert_image，并提供已有的 input_path 与明确的 output_dir。
• 要严格匹配可购买颜色时，先调用 list_brand_palettes，再将返回的 palette 名称传给 convert_image.brand。
• 人物、宠物、Logo、风景、插画分别使用 portrait、pet、logo、landscape、art / illustration 模式；未确定时使用 auto。
• 需要验证交付物时调用 validate_svg_artifact。转换工具本身也会在成功返回前完成完整的图纸校验。
• 不要复制输入图到服务器目录，也不要要求模型手工重述主体识别、量化、清理或 SVG 生成流程；这些都是 MCP 服务端实现的职责。

本地启动

uv sync --group dev
uv run python mcp_server.py

完整客户端配置、CLI 兼容入口、参数和验收规则见 README.md。