tidy-core

Andere Figma-MCP-Server lassen einen Agenten Ihr Designsystem ändern. tidy-core sagt Ihnen, ob es das sollte, was kaputtgehen würde, ob jemand die letzte Änderung übernommen hat und was Sie vor sechs Monaten entschieden haben.

Designsystem-Governance über das Model Context Protocol. Dreizehn Tools, nicht hundert.

Status: v0.1.0, früh. Drei der dreizehn Tools sind implementiert. Die anderen zehn sind registriert und sagen Ihnen, dass sie noch nicht gebaut sind, anstatt ein leeres Ergebnis zurückzugeben. Siehe die Build-Sequenz.

Warum es das gibt

Das Lesen und Schreiben von Figma durch einen Agenten ist ein gelöstes Problem. Figma liefert einen First-Party-MCP-Server, und es gibt gute Third-Party-Server mit über hundert Tools.

Was keiner von ihnen beantwortet, ist die Frage, die einem Designsystem-Lead tatsächlich gestellt wird: funktioniert das, und ist es die Personalstelle wert?

Sie können eine Komponentenanzahl zeigen. Sie können keine Adoption, keine Abweichung, keine Entscheidungshistorie und nicht die Kosten der nächsten Migration zeigen. Also wird das System an der Ausgabemenge gemessen – die eine Kennzahl, die das falsche Verhalten belohnt.

tidy-core ist für diese Lücke gebaut. Es ist kein schnellerer Weg, Komponenten zu zeichnen.

Related MCP server: Harness Engineering MCP

Was es tut

Was es nicht tut

• Kein Design-to-Code-Generator. Figmas eigener MCP-Server macht das gut.

• Kein Weg, Komponenten schneller zu erstellen. Andere Server machen das gut.

• Kein Tool-Anzahl-Wettbewerb. Die kleine Oberfläche ist der Punkt.

Es ist dafür entwickelt, neben einem Authoring-MCP-Server zu sitzen, nicht um ihn zu ersetzen. Nutzen Sie diese, um die Änderung vorzunehmen. Nutzen Sie dieses, um zu entscheiden, ob Sie sie vornehmen sollten, und um zu beweisen, was passiert ist.

Installation

👋 Neu hier?

Lesen Sie stattdessen die Schritt-für-Schritt-Anleitung →

Sie setzt keine Programmiererfahrung voraus, erklärt jeden Begriff und sagt Ihnen, was nach jedem Schritt passieren sollte. Etwa 20 Minuten.

Die Kurzversion, für Leute, die bereits einen MCP-Server eingerichtet haben.

Erfordert Node 18+ und Figma Desktop. Ein Browser-Tab kann keine lokale WebSocket-Verbindung erreichen, und es gibt keine Problemumgehung.

Noch nicht auf npm, also klonen und bauen Sie:

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"]
    }
  }
}

Dann verbinden Sie das Plugin:

1. Figma Desktop → Plugins → Entwicklung → Plugin aus Manifest importieren

2. Wählen Sie plugin/manifest.json aus diesem Repository aus

3. Führen Sie es aus. Es scannt die Ports 9240 bis 9249 und verbindet sich von selbst.

Überprüfen Sie:

Check tidy status

Erster Lauf

Load the design system contract.

tidy_context gibt Collections, Modi, Token-Namen nach Absicht gruppiert, Komponenten-Variantenachsen und die tatsächlich verwendeten Namenskonventionen zurück, abgeleitet aus Ihren Daten, nicht behauptet.

Mehr in docs/examples.md.

Wissenswerte Designentscheidungen

Es weigert sich zu raten, welche Datei Sie meinen. Wenn zwei oder mehr Figma-Dateien verbunden sind und kein Ziel gesetzt ist, schlagen Befehle mit einer Liste der Dateien fehl, anstatt die erste offene Socket zu wählen. Das Raten ist ein Münzwurf, und das Verlieren schreibt in die falsche Datei. Setzen Sie eines mit tidy_target.

Es taggt jede Antwort. Echte Setups betreiben mehrere Figma-MCP-Server nebeneinander. Jede Antwort trägt _mcp: "tidy-core" und jeder Fehler ist mit [tidy-core] präfigiert, sodass das Versagen eines anderen Servers diesem nie angelastet wird.

Ungebaute Tools sagen es. Die zehn geplanten Tools sind registriert und geben eine explizite Ablehnung zurück, die benennt, was sie tun werden. Ein Tool, das stillschweigend {} zurückgibt, ist schlimmer als eines, das zugibt, dass es noch nicht existiert.

Lesevorgänge werden schreiben. Sobald tidy_health und tidy_adoption verfügbar sind, erstellt jeder Aufruf einen Snapshot. Das ist es, was den zweiten Lauf in die Lage versetzt, ein Delta zu zeigen, ohne dass jemand etwas plant. Ein noCapture-Flag wird für schreibgeschützte CI-Checks existieren. Siehe die Begründung.

Die dreizehn Tools

Vollständige Definitionen in docs/spec.md.

Entwicklung

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

Alles läuft lokal. Keine Daten verlassen Ihre Maschine, und es gibt keine Telemetrie.

Mehr erfahren

tidy-core entstand aus laufender Arbeit an Designsystemen und KI bei aidesign.guide, wo das Denken dahinter ausführlicher beschrieben ist: wie Designsysteme gemessen werden, wo KI tatsächlich hilft und wo sie leise die Dinge verschlimmert.

Erstellt von Romina Kavčič.

Lizenz

MIT