tidy-core

他のFigma MCPサーバーはエージェントにデザインシステムを変更させることができます。tidy-coreは、それがすべきかどうか、何が壊れるか、前の変更を誰かが採用したかどうか、そして6か月前にあなたが決めたことを教えてくれます。

Model Context Protocol上のデザインシステムガバナンス。100のツールではなく13のツール。

ステータス：v0.1.0、準備段階。 実装済みは13ツールのうち3ツール。他の10ツールは登録済みで、応答は返さずにまだ構築されていないことを明示します。ビルドシーケンスを参照してください。

なぜこれが存在するのか

エージェントからFigmaを読み書きすることは解決済みの問題です。FigmaはファーストパーティのMCPサーバーを出荷しており、100以上のツールを持つ優れたサードパーティ製サーバーも存在します。

それらのいずれも答えられないのは、デザインシステムのリーダーが実際に尋ねられる質問：これは機能しているか、そしてそれに見合う人員が必要か？ ということです。

コンポーネント数を見せることはできます。採用状況、偏差、決定履歴、そして次の移行のコストを見せることはできません。そのためシステムは出力量で判断され、それは誤った行動に報いる唯一のメトリクスです。

tidy-coreはそのギャップのために構築されています。コンポーネントをより速く設計するための機能はありません。

Related MCP server: Harness Engineering MCP

できること

できないこと

• デザインからコードへのジェネレーターではありません。Figma自体のMCPサーバーがそれをうまく処理します。

• コンポーネントを作成するためのより高速な方法ではありません。他のサーバーがそれをうまく処理します。

• ツール数競争ではありません。小規模な使い勝手が重要なのです。

制作MCPサーバーの隣に共存することを意図しており、置き換えるものではありません。変更をするにはそれらを使用してください。このツールは変更するかどうかを決定し、実際の結果を証明するために使用します。

インストール

👋 初めてですか？

手順ごとのガイドを先に読んでください →

このガイドはコーディング経験を前提にしておらず、各用語を説明し、各ステップ後に何が起こるかを示します。約20分です。

MCPサーバーのセットアップ経験がある人向けの短いバージョン。

Node 18+ と Figmaのデスクトップアプリが必要です。ブラウザのタブはlocalhostのWebSocketにアクセスできず、回避策はありません。

まだnpmで公開していないため、GitHubから複製してビルドします：

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

プラグインを接続します：

1. Figmaデスクトップ → プラグイン → 開発 → マニフェストからプラグインをインポート

2. このリポジトリの plugin/manifest.json を選択します

3. 実行します。これはポート9240から9249をスキャンし、自動的に接続します。

検証：

Check tidy status

最初の実行

Load the design system contract.

tidy_context は、コレクション、モード、トークン名を意図別にグループ化したもの、コンポーネントのバリアント軸、および実際に使用されているネーミング規則を返します。あなたのデータからの推定ではなく、推定です。

詳細は docs/examples.md にあります。

検討する価値のあるデザイン設計

どのファイルを指すか推測することを拒否します。 2つ以上のFigmaファイルが接続されていてターゲットが設定されていない場合、コマンドは最初に利用可能なソケットを選ぶのではなく、ファイルのリストを表示して失敗します。選ぶことはコイントスであり、負けると間違ったファイルに書き込みます。tidy_target で設定して指します。

すべての応答にタグを付けます。 実際のセットアップでは、複数のFigma MCPサーバーを同時に実行しています。すべての応答には _mcp: "tidy-core" が付き、すべてのエラーには [tidy-core] というプレフィックスが付きます。これにより、別のサーバーの失敗がこのサーバーによるものではないことが確実になります。

未構築のツールが明確にされます。 計画されている10個のツールは登録され、その機能を明示した拒否を返します。静かに {} を返すツールは、存在しないことを認めるものよりも悪いものです。

他のツールを終了させることはありません。 ポート9240がビジーである場合、9240から9249の範囲の空いたポートに移動し、プラグインはそのポートをスキャンします。ポートを占有していたものを不正に終了しないように設計されています。

読み取りは書き込み時に保存されます。 tidy_health と tidy_adoption が導入されると、呼び出すたびにスナップショットが保存されます。これにより、誰かがスケジュールを設定することなく、2回目の実行でデルタを表示できるようになります。読み取り専用のCIチェック用には noCapture フラグが存在します。詳細は 推論 を参照してください。

13個のツール

完全な定義は docs/spec.md にあります。

開発

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

すべてはローカルで動作します。データはマシンを離れず、テレメトリーもありません

詳細はこちら

tidy-core は デザインシステムとAI での進行中の作業から来ており、その考え方の詳細はさらに詳しく書かれています：デザインシステムがどのように測定されるか、AIが実際にどこで役立つか、そしてどこで静かに物事を悪化させるかです。

による構築 Romina Kavčič。

ライセンス

MIT