Unified Figma MCP

Proyecto de investigación de la Etapa 1 para un coordinador Unified Figma MCP que pueda usar Plumb y Custom MCP de manera adecuada sin modificar ninguno de los backends existentes.

Ruta local correcta:

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

Estado de la Etapa 1

La Etapa 1 es solo documentación y verificación. El repositorio actualmente contiene documentos de arquitectura, resultados de pruebas y una sonda del SDK de Custom MCP. Aún no se ha añadido ninguna implementación de coordinador de producción.

Related MCP server: Local Figma MCP Bridge

Hallazgo clave

Plumb y Custom funcionan ambos como rutas reales de Figma MCP, pero el flujo de trabajo actual de Figma admite solo un puente de plugin MCP activo a la vez. Por lo tanto, Unified MCP debería exponer un estado de salud explícito del backend y avisos claros de cambio.

Documentos

• 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

Script de diagnóstico

scripts/custom-mcp-sdk-probe.mjs

Ejemplo:

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

El script inicia el servidor Custom MCP existente como un proceso hijo, se comunica con MCP a través de stdio usando el SDK de MCP instalado en FIGMA-CUSTOM-MCP, y opcionalmente verifica el estado, la lectura, la escritura y la limpieza.

Estado de la Etapa 2

La Etapa 2 añade el primer runtime real de coordinador Unified MCP:

npm run start

Helpers de diagnóstico:

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

Documentos de la Etapa 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

Estado de la Etapa 3

La Etapa 3 investigó la transferencia automática de backend. Resultado: TRANSFERENCIA AUTOMÁTICA BLOQUEADA bajo la arquitectura actual de dos plugins. Unified MCP puede observar cambios manuales en el backend, pero no puede lanzar legítimamente el plugin de Figma inactivo sin una nueva arquitectura de plugin o una automatización frágil de la interfaz de usuario.

Documentos de la Etapa 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