figma-custom-mcp

Un pequeño plugin de MCP + Figma que corrige tres brechas de capacidad específicas y confirmadas en Plumb — no modifica, bifurca ni reemplaza a Plumb, y está diseñado para usarse junto a él en Figma.

Las brechas, y la evidencia completa a nivel de código fuente para ellas, están documentadas en PLUMB_GAP_ANALYSIS.md (una auditoría desde el código fuente de Plumb v0.13.2). Este proyecto implementa exactamente los elementos P0 de esa auditoría:

• P0-1 — Posicionamiento absoluto / superpuesto. El compilador de DSL de Plumb obliga a todos los contenedores a usar auto-layout y nunca establece layoutPositioning="ABSOLUTE" de Figma, por lo que las composiciones superpuestas (insignia sobre imagen, texto sobre foto, etc.) son estructuralmente imposibles de crear. El compilador de este proyecto usa por defecto el posicionamiento libre (x/y) y admite hijos con absolute: true dentro de regiones con auto-layout.

• P0-2 — Importación de imágenes local/personalizada. El image.src de Plumb siempre se compila en una consulta de búsqueda web contra seis proveedores fijos de fotos de stock; el archivo propio de un usuario nunca puede entrar en un diseño creado con Plumb. Este proyecto lee directamente los URI file:/data:, con errores tipados y cero sustitución de marcadores de posición.

• P0-3 — Validación estricta de esquemas. Los esquemas Zod de Plumb eliminan silenciosamente los campos desconocidos o mal escritos. Todos los esquemas aquí son .strict().

Consulta docs/P0-CAPABILITY-MATRIX.md para la trazabilidad completa de la auditoría, elemento por elemento, y docs/ para el resto del conjunto de documentación.

Estado

P0 COMPLETO — consulta P0-FINAL-REPORT.md para la lista de verificación completa de criterios de aceptación, los resultados reales de pruebas en Figma en vivo y una captura de pantalla de la composición real que este proyecto creó (nodos reales de Figma superpuestos, imagen local real, rotación/degradado/efectos reales — no una imagen aplanada).

Related MCP server: Figma Bridge MCP

Inicio rápido

npm install
npm run build
npm test

Luego consulta docs/QUICKSTART.md para emparejar el plugin de Figma y ejecutar la prueba de extremo a extremo en vivo.

Documentación

• 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

Licencia

MIT