Skip to main content
Glama

mcp-sketch

English | 中文

Локальный инструмент, предоставляющий сервисы MCP и CLI для разбора ZIP-архивов HTML, экспортированных из Sketch-Meaxure, и извлечения информации о структуре дизайна.

SKILL

  • Рекомендуется скачать skill sketch-html и настроить свою версию для анализа ZIP-файлов, экспортированных из Sketch-Meaxure.

  • Также можно использовать инструмент skills для загрузки.

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

Related 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

Опции команды

Опция

Сокращение

Описание

-p, --file_path <PATH>

-p

Путь к ZIP-архиву Sketch HTML (обязательно)

--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]"

Способ 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[]

Нет

Указание прямоугольной области разбора, формат [x, y, width, height] (x, y — координаты верхнего левого угла, width, height — ширина и высота прямоугольника)

assets_path

string

Нет

Путь для сохранения нарезанных изображений, по умолчанию src/assets/sketch

save_result

boolean

Нет

Сохранять ли результаты анализа в локальный файл, по умолчанию false

Пример вызова 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 tool
sketch_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

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool in the set, there is no possibility of confusion or overlap with other tools within this server.

    Naming Consistency4/5

    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.

    Tool Count2/5

    A single analysis tool is too few for the apparent scope implied by the server name 'mcp-sketch', suggesting a severely limited integration surface.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Local MCP server for Tencent CoDesign sharing links, exposing artboards, layer specs, preview images, and exported slices to support design-to-code workflows.
      8
      60 npm
      23
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP 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 npm
      MIT