Talk to Figma MCP
- 추천0
- GitHub 별7.1K
- 디자인라이선스MIT
Cursor · Claude Code 같은 AI 에이전트가 Figma 디자인을 읽고 직접 고칠 수 있게 연결해 주는 MCP 서버예요. MIT 라이선스.
설치 방법은 설치 탭에 정리했어요.
설명
Talk to Figma MCP
이 프로젝트는 AI 에이전트(Cursor, Claude Code)와 Figma 사이에 Model Context Protocol(MCP) 연동을 구현합니다. AI 에이전트가 Figma와 통신하면서 디자인을 읽고 프로그램으로 수정할 수 있습니다.
https://github.com/user-attachments/assets/129a14d2-ed73-470f-9a4c-2240b2a4885c
프로젝트 구조
src/talk_to_figma_mcp/- Figma 연동용 TypeScript MCP 서버src/cursor_mcp_plugin/- Cursor와 통신하는 Figma 플러그인src/socket.ts- MCP 서버와 Figma 플러그인 사이의 통신을 중계하는 WebSocket 서버
사용 방법
- Bun이 없다면 설치합니다.
curl -fsSL https://bun.sh/install | bash
- 설정을 실행합니다. Cursor의 현재 프로젝트에 MCP도 함께 설치됩니다.
bun setup
- WebSocket 서버를 시작합니다.
bun socket
- 새 기능 Figma 커뮤니티 페이지에서 Figma 플러그인을 설치하거나 로컬로 설치합니다.
빠른 영상 튜토리얼
디자인 자동화 예시
텍스트 내용 일괄 교체
일괄 텍스트 교체 기능에 기여해 주신 @dusskapark님께 감사드립니다. 데모 영상을 확인해 보세요.
인스턴스 오버라이드 전파 이 기능도 @dusskapark님의 기여입니다. 명령 한 번으로 원본 컴포넌트 인스턴스의 오버라이드를 여러 대상 인스턴스에 전파합니다. 비슷한 커스터마이징이 필요한 컴포넌트 인스턴스를 다룰 때 반복 작업이 크게 줄어듭니다. 데모 영상을 확인해 보세요.
수동 설정과 설치
MCP 서버: Cursor와 연동
~/.cursor/mcp.json에 서버를 추가합니다.
{
"mcpServers": {
"TalkToFigma": {
"command": "bunx",
"args": ["cursor-talk-to-figma-mcp@latest"]
}
}
}
WebSocket 서버
WebSocket 서버를 시작합니다.
bun socket
Figma 플러그인
- Figma에서 Plugins > Development > New Plugin으로 이동합니다.
- "Link existing plugin"을 고릅니다.
src/cursor_mcp_plugin/manifest.json파일을 선택합니다.- 이제 개발용 Figma 플러그인 목록에서 플러그인을 쓸 수 있습니다.
Windows + WSL 가이드
- PowerShell로 Bun을 설치합니다.
powershell -c "irm bun.sh/install.ps1|iex"
src/socket.ts에서 호스트 이름0.0.0.0의 주석을 해제합니다.
// uncomment this to allow connections in windows wsl
hostname: "0.0.0.0",
- WebSocket을 시작합니다.
bun socket
사용법
- WebSocket 서버를 시작합니다.
- Cursor에 MCP 서버를 설치합니다.
- Figma를 열고 Cursor MCP Plugin을 실행합니다.
join_channel로 채널에 들어가 플러그인을 WebSocket 서버에 연결합니다.- Cursor에서 MCP 도구를 사용해 Figma와 소통합니다.
로컬 개발 환경 설정
개발하려면 MCP 설정이 로컬 디렉터리를 가리키도록 바꿉니다.
{
"mcpServers": {
"TalkToFigma": {
"command": "bun",
"args": ["/path-to-repo/src/talk_to_figma_mcp/server.ts"]
}
}
}
MCP 도구
MCP 서버는 Figma와 상호작용하기 위해 다음 도구를 제공합니다.
문서 · 선택
get_document_info- 현재 Figma 문서의 정보를 가져옵니다get_selection- 현재 선택한 항목의 정보를 가져옵니다read_my_design- 매개변수 없이 현재 선택한 항목의 상세 노드 정보를 가져옵니다get_node_info- 특정 노드의 상세 정보를 가져옵니다get_nodes_info- 노드 ID 배열로 여러 노드의 상세 정보를 가져옵니다set_focus- 특정 노드를 선택하고 뷰포트를 그 위치로 스크롤해 포커스를 맞춥니다set_selections- 여러 노드를 선택하고 뷰포트를 스크롤해 모두 보이게 합니다
주석
get_annotations- 현재 문서 또는 특정 노드의 모든 주석을 가져옵니다set_annotation- 마크다운을 지원하는 주석을 만들거나 수정합니다set_multiple_annotations- 여러 주석을 한꺼번에 효율적으로 만들거나 수정합니다scan_nodes_by_types- 특정 유형의 노드를 스캔합니다(주석 대상을 찾을 때 유용)
프로토타이핑 · 연결
get_reactions- 노드의 모든 프로토타입 리액션을 시각적 강조 애니메이션과 함께 가져옵니다set_default_connector- 복사한 FigJam 커넥터를 연결선 생성의 기본 커넥터 스타일로 지정합니다(연결을 만들기 전에 먼저 지정해야 합니다)create_connections- 프로토타입 흐름이나 사용자 지정 매핑을 바탕으로 노드 사이에 FigJam 커넥터 선을 만듭니다
요소 만들기
create_rectangle- 위치, 크기, 선택 사항인 이름을 지정해 새 사각형을 만듭니다create_frame- 위치, 크기, 선택 사항인 이름을 지정해 새 프레임을 만듭니다create_section- 캔버스에서 관련 콘텐츠를 묶는 섹션을 만듭니다create_text- 글꼴 속성을 지정해 새 텍스트 노드를 만듭니다
텍스트 내용 수정
scan_text_nodes- 큰 디자인에서도 쓸 수 있도록 나눠서 텍스트 노드를 스캔합니다set_text_content- 텍스트 노드 하나의 내용을 바꿉니다set_multiple_text_contents- 여러 텍스트 노드를 한꺼번에 효율적으로 바꿉니다
오토 레이아웃 · 간격
set_layout_mode- 프레임의 레이아웃 모드와 줄바꿈 동작을 지정합니다(NONE, HORIZONTAL, VERTICAL)set_padding- 오토 레이아웃 프레임의 안쪽 여백(위, 오른쪽, 아래, 왼쪽)을 지정합니다set_axis_align- 오토 레이아웃 프레임의 주축과 교차축 정렬을 지정합니다set_layout_sizing- 오토 레이아웃 프레임의 가로 · 세로 크기 모드를 지정합니다(FIXED, HUG, FILL)set_item_spacing- 오토 레이아웃 프레임 안 자식 요소 사이의 간격을 지정합니다
스타일
set_fill_color- 노드의 채우기 색을 지정합니다(RGBA)set_stroke_color- 노드의 선 색과 두께를 지정합니다set_corner_radius- 노드의 모서리 반경을 지정합니다(모서리별 지정도 가능)set_image_fill- 로컬 파일 경로, URL, base64 데이터의 이미지로 노드를 채웁니다(FILL, FIT, CROP, TILE)
레이아웃 · 정리
move_node- 노드를 새 위치로 옮깁니다resize_node- 노드의 크기를 바꿉니다delete_node- 노드를 삭제합니다delete_multiple_nodes- 여러 노드를 한꺼번에 효율적으로 삭제합니다clone_node- 기존 노드를 복사합니다(위치 오프셋 지정 가능)rename_node- 노드 이름을 바꿉니다set_parent- 노드를 새 부모(섹션, 프레임, 그룹)로 옮깁니다. 기본적으로 절대 위치는 그대로 유지됩니다
컴포넌트 · 스타일
get_styles- 로컬 스타일 정보를 가져옵니다get_local_components- 로컬 컴포넌트 정보를 가져옵니다create_component_instance- 컴포넌트의 인스턴스를 만듭니다get_instance_overrides- 선택한 컴포넌트 인스턴스의 오버라이드 속성을 추출합니다set_instance_overrides- 추출한 오버라이드를 대상 인스턴스에 적용합니다
내보내기 · 고급
export_node_as_image- 노드를 이미지(PNG, JPG, SVG, PDF)로 내보냅니다. 현재 이미지 지원은 제한적이며 base64를 텍스트로 돌려줍니다
연결 관리
join_channel- Figma와 통신할 특정 채널에 들어갑니다
MCP 프롬프트
MCP 서버는 복잡한 디자인 작업을 안내하는 도우미 프롬프트도 제공합니다.
design_strategy- Figma 디자인 작업의 모범 사례read_design_strategy- Figma 디자인을 읽을 때의 모범 사례text_replacement_strategy- Figma 디자인의 텍스트를 체계적으로 교체하는 방법annotation_conversion_strategy- 수동으로 단 주석을 Figma 기본 주석으로 바꾸는 전략swap_overrides_instances- Figma 컴포넌트 인스턴스 사이에 오버라이드를 옮기는 전략reaction_to_connector_strategy- 'get_reactions'의 출력을 이용해 Figma 프로토타입 리액션을 커넥터 선으로 바꾸고, 'create_connections'를 순서대로 쓰도록 안내하는 전략
개발
Figma 플러그인 빌드
-
플러그인 디렉터리로 이동합니다.
cd src/cursor_mcp_plugin -
code.js와 ui.html을 수정합니다.
모범 사례
Figma MCP로 작업할 때는 다음을 지키세요.
- 명령을 보내기 전에 항상 채널에 먼저 들어갑니다.
- 먼저
get_document_info로 문서 개요를 확인합니다. - 수정하기 전에
get_selection으로 현재 선택을 확인합니다. - 필요에 맞는 생성 도구를 씁니다.
- 컨테이너는
create_frame - 기본 도형은
create_rectangle - 텍스트 요소는
create_text
- 컨테이너는
get_node_info로 변경 사항을 확인합니다.- 일관성을 위해 가능하면 컴포넌트 인스턴스를 씁니다.
- 모든 명령이 예외를 던질 수 있으므로 오류를 적절히 처리합니다.
- 큰 디자인에서는 다음을 지킵니다.
scan_text_nodes의 분할 매개변수를 씁니다- WebSocket 업데이트로 진행 상황을 확인합니다
- 적절한 오류 처리를 구현합니다
- 텍스트 작업에서는 다음을 지킵니다.
- 가능하면 일괄 작업을 씁니다
- 구조적 관계를 고려합니다
- 대상을 좁힌 내보내기로 변경 사항을 확인합니다
- 기존 방식의 주석을 바꿀 때는 다음을 지킵니다.
- 텍스트 노드를 스캔해 번호 마커와 설명을 찾습니다
scan_nodes_by_types로 주석이 가리키는 UI 요소를 찾습니다- 경로, 이름, 근접도로 마커와 대상 요소를 짝짓습니다
get_annotations로 주석을 알맞게 분류합니다set_multiple_annotations로 기본 주석을 묶음 단위로 만듭니다- 모든 주석이 대상에 제대로 연결됐는지 확인합니다
- 변환이 끝나면 기존 주석 노드를 삭제합니다
- 프로토타입 노들(noodle)을 FigJam 커넥터로 시각화합니다.
get_reactions로 프로토타입 흐름을 추출하고,set_default_connector로 기본 커넥터를 지정한 뒤,create_connections로 커넥터 선을 만들어 흐름을 한눈에 보이게 합니다.
라이선스
MIT