mcp-sketch
mcp-sketch
English | 한국어
MCP 서비스 및 CLI 두 가지 방식을 제공하는 로컬 도구로, **Sketch-Meaxure**에서 내보낸 HTML zip 압축 파일을 파싱하여 디자인 구조 정보를 추출합니다.
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 두 가지 사용 방식 제공
사용 방법
방식 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이미지 처리를 위해
sharp를optionalDependencies로 사용합니다.설치에 실패할 경우(
libvips의존성 문제 등 극단적인 경우), 원본 전체 아트보드 이미지가 반환됩니다.설치에 성공할 경우, 크기가 조정되고
rect영역(지정된 경우)이 잘린 후webp형식으로 압축되어 반환됩니다.미리보기 이미지만 처리하며,
sketch이미지 추출을 대신하지 않습니다.
출력 파일 위치
추출된 이미지는 기본적으로
src/assets/sketch/디렉토리에 저장됩니다 (assets_path로 변경 가능).분석된 디자인 내용은 기본적으로 로컬 JSON 파일에 저장되며(수동 검토용), 저장 폴더는 기본적으로 zip 파일과 동일한 이름 및 경로에 생성됩니다.
사용 제안
멀티모달 모델을 사용하여 미리보기 이미지를 읽고 디자인 구조를 수정하십시오.
AI 분석 정확도를 높이기 위해 AI에 전달하는 데이터 양을
50KB이하로 유지하십시오 (로컬에 저장된 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