본문으로 건너뛰기
MCP 서버 전체 목록

Talk to Figma MCP

  • 추천0
  • GitHub 별7.1K
  • 디자인라이선스MIT

Cursor · Claude Code 같은 AI 에이전트가 Figma 디자인을 읽고 직접 고칠 수 있게 연결해 주는 MCP 서버예요. MIT 라이선스.

원본:grab/cursor-talk-to-figma-mcp

설치 방법은 설치 탭에 정리했어요.

설명

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 서버

사용 방법

  1. Bun이 없다면 설치합니다.
curl -fsSL https://bun.sh/install | bash
  1. 설정을 실행합니다. Cursor의 현재 프로젝트에 MCP도 함께 설치됩니다.
bun setup
  1. WebSocket 서버를 시작합니다.
bun socket
  1. 새 기능 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 플러그인

  1. Figma에서 Plugins > Development > New Plugin으로 이동합니다.
  2. "Link existing plugin"을 고릅니다.
  3. src/cursor_mcp_plugin/manifest.json 파일을 선택합니다.
  4. 이제 개발용 Figma 플러그인 목록에서 플러그인을 쓸 수 있습니다.

Windows + WSL 가이드

  1. PowerShell로 Bun을 설치합니다.
powershell -c "irm bun.sh/install.ps1|iex"
  1. src/socket.ts에서 호스트 이름 0.0.0.0의 주석을 해제합니다.
// uncomment this to allow connections in windows wsl
hostname: "0.0.0.0",
  1. WebSocket을 시작합니다.
bun socket

사용법

  1. WebSocket 서버를 시작합니다.
  2. Cursor에 MCP 서버를 설치합니다.
  3. Figma를 열고 Cursor MCP Plugin을 실행합니다.
  4. join_channel로 채널에 들어가 플러그인을 WebSocket 서버에 연결합니다.
  5. 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 플러그인 빌드

  1. 플러그인 디렉터리로 이동합니다.

    cd src/cursor_mcp_plugin
    
  2. code.js와 ui.html을 수정합니다.

모범 사례

Figma MCP로 작업할 때는 다음을 지키세요.

  1. 명령을 보내기 전에 항상 채널에 먼저 들어갑니다.
  2. 먼저 get_document_info로 문서 개요를 확인합니다.
  3. 수정하기 전에 get_selection으로 현재 선택을 확인합니다.
  4. 필요에 맞는 생성 도구를 씁니다.
    • 컨테이너는 create_frame
    • 기본 도형은 create_rectangle
    • 텍스트 요소는 create_text
  5. get_node_info로 변경 사항을 확인합니다.
  6. 일관성을 위해 가능하면 컴포넌트 인스턴스를 씁니다.
  7. 모든 명령이 예외를 던질 수 있으므로 오류를 적절히 처리합니다.
  8. 큰 디자인에서는 다음을 지킵니다.
    • scan_text_nodes의 분할 매개변수를 씁니다
    • WebSocket 업데이트로 진행 상황을 확인합니다
    • 적절한 오류 처리를 구현합니다
  9. 텍스트 작업에서는 다음을 지킵니다.
    • 가능하면 일괄 작업을 씁니다
    • 구조적 관계를 고려합니다
    • 대상을 좁힌 내보내기로 변경 사항을 확인합니다
  10. 기존 방식의 주석을 바꿀 때는 다음을 지킵니다.
    • 텍스트 노드를 스캔해 번호 마커와 설명을 찾습니다
    • scan_nodes_by_types로 주석이 가리키는 UI 요소를 찾습니다
    • 경로, 이름, 근접도로 마커와 대상 요소를 짝짓습니다
    • get_annotations로 주석을 알맞게 분류합니다
    • set_multiple_annotations로 기본 주석을 묶음 단위로 만듭니다
    • 모든 주석이 대상에 제대로 연결됐는지 확인합니다
    • 변환이 끝나면 기존 주석 노드를 삭제합니다
  11. 프로토타입 노들(noodle)을 FigJam 커넥터로 시각화합니다.
  • get_reactions로 프로토타입 흐름을 추출하고,
  • set_default_connector로 기본 커넥터를 지정한 뒤,
  • create_connections로 커넥터 선을 만들어 흐름을 한눈에 보이게 합니다.

라이선스

MIT