figma-custom-mcp

Plumb의 세 가지 특정 확인된 기능 격차를 해결하는 소규모 MCP + Figma 플러그인입니다. Plumb을 수정, 포크 또는 대체하지 않으며, Figma에서 Plumb과 함께 사용하도록 설계되었습니다.

해당 격차와 이에 대한 전체 소스 수준 증거는 PLUMB_GAP_ANALYSIS.md (Plumb v0.13.2의 소스 기반 감사)에 문서화되어 있습니다. 이 프로젝트는 해당 감사의 P0 항목만을 정확히 구현합니다:

• P0-1 — 절대/겹침 위치 지정. Plumb의 DSL 컴파일러는 모든 컨테이너를 자동 레이아웃으로 강제하며 Figma의 layoutPositioning="ABSOLUTE"를 설정하지 않으므로, 겹치는 구성(이미지 위의 배지, 사진 위의 텍스트 등)을 구조적으로 구축할 수 없습니다. 이 프로젝트의 컴파일러는 기본적으로 자유 (x/y) 위치 지정을 사용하며, 자동 레이아웃 영역 내에서 absolute: true 자식을 지원합니다.

• P0-2 — 로컬/사용자 정의 이미지 가져오기. Plumb의 image.src는 항상 6개의 고정 스톡 사진 제공업체에 대한 웹 검색 쿼리로 컴파일되며, 사용자 자신의 파일은 Plumb으로 구축된 디자인에 절대 들어갈 수 없습니다. 이 프로젝트는 file:/data: URI를 직접 읽으며, 타입화된 오류와 제로 플레이스홀더 대체를 제공합니다.

• P0-3 — 엄격한 스키마 검증. Plumb의 Zod 스키마는 알 수 없거나 오타가 있는 필드를 자동으로 제거합니다. 여기의 모든 스키마는 .strict()입니다.

감사 항목별 전체 추적 가능성은 docs/P0-CAPABILITY-MATRIX.md를, 나머지 문서 세트는 docs/를 참조하세요.

상태

P0 완료 — 전체 승인 기준 체크리스트, 실제 라이브 Figma 테스트 결과, 그리고 이 프로젝트가 구축한 실제 구성(실제 겹치는 Figma 노드, 실제 로컬 이미지, 실제 회전/그라데이션/효과 — 평면화된 이미지 아님)의 스크린샷은 P0-FINAL-REPORT.md를 참조하세요.

Related MCP server: Figma Bridge MCP

빠른 시작

npm install
npm run build
npm test

그런 다음 docs/QUICKSTART.md를 참조하여 Figma 플러그인을 페어링하고 라이브 종단 간 테스트를 실행하세요.

문서

• docs/ARCHITECTURE.md

• docs/P0-CAPABILITY-MATRIX.md

• docs/P0-TOOLS.md

• docs/P0-DESIGN-SCHEMA.md

• docs/P0-TEST-PLAN.md

• docs/P0-IMPLEMENTATION.md

• docs/P0-LIMITATIONS.md

• docs/QUICKSTART.md

라이선스

MIT