Sketch

English | 中文

本地工具，提供 MCP 服务和 CLI 两种方式，用于解析 Sketch-Meaxure 导出的 HTML zip 压缩包并提取设计结构信息。

SKILL

• 推荐下载 sketch-html skill，并定制自己的版本，分析**Sketch-Meaxure**导出的zip文件
• 也可以使用skills工具下载

npx skills@latest add YamadaAoi/mcp-sketch -s sketch-html

声明

• 为了不迷惑AI，本工具过滤了一部分无意义图层，但是不排除过滤掉了一些有效图层的情况
• 建议和UI设计师沟通，复杂的效果尽量切图；简单的效果，设置圆角（radius）用于强调，哪怕是1

功能

• 解析 Sketch 导出的 HTML zip 压缩包并提取设计结构
  • 支持按 page、artboard 筛选
  • 支持指定矩形区域解析
  • 输出设计结构 JSON 和预览图供 AI 参考
• 提供 MCP 服务和 CLI 两种使用方式

使用方法

方式一：CLI 直接使用

结合npx使用：

npx -y mcp-sketch analyze -p /path/to/export.zip

命令选项

选项	缩写	说明
-p, --file_path <PATH>	-p	Sketch HTML zip 压缩包路径（必填）
--pid, --page_id		页面 ID
--pn, --page_name		页面名称
--aid, --artboard_id		画板 ID
--an, --artboard_name		画板名称
-r, --rect	-r	指定解析矩形区域，格式：[x,y,width,height]
--ap, --assets_path		切图存放路径，默认 src/assets/sketch
--sr, --save_result		是否保存分析结果到本地文件，默认 false

CLI 示例

若参数带空格，需使用引号括起来

# 分析 zip 中第一个页面第一个画板
npx -y mcp-sketch analyze -p "/path/to/export .zip"

# 分析指定页面
npx -y mcp-sketch analyze -p /path/to/export.zip --pn 首页

# 分析指定页面指定画板
npx -y mcp-sketch analyze -p /path/to/export.zip --pn 首页 --an 用户管理

# 分析指定区域
npx -y mcp-sketch analyze -p /path/to/export.zip --pn 首页 --an 用户管理 -r "[0,0,1920,64]"

方式二：MCP 服务

必须设置环境变量 MCP_MODE=1 才能启用 MCP 服务，配置为本地 MCP 服务，让 AI 工具直接调用。

• opencode：

{
  "mcp": {
    "mcp-sketch": {
      "type": "local",
      "command": ["npx", "-y", "mcp-sketch"],
      "enabled": true,
      "environment": {
        "MCP_MODE": "1",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

• Trae：

{
  "mcpServers": {
    "mcp-sketch": {
      "command": "npx",
      "args": ["-y", "mcp-sketch"],
      "env": {
        "MCP_MODE": "1"
      }
    }
  }
}

MCP 参数

使用 sketch_html_analyze 工具分析从 Sketch 导出的 HTML zip 压缩包：

参数	类型	必填	说明
file_path	string	是	Sketch HTML zip 压缩包路径
page_id	string	否	页面 ID
page_name	string	否	页面名称
artboard_id	string	否	画板 ID
artboard_name	string	否	画板名称
rect	number[]	否	指定解析矩形区域，格式为 [x, y, width, height]（x, y 为左上角坐标，width, height 为矩形宽度和高度）
assets_path	string	否	切图存放路径，默认 src/assets/sketch
save_result	boolean	否	是否保存分析结果到本地文件，默认 false

MCP 调用示例

• 分析 Sketch HTML zip 压缩包中第一个页面第一个画板：

sketch_html_analyze({ file_path: "/path/to/export.zip" })

• 分析指定页面第一个画板：

sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页" })

• 分析指定页面指定画板：

sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理" })

• 分析指定页面指定画板指定区域，如解析用户管理画板顶部导航栏：

sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理", rect: [0, 0, 1920, 64] })

参数优先级

• page: page_id > page_name > 第一个 page
• artboard: artboard_id > artboard_name > 第一个 artboard
• rect: 指定解析矩形区域，过滤规则是只要元素的x,y,x+width,y+height在矩形内，就会被解析。

返回结果

工具会返回文本：{artboard: {解析结果}, previewPath: "预览图路径"}

• artboard
  • 画板数据，包含图层、样式、图片等信息
• previewPath
  • 采用sharp作为处理图片的optionalDependencies
  • 若安装失败（极端情况，因为sharp依赖libvips），则会返回原始完整画板图片。
  • 若安装成功，则会调整尺寸，截取rect区域（若指定），压缩为webp格式返回。
  • 仅处理预览图，不会越俎代庖处理sketch切图

输出文件位置

• 解析的切图默认保存在 src/assets/sketch/ 目录下（可通过 assets_path 自定义）
• 解析的设计内容默认保存到本地 JSON 文件中（用于人工审核），存放文件夹默认与 zip 包同名同级

使用建议

• 使用支持多模态的模型，可读取预览图修正设计结构
• 解析给 AI的数据量不超过50KB以提高 AI 分析准确率（本地存储的 JSON 文件是格式化后的，传递给 AI 的是紧凑格式）
• 推荐使用 rect 参数解析画板中的特定区域，模块化开发，提升颗粒度。

引导