mcp-sketch
mcp-sketch
Inglés | Chino
Herramienta local que ofrece servicios MCP y CLI para analizar archivos zip HTML exportados desde Sketch-Meaxure y extraer información de la estructura del diseño.
SKILL
Se recomienda descargar el
skillsketch-html y personalizar su propia versión para analizar archivos zip exportados desdeSketch-Meaxure.También se puede descargar utilizando la herramienta
skills.
npx skills@latest add YamadaAoi/mcp-sketch -s sketch-htmlRelated MCP server: codesign-mcp
Declaración
Para no confundir a la
IA, esta herramienta filtra algunas capas sin sentido, pero no se excluye la posibilidad de que se filtren algunas capas válidas.Se recomienda comunicarse con el diseñador
UI; para efectos complejos, intente realizar cortes (slices); para efectos simples, establezca un radio (radius) para enfatizar, aunque sea1.
Funcionalidades
Analizar archivos zip HTML exportados desde Sketch y extraer la estructura del diseño.
Soporte para filtrar por página y mesa de trabajo (artboard).
Soporte para analizar áreas rectangulares específicas.
Salida de la estructura del diseño en JSON e imágenes de vista previa para referencia de la IA.
Proporciona dos formas de uso: servicio MCP y CLI.
Modo de uso
Método 1: Uso directo mediante CLI
Utilizar en combinación con npx:
npx -y mcp-sketch analyze -p /path/to/export.zipOpciones de comando
Opción | Abreviatura | Descripción |
|
| Ruta del archivo zip HTML de Sketch (obligatorio) |
| ID de la página | |
| Nombre de la página | |
| ID de la mesa de trabajo | |
| Nombre de la mesa de trabajo | |
|
| Especificar el área rectangular de análisis, formato: |
| Ruta de almacenamiento de los cortes, por defecto | |
| Si se debe guardar el resultado del análisis en un archivo local, por defecto |
Ejemplo de CLI
Si los parámetros contienen espacios, deben encerrarse entre comillas
# 分析 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]"Método 2: Servicio MCP
Es obligatorio establecer la variable de entorno MCP_MODE=1 para habilitar el servicio MCP, configurado como un servicio MCP local para que las herramientas de IA puedan invocarlo directamente.
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"
}
}
}
}Parámetros MCP
Utilice la herramienta sketch_html_analyze para analizar el archivo zip HTML exportado desde Sketch:
Parámetro | Tipo | Obligatorio | Descripción |
file_path | string | Sí | Ruta del archivo zip HTML de Sketch |
page_id | string | No | ID de la página |
page_name | string | No | Nombre de la página |
artboard_id | string | No | ID de la mesa de trabajo |
artboard_name | string | No | Nombre de la mesa de trabajo |
rect | number[] | No | Especificar el área rectangular de análisis, formato |
assets_path | string | No | Ruta de almacenamiento de los cortes, por defecto |
save_result | boolean | No | Si se debe guardar el resultado del análisis en un archivo local, por defecto |
Ejemplo de invocación MCP
Analizar la primera mesa de trabajo de la primera página del archivo zip HTML de Sketch:
sketch_html_analyze({ file_path: "/path/to/export.zip" })Analizar la primera mesa de trabajo de una página específica:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页" })Analizar una mesa de trabajo específica de una página específica:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理" })Analizar un área específica de una mesa de trabajo específica en una página específica, por ejemplo, analizar la barra de navegación superior de la mesa de trabajo de gestión de usuarios:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理", rect: [0, 0, 1920, 64] })Prioridad de parámetros
page:
page_id>page_name> primera páginaartboard:
artboard_id>artboard_name> primera mesa de trabajorect: Especifica el área rectangular de análisis; la regla de filtrado es que si las coordenadas
x,y,x+width,y+heightdel elemento están dentro del rectángulo, será analizado.
Resultados devueltos
La herramienta devolverá texto: {artboard: {resultado del análisis}, previewPath: "ruta de la vista previa"}
artboardDatos de la mesa de trabajo, incluyendo capas, estilos, imágenes, etc.
previewPathUtiliza
sharpcomooptionalDependenciespara el procesamiento de imágenes.Si la instalación falla (caso extremo, ya que
sharpdepende delibvips), se devolverá la imagen original completa de la mesa de trabajo.Si la instalación es exitosa, se ajustará el tamaño, se recortará el área
rect(si se especifica) y se comprimirá en formatowebppara su devolución.Solo procesa la vista previa, no reemplaza el procesamiento de cortes de
sketch.
Ubicación de los archivos de salida
Los cortes analizados se guardan por defecto en el directorio
src/assets/sketch/(se puede personalizar medianteassets_path).El contenido del diseño analizado se guarda por defecto en un archivo JSON local (para revisión humana), la carpeta de almacenamiento tiene el mismo nombre y nivel que el archivo zip.
Sugerencias de uso
Utilice modelos que soporten multimodalidad, capaces de leer la vista previa para corregir la estructura del diseño.
El volumen de datos analizados para la IA no debe exceder los
50KBpara mejorar la precisión del análisis de la IA (el archivo JSON almacenado localmente está formateado, el que se pasa a la IA es un formato compacto).Se recomienda utilizar el parámetro
rectpara analizar áreas específicas dentro de la mesa de trabajo, permitiendo un desarrollo modular y mejorando la granularidad.
Guía
Available Tools
1 toolsketch_html_analyzesketch_html_analyzeC
Analyze sketch html files and return the design structure of corresponding pages or drawing boards
Inputs: file_path (required), page_id, page_name, artboard_id, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool in the set, there is no possibility of confusion or overlap with other tools within this server.
The single tool uses clear snake_case with a descriptive verb suffix, but with only one data point, a broader naming pattern cannot be established.
A single analysis tool is too few for the apparent scope implied by the server name 'mcp-sketch', suggesting a severely limited integration surface.
The server only supports analyzing HTML exports, lacking any functionality for creating, editing, or exporting native Sketch files, representing significant gaps for design workflow automation.
Maintenance
Related MCP Connectors
MCP server for web extraction and rendering via AceDataCloud WebExtrator
MCP server to assist with JxBrowser development.
A remote MCP server to convert HTML documents (URL or raw source) to PDF or screenshots
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceMCP server to provide Sketch layout information to AI coding agents like Cursor71MIT
- AlicenseAqualityBmaintenanceLocal MCP server for Tencent CoDesign sharing links, exposing artboards, layer specs, preview images, and exported slices to support design-to-code workflows.860 npm23MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for ingesting UI screenshots, Figma MCP node JSON, or hybrid Figma-plus-screenshot sources into a cross-platform design-to-code artifact pipeline.109 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server for the MiroMiro design-extraction API. It extracts real design data from live websites—including brand colors, fonts, tokens, SVGs, images, and component code—so AI agents can build from actual values.165 npmMIT