mcp-sketch
mcp-sketch
English | 中文
Локальный инструмент, предоставляющий сервисы MCP и CLI для разбора ZIP-архивов HTML, экспортированных из Sketch-Meaxure, и извлечения информации о структуре дизайна.
SKILL
Рекомендуется скачать
skillsketch-html и настроить свою версию для анализа ZIP-файлов, экспортированных изSketch-Meaxure.Также можно использовать инструмент
skillsдля загрузки.
npx skills@latest add YamadaAoi/mcp-sketch -s sketch-htmlRelated MCP server: codesign-mcp
Заявление
Чтобы не сбивать с толку
AI, данный инструмент отфильтровывает часть бессмысленных слоев, однако не исключено, что некоторые полезные слои также могут быть отфильтрованы.Рекомендуется общаться с
UI-дизайнерами: сложные эффекты лучше нарезать как изображения; для простых эффектов используйте скругление углов (radius) для акцента, даже если это1.
Функции
Разбор ZIP-архивов HTML, экспортированных из Sketch, и извлечение структуры дизайна:
Поддержка фильтрации по страницам (page) и артбордам (artboard).
Поддержка разбора по указанной прямоугольной области.
Вывод JSON структуры дизайна и изображения для предварительного просмотра для использования AI.
Предоставление двух способов использования: сервис MCP и CLI.
Способ использования
Способ 1: Прямое использование через CLI
Использование в сочетании с npx:
npx -y mcp-sketch analyze -p /path/to/export.zipОпции команды
Опция | Сокращение | Описание |
|
| Путь к ZIP-архиву Sketch HTML (обязательно) |
| ID страницы | |
| Имя страницы | |
| ID артборда | |
| Имя артборда | |
|
| Указание прямоугольной области разбора, формат: |
| Путь для сохранения нарезанных изображений, по умолчанию | |
| Сохранять ли результаты анализа в локальный файл, по умолчанию |
Пример 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]"Способ 2: Сервис MCP
Для включения сервиса MCP необходимо установить переменную окружения MCP_MODE=1. Настройте его как локальный сервис 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 для анализа ZIP-архива HTML, экспортированного из Sketch:
Параметр | Тип | Обязательно | Описание |
file_path | string | Да | Путь к ZIP-архиву Sketch HTML |
page_id | string | Нет | ID страницы |
page_name | string | Нет | Имя страницы |
artboard_id | string | Нет | ID артборда |
artboard_name | string | Нет | Имя артборда |
rect | number[] | Нет | Указание прямоугольной области разбора, формат |
assets_path | string | Нет | Путь для сохранения нарезанных изображений, по умолчанию |
save_result | boolean | Нет | Сохранять ли результаты анализа в локальный файл, по умолчанию |
Пример вызова MCP
Анализ первого артборда на первой странице ZIP-архива Sketch HTML:
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> первая страницаartboard:
artboard_id>artboard_name> первый артборд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, не должен превышать
50 КБдля повышения точности анализа AI (локально сохраненный JSON-файл отформатирован, а для AI передается компактный формат).Рекомендуется использовать параметр
rectдля анализа конкретных областей артборда, модульной разработки и повышения детализации.
Руководство
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