mcp-sketch
mcp-sketch
English | 中文
Ein lokales Tool, das sowohl als MCP-Dienst als auch als CLI verfügbar ist, um von Sketch-Meaxure exportierte HTML-Zip-Archive zu parsen und Designstrukturinformationen zu extrahieren.
SKILL
Es wird empfohlen, den sketch-html
skillherunterzuladen und eine eigene Version anzupassen, um die vonSketch-Meaxureexportierten Zip-Dateien zu analysieren.Alternativ kann das
skills-Tool zum Herunterladen verwendet werden.
npx skills@latest add YamadaAoi/mcp-sketch -s sketch-htmlRelated MCP server: codesign-mcp
Hinweis
Um die
KInicht zu verwirren, filtert dieses Tool einige bedeutungslose Ebenen heraus; es kann jedoch nicht ausgeschlossen werden, dass dabei auch einige relevante Ebenen entfernt werden.Es wird empfohlen, sich mit dem
UI-Designer abzustimmen. Komplexe Effekte sollten nach Möglichkeit als Bild exportiert werden; einfache Effekte sollten mit einem Radius (radius) zur Hervorhebung versehen werden, selbst wenn dieser nur1beträgt.
Funktionen
Parsen von Sketch-exportierten HTML-Zip-Archiven und Extrahieren der Designstruktur
Unterstützung für Filterung nach Seite (page) und Zeichenfläche (artboard)
Unterstützung für die Analyse spezifischer rechteckiger Bereiche
Ausgabe der Designstruktur als JSON und Vorschaubild für die KI-Referenz
Bereitstellung als MCP-Dienst und CLI-Tool
Verwendung
Methode 1: Direkte Verwendung über CLI
Verwendung in Kombination mit npx:
npx -y mcp-sketch analyze -p /path/to/export.zipBefehlsoptionen
Option | Abkürzung | Beschreibung |
|
| Pfad zum Sketch HTML-Zip-Archiv (erforderlich) |
| Seiten-ID | |
| Seitenname | |
| Zeichenflächen-ID | |
| Zeichenflächenname | |
|
| Definiert den zu analysierenden rechteckigen Bereich, Format: |
| Speicherpfad für exportierte Assets, Standard: | |
| Ob das Analyseergebnis in einer lokalen Datei gespeichert werden soll, Standard: |
CLI-Beispiel
Wenn Parameter Leerzeichen enthalten, müssen sie in Anführungszeichen gesetzt werden.
# 分析 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]"Methode 2: MCP-Dienst
Die Umgebungsvariable MCP_MODE=1 muss gesetzt sein, um den MCP-Dienst zu aktivieren. Konfigurieren Sie ihn als lokalen MCP-Server, damit KI-Tools direkt darauf zugreifen können.
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-Parameter
Verwenden Sie das Tool sketch_html_analyze, um das aus Sketch exportierte HTML-Zip-Archiv zu analysieren:
Parameter | Typ | Erforderlich | Beschreibung |
file_path | string | Ja | Pfad zum Sketch HTML-Zip-Archiv |
page_id | string | Nein | Seiten-ID |
page_name | string | Nein | Seitenname |
artboard_id | string | Nein | Zeichenflächen-ID |
artboard_name | string | Nein | Zeichenflächenname |
rect | number[] | Nein | Definiert den zu analysierenden rechteckigen Bereich, Format: |
assets_path | string | Nein | Speicherpfad für exportierte Assets, Standard: |
save_result | boolean | Nein | Ob das Analyseergebnis in einer lokalen Datei gespeichert werden soll, Standard: |
MCP-Aufrufbeispiele
Analyse der ersten Zeichenfläche auf der ersten Seite des Sketch HTML-Zip-Archivs:
sketch_html_analyze({ file_path: "/path/to/export.zip" })Analyse der ersten Zeichenfläche einer bestimmten Seite:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页" })Analyse einer bestimmten Zeichenfläche auf einer bestimmten Seite:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理" })Analyse eines bestimmten Bereichs einer bestimmten Zeichenfläche auf einer bestimmten Seite, z. B. die obere Navigationsleiste der Benutzerverwaltungs-Zeichenfläche:
sketch_html_analyze({ file_path: "/path/to/export.zip", page_name: "首页", artboard_name: "用户管理", rect: [0, 0, 1920, 64] })Parameterpriorität
page:
page_id>page_name> erste Seiteartboard:
artboard_id>artboard_name> erste Zeichenflächerect: Definiert den zu analysierenden rechteckigen Bereich. Die Filterregel besagt, dass Elemente analysiert werden, sobald sich ihr
x,y,x+width,y+heightinnerhalb des Rechtecks befindet.
Rückgabeergebnisse
Das Tool gibt Text zurück: {artboard: {Analyseergebnis}, previewPath: "Pfad zum Vorschaubild"}
artboardDaten der Zeichenfläche, einschließlich Ebenen, Stilen, Bildern usw.
previewPathVerwendet
sharpalsoptionalDependenciesfür die Bildverarbeitung.Falls die Installation fehlschlägt (Extremfall, da
sharpvonlibvipsabhängt), wird das ursprüngliche vollständige Zeichenflächenbild zurückgegeben.Bei erfolgreicher Installation wird die Größe angepasst, der
rect-Bereich (falls angegeben) zugeschnitten und alswebpkomprimiert zurückgegeben.Verarbeitet nur das Vorschaubild, führt keine automatische Verarbeitung der
sketch-Assets durch.
Speicherort der Ausgabedateien
Die analysierten Assets werden standardmäßig im Verzeichnis
src/assets/sketch/gespeichert (kann überassets_pathangepasst werden).Der analysierte Designinhalt wird standardmäßig in einer lokalen JSON-Datei gespeichert (zur manuellen Überprüfung). Der Ordner befindet sich standardmäßig auf derselben Ebene wie das Zip-Archiv und trägt denselben Namen.
Empfehlungen zur Verwendung
Verwenden Sie Modelle, die multimodale Eingaben unterstützen, um das Vorschaubild zu lesen und die Designstruktur zu korrigieren.
Die an die KI übermittelte Datenmenge sollte
50KBnicht überschreiten, um die Genauigkeit der KI-Analyse zu erhöhen (die lokal gespeicherte JSON-Datei ist formatiert, an die KI wird ein kompaktes Format übermittelt).Es wird empfohlen, den
rect-Parameter zu verwenden, um spezifische Bereiche innerhalb einer Zeichenfläche zu analysieren, um eine modulare Entwicklung zu fördern und die Granularität zu erhöhen.
Anleitung
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