tidy-core

다른 Figma MCP 서버는 에이전트가 디자인 시스템을 변경할 수 있게 해줍니다. tidy-core는 변경해야 하는지, 무엇이 깨질지, 지난 변경을 누가 채택했는지, 그리고 6개월 전에 당신이 무엇을 결정했는지를 알려줍니다.

Model Context Protocol 기반 디자인 시스템 거버넌스. 백 개가 아니라 열세 개의 도구.

상태: v0.1.0, 초기 단계. 열세 개의 도구 중 세 개가 구현되었습니다. 나머지 열 개는 등록되어 있으며, 빈 결과를 반환하는 대신 아직 구축되지 않았다고 알려줍니다. 빌드 순서를 참조하세요.

왜 존재하는가

에이전트가 Figma를 읽고 쓰는 것은 이미 해결된 문제입니다. Figma는 자사 MCP 서버를 제공하며, 백 개가 넘는 도구를 가진 좋은 서드파티 서버도 있습니다.

그 중 어느 것도 디자인 시스템 리드가 실제로 받는 질문에 답하지 않습니다: 이게 작동하고 있는가, 그리고 인력을 들일 가치가 있는가?

컴포넌트 수는 보여줄 수 있습니다. 하지만 채택률, 드리프트, 결정 이력, 다음 마이그레이션의 비용은 보여줄 수 없습니다. 그래서 시스템은 잘못된 행동을 보상하는 유일한 지표인 출력량으로 평가됩니다.

tidy-core는 그 공백을 위해 만들어졌습니다. 컴포넌트를 더 빨리 그리는 방법이 아닙니다.

Related MCP server: Harness Engineering MCP

하는 일

하지 않는 일

• 디자인-투-코드 생성기가 아닙니다. Figma 자체 MCP 서버가 그걸 잘합니다.

• 컴포넌트를 더 빨리 작성하는 방법이 아닙니다. 다른 서버들이 그걸 잘합니다.

• 도구 수 경쟁이 아닙니다. 작은 표면이 핵심입니다.

작성용 MCP 서버 옆에 놓이도록 설계되었으며, 대체하지 않습니다. 변경을 만들려면 그 서버들을 사용하세요. 변경을 할지 결정하고, 무슨 일이 있었는지 증명하려면 이 서버를 사용하세요.

설치

👋 처음이신가요?

단계별 가이드를 대신 읽어보세요 →

코딩 경험이 없다고 가정하고, 모든 용어를 설명하며, 각 단계 후에 어떤 일이 일어나야 하는지 알려줍니다. 약 20분 소요.

MCP 서버를 설정해 본 사람들을 위한 짧은 버전입니다.

Node 18+와 Figma Desktop이 필요합니다. 브라우저 탭은 localhost 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 → Plugins → Development → Import plugin from manifest

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이 출시되면 모든 호출이 스냅샷을 저장합니다. 그 덕분에 두 번째 실행에서 아무도 스케줄링하지 않아도 델타를 보여줄 수 있습니다. 읽기 전용 CI 검사를 위한 noCapture 플래그가 존재할 것입니다. 근거를 보세요.

열세 개의 도구

전체 정의는 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**에서 진행 중인 디자인 시스템과 AI에 대한 작업에서 나왔습니다. 그 배경이 되는 사고는 더 깊이 다루어집니다: 디자인 시스템이 어떻게 측정되는지, AI가 실제로 어디에 도움이 되는지, 그리고 어디서 조용히 상황을 악화시키는지.

Romina Kavčič가 만들었습니다.

라이선스

MIT