Unified Figma MCP

기존 백엔드를 수정하지 않고 Plumb 및 Custom MCP를 적절히 사용할 수 있는 통합 Figma MCP 코디네이터를 위한 1단계 조사 프로젝트입니다.

올바른 로컬 경로:

C:\Users\rachi\OneDrive\Documents\FIGMA UNIFIED MCP

1단계 상태

1단계는 문서화 및 검증만 수행합니다. 현재 리포지토리에는 아키텍처 문서, 테스트 결과, Custom MCP SDK 프로브가 포함되어 있습니다. 아직 프로덕션 코디네이터 구현은 추가되지 않았습니다.

Related MCP server: Local Figma MCP Bridge

주요 발견 사항

Plumb과 Custom은 모두 실제 Figma MCP 경로로 작동하지만, 현재 Figma 워크플로우는 한 번에 하나의 활성 MCP 플러그인 브리지만 지원합니다. 따라서 Unified MCP는 명시적인 백엔드 상태와 명확한 전환 프롬프트를 노출해야 합니다.

문서

• docs/CURRENT_SYSTEM.md

• docs/PLUMB_ARCHITECTURE.md

• docs/CUSTOM_MCP_ARCHITECTURE.md

• docs/PROTOCOL_MAP.md

• docs/CAPABILITY_MATRIX.md

• docs/ARCHITECTURE_OPTIONS.md

• docs/FAILURE_ANALYSIS.md

• docs/IMPLEMENTATION_RECOMMENDATION.md

• docs/TEST_PLAN.md

• docs/STAGE1_RESULTS.md

진단 스크립트

scripts/custom-mcp-sdk-probe.mjs

예시:

node scripts\custom-mcp-sdk-probe.mjs --wait-paired --read --write

이 스크립트는 기존 Custom MCP 서버를 하위 프로세스로 시작하고, FIGMA-CUSTOM-MCP에 설치된 MCP SDK를 사용하여 stdio를 통해 MCP와 통신하며, 선택적으로 상태 확인, 읽기, 쓰기, 정리를 검증합니다.

2단계 상태

2단계에서는 최초의 실제 Unified MCP 코디네이터 런타임을 추가합니다:

npm run start

진단 도우미:

node scripts\unified-probe.mjs unified_status
node scripts\unified-probe.mjs unified_probe_backend '{"backend":"plumb"}'
node scripts\unified-probe.mjs unified_probe_backend '{"backend":"custom"}'
node scripts\unified-live-sequence.mjs

2단계 문서:

• docs/STAGE2_ARCHITECTURE.md

• docs/STAGE2_TEST_PLAN.md

• docs/STAGE2_RESULTS.md

• docs/BACKEND_ADAPTERS.md

• docs/STATUS_MODEL.md

• docs/ERROR_MODEL.md

3단계 상태

3단계에서는 자동화된 백엔드 핸드오프를 조사했습니다. 결과: 현재 2-플러그인 아키텍처에서는 자동화된 핸드오프가 차단됩니다. Unified MCP는 수동 백엔드 변경 사항을 관찰할 수는 있지만, 새로운 플러그인 아키텍처나 취약한 UI 자동화 없이는 비활성 Figma 플러그인을 합법적으로 실행할 수 없습니다.

3단계 문서:

• docs/STAGE3_INVESTIGATION.md

• docs/HANDOFF_STATE_MACHINE.md

• docs/BACKEND_LIFECYCLE.md

• docs/STAGE3_TEST_PLAN.md

• docs/STAGE3_RESULTS.md

• docs/HANDOFF_BLOCKER.md

• docs/RUNTIME_ALTERNATIVES.md