tidy-core

Другие Figma MCP-серверы позволяют агенту изменять вашу дизайн-систему. tidy-core сообщает, стоит ли это делать, что сломается, принял ли кто-то последнее изменение, и что вы решили шесть месяцев назад.

Управление дизайн-системой через Model Context Protocol. Тринадцать инструментов, а не сотня.

Статус: v0.1.0, ранняя версия. Три из тринадцати инструментов реализованы. Остальные десять зарегистрированы и сообщат, что ещё не построены, вместо того чтобы возвращать пустой результат. См. последовательность сборки.

Зачем это существует

Чтение и запись Figma из агента — решённая задача. Figma поставляет собственный MCP-сервер, и есть хорошие сторонние с сотней и более инструментов.

Но ни один из них не отвечает на вопрос, который на самом деле задают руководителю дизайн-системы: работает ли это, и стоит ли оно затрат на персонал?

Можно показать количество компонентов. Нельзя показать внедрение, расхождение, историю решений или стоимость следующей миграции. Поэтому систему оценивают по объёму вывода — единственному показателю, который поощряет неправильное поведение.

tidy-core создан для этого пробела. Это не более быстрый способ рисовать компоненты.

Related MCP server: Harness Engineering MCP

Что он делает

Чего он не делает

• Не генератор кода из дизайна. Собственный MCP-сервер Figma делает это хорошо.

• Не способ быстрее создавать компоненты. Другие серверы делают это хорошо.

• Не соревнование по количеству инструментов. Небольшая поверхность — в этом суть.

Он предназначен для работы вместе с MCP-сервером для создания контента, а не для его замены. Используйте те для внесения изменений. Используйте этот, чтобы решить, стоит ли вносить изменение, и доказать, что произошло.

Установка

👋 Впервые здесь?

Вместо этого прочитайте пошаговое руководство →

Оно не предполагает опыта программирования, объясняет каждый термин и рассказывает, что должно произойти после каждого шага. Около 20 минут.

Краткая версия для тех, кто уже настраивал MCP-сервер.

Требуется Node 18+ и Figma Desktop. Вкладка браузера не может подключиться к локальному WebSocket, и обходного пути нет.

Пока нет на npm, поэтому клонируйте и соберите:

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 Desktop → Плагины → Разработка → Импортировать плагин из манифеста

2. Выберите plugin/manifest.json из этого репозитория

3. Запустите его. Он сканирует порты с 9240 по 9249 и подключается сам.

Проверка:

Check tidy status

Первый запуск

Load the design system contract.

tidy_context возвращает коллекции, режимы, имена токенов, сгруппированные по назначению, оси вариантов компонентов и фактически используемые соглашения об именовании, выведенные из ваших данных, а не заявленные.

Подробнее в docs/examples.md.

Проектные решения, о которых стоит знать

Он отказывается угадывать, какой файл вы имеете в виду. Если подключено два или более файлов Figma и не задана цель, команды завершаются с ошибкой, показывая список файлов, вместо того чтобы выбрать первый открытый сокет. Выбор — это подбрасывание монеты, и проигрыш приводит к записи в неправильный файл. Установите цель с помощью tidy_target.

Он помечает каждый ответ. В реальных настройках несколько Figma MCP-серверов работают бок о бок. Каждый ответ содержит _mcp: "tidy-core", а каждая ошибка имеет префикс [tidy-core], так что сбой другого сервера никогда не приписывается этому.

Несозданные инструменты говорят об этом. Десять запланированных инструментов зарегистрированы и возвращают явный отказ с указанием того, что они будут делать. Инструмент, который молча возвращает {}, хуже того, который признаёт, что его ещё нет.

Он не убьёт ваши другие инструменты. Если порт 9240 занят, он переходит к следующему свободному в диапазоне 9240–9249, который плагин и так сканирует. Он намеренно не завершает процесс, занимающий порт.

Чтения будут записывать. Когда появятся tidy_health и tidy_adoption, каждый вызов будет сохранять снимок. Именно это позволяет второму запуску показать дельту без какого-либо планирования. Флаг noCapture будет существовать для проверок CI в режиме только для чтения. См. обоснование.

Тринадцать инструментов

Полные определения в 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 является результатом текущей работы над дизайн-системами и ИИ на aidesign.guide, где идеи, стоящие за ним, описаны более подробно: как измеряются дизайн-системы, где ИИ действительно помогает, а где он незаметно ухудшает ситуацию.

Создано Romina Kavčič.

Лицензия

MIT