mcp-sketch
mcp-sketch
English | 中文
**Sketch-Meaxure**からエクスポートされたHTML zip圧縮ファイルを解析し、デザイン構造情報を抽出するための、MCPサービスおよびCLIとして利用可能なローカルツールです。
SKILL
sketch-html
skillをダウンロードし、独自のバージョンにカスタマイズして**Sketch-Meaxure**からエクスポートされたzipファイルを分析することを推奨します。skillsツールを使用してダウンロードすることも可能です。
npx skills@latest add YamadaAoi/mcp-sketch -s sketch-htmlRelated MCP server: codesign-mcp
免責事項
AIを混乱させないよう、本ツールは一部の無意味なレイヤーを除外していますが、有効なレイヤーが除外されてしまう可能性も排除できません。UIデザイナーと相談し、複雑なエフェクトは可能な限り画像として切り出し、単純なエフェクトは強調のために角丸(radius)を設定することをお勧めします(たとえ1であっても)。
機能
SketchからエクスポートされたHTML zip圧縮ファイルを解析し、デザイン構造を抽出
ページ、アートボードごとのフィルタリングをサポート
指定した矩形領域の解析をサポート
AIの参考用にデザイン構造のJSONとプレビュー画像を出力
MCPサービスとCLIの2通りの使用方法を提供
使用方法
方法1:CLIで直接使用
npxと組み合わせて使用します:
npx -y mcp-sketch analyze -p /path/to/export.zipコマンドオプション
オプション | 省略形 | 説明 |
|
| Sketch HTML zip圧縮ファイルのパス(必須) |
| ページ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ツールを使用して、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[] | いいえ | 解析する矩形領域を指定。形式は |
assets_path | string | いいえ | 切り出し画像の保存先パス。デフォルトは |
save_result | boolean | いいえ | 分析結果をローカルファイルに保存するかどうか。デフォルトは |
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> 最初のpageartboard:
artboard_id>artboard_name> 最初のartboardrect: 解析する矩形領域を指定。フィルタリングルールは、要素の
x,y,x+width,y+heightが矩形内にある場合に解析されます。
返却結果
ツールはテキストを返します:{artboard: {解析結果}, previewPath: "プレビュー画像のパス"}
artboardアートボードデータ。レイヤー、スタイル、画像などの情報を含む
previewPath画像処理の
optionalDependenciesとしてsharpを採用インストールに失敗した場合(
sharpがlibvipsに依存するため、極端なケース)、元の完全なアートボード画像が返されます。インストールに成功した場合、サイズが調整され、
rect領域が切り取られ(指定されている場合)、webp形式に圧縮されて返されます。プレビュー画像のみを処理し、
sketchの切り出し画像を勝手に処理することはありません。
出力ファイルの場所
解析された切り出し画像はデフォルトで
src/assets/sketch/ディレクトリに保存されます(assets_pathでカスタマイズ可能)解析されたデザイン内容はデフォルトでローカルのJSONファイルに保存されます(人間による確認用)。保存先フォルダはデフォルトでzipファイルと同名・同階層になります。
使用上のアドバイス
マルチモーダルモデルを使用すると、プレビュー画像を読み取ってデザイン構造を修正できます。
AIに渡すデータ量は
50KB以下に抑えることで、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