tidy-core

Otros servidores MCP de Figma permiten que un agente modifique tu sistema de diseño. tidy-core te dice si debería hacerlo, qué se romperá, si alguien adoptó el último cambio y qué decidiste hace seis meses.

Gobernanza de sistemas de diseño sobre el Model Context Protocol. Trece herramientas, no cien.

Estado: v0.1.0, temprano. Tres de las trece herramientas están implementadas. Las otras diez están registradas y te dirán que aún no están construidas en lugar de devolver un resultado vacío. Consulta la secuencia de construcción.

Por qué existe esto

Leer y escribir en Figma desde un agente es un problema resuelto. Figma incluye un servidor MCP de primera parte, y hay buenos de terceros con más de cien herramientas.

Lo que ninguno de ellos hace es responder la pregunta que realmente recibe un líder de sistema de diseño: ¿esto funciona y vale la pena el personal?

Puedes mostrar un recuento de componentes. No puedes mostrar adopción, deriva, historial de decisiones o el costo de la próxima migración. Así que el sistema se juzga por el volumen de producción, que es la única métrica que recompensa el comportamiento incorrecto.

tidy-core está construido para esa brecha. No es una forma más rápida de dibujar componentes.

Related MCP server: Harness Engineering MCP

Qué hace

Qué no hace

• No es un generador de diseño a código. El propio servidor MCP de Figma hace eso bien.

• No es una forma de crear componentes más rápido. Otros servidores hacen eso bien.

• No es una competencia de cantidad de herramientas. La superficie pequeña es el punto.

Está diseñado para ubicarse junto a un servidor MCP de autoría, no para reemplazarlo. Usa esos para hacer el cambio. Usa este para decidir si hacerlo y para demostrar qué sucedió.

Instalación

👋 ¿Nuevo en esto?

Lee la guía paso a paso en su lugar →

Asume que no tienes experiencia en programación, explica cada término y te dice qué debería suceder después de cada paso. Unos 20 minutos.

La versión corta, para personas que ya han configurado un servidor MCP antes.

Requiere Node 18+ y Figma Desktop. Una pestaña del navegador no puede alcanzar un WebSocket localhost, y no hay solución alternativa.

Aún no está en npm, así que clona y compila:

git clone https://github.com/rominak/tidy-core.git
cd tidy-core
npm install
npm run build

Claude Code

claude mcp add tidy-core -s user -- node /absolute/path/to/tidy-core/dist/index.js

Cursor, Windsurf, Claude Desktop

{
  "mcpServers": {
    "tidy-core": {
      "command": "node",
      "args": ["/absolute/path/to/tidy-core/dist/index.js"]
    }
  }
}

Luego conecta el plugin:

1. Figma Desktop → Plugins → Development → Import plugin from manifest

2. Selecciona plugin/manifest.json de este repositorio

3. Ejecútalo. Escanea los puertos 9240 a 9249 y se conecta solo.

Verifica:

Check tidy status

Primera ejecución

Load the design system contract.

tidy_context devuelve colecciones, modos, nombres de tokens agrupados por intención, ejes de variantes de componentes y las convenciones de nomenclatura realmente en uso, inferidas de tus datos en lugar de asumidas.

Más en docs/examples.md.

Decisiones de diseño que vale la pena conocer

Se niega a adivinar qué archivo quieres decir. Con dos o más archivos de Figma conectados y sin un objetivo establecido, los comandos fallan con una lista de los archivos en lugar de elegir el primer socket abierto. Elegir es un lanzamiento de moneda, y perderlo escribe en el archivo equivocado. Establece uno con tidy_target.

Etiqueta cada respuesta. Las configuraciones reales ejecutan varios servidores MCP de Figma en paralelo. Cada respuesta lleva _mcp: "tidy-core" y cada error tiene el prefijo [tidy-core], para que la falla de otro servidor nunca se atribuya a este.

Las herramientas no construidas lo dicen. Las diez herramientas planificadas están registradas y devuelven una negativa explícita que nombra lo que harán. Una herramienta que devuelve silenciosamente {} es peor que una que admite que aún no existe.

No matará tus otras herramientas. Si el puerto 9240 está ocupado, se mueve al siguiente libre en el rango 9240 a 9249, que el plugin escanea de todos modos. Deliberadamente no termina lo que estuviera ocupando el puerto.

Las lecturas escribirán. Una vez que tidy_health y tidy_adoption lleguen, cada llamada persiste una instantánea. Eso es lo que permite que la segunda ejecución muestre un delta sin que nadie programe nada. Existirá una bandera noCapture para verificaciones de CI de solo lectura. Consulta el razonamiento.

Las trece herramientas

Definiciones completas en docs/spec.md.

Desarrollo

npm install
npm run build     # emits dist/, excludes tests
npm test
npm run typecheck # checks everything including tests
npm run dev       # watch mode

Todo se ejecuta localmente. Ningún dato sale de tu máquina y no hay telemetría.

Aprende más

tidy-core surge del trabajo continuo en sistemas de diseño e IA en aidesign.guide, donde el pensamiento detrás de esto se desarrolla con más profundidad: cómo se miden los sistemas de diseño, dónde la IA realmente ayuda y dónde silenciosamente empeora las cosas.

Construido por Romina Kavčič.

Licencia

MIT