Huashu Design MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

20 codified design principles (contrast, rhythm, modularity, …)
5-dimension review: layout / typography / color / motion / content
MP4 export via headless render for animated deliverables
High-fidelity prototype mode — pixel-perfect target fidelity
Works with any framework or plain HTML

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "huashu-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alchaincyf/huashu-design",
        "~/.claude/skills/huashu-design"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "huashu-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alchaincyf/huashu-design",
        "~/.claude/skills/huashu-design"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "huashu-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alchaincyf/huashu-design",
        "~/.claude/skills/huashu-design"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "huashu-design-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alchaincyf/huashu-design",
        "~/.claude/skills/huashu-design"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "huashu-design-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/alchaincyf/huashu-design",
        "~/.claude/skills/huashu-design"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "huashu-design-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/alchaincyf/huashu-design",
          "~/.claude/skills/huashu-design"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add huashu-design-skill -- git clone https://github.com/alchaincyf/huashu-design ~/.claude/skills/huashu-design

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Huashu Design

Rapidly prototype a product landing page in HTML

👤 Founders, designers preferring code over Figma ⏱ ~60 min intermediate

언제 쓸까: You have a brief and want a clickable, measurable prototype, not a static mock.

사전 조건

Skill installed — git clone https://github.com/alchaincyf/huashu-design ~/.claude/skills/huashu-design

흐름

Anchor style

Use huashu-design. Brief: minimal B2B SaaS landing, Swiss-influenced, serif headings, one accent color. Generate layout plan following your 20 principles.✓ 복사됨

→ Layout plan cites specific principles applied
Build

Produce HTML/CSS. Single file. Responsive. No JS frameworks.✓ 복사됨

→ Single-file deliverable that passes basic a11y
5-dim review

Run the 5-dimension review on what you just shipped. Where does it fall short?✓ 복사됨

→ Critical self-review, not hype

결과: A prototype you can A/B test or iterate on without leaving code.

함정

Skill reverts to generic "hero + features + CTA" template — Pin the style ref (Swiss, Bauhaus, editorial) in every prompt

함께 쓰기: filesystem

Build an animated explainer and export to MP4

👤 Devs/creators shipping a product video ⏱ ~120 min advanced

언제 쓸까: You want an 30-second explainer for your product but can't justify After Effects.

흐름

Storyboard

Use huashu-design. Storyboard a 30s explainer for my product: problem (8s) / solution (14s) / CTA (8s).✓ 복사됨

→ Frame-by-frame plan
Animate in HTML

Implement each scene as a CSS keyframe animation. Render as a single HTML with a timeline.✓ 복사됨

→ HTML plays cleanly in browser
Export

Render to 1080p MP4.✓ 복사됨

→ MP4 written to disk; duration matches

결과: A shippable MP4 explainer from a prompt, no video editing software.

함정

Fonts render differently in headless Chrome — Bundle web fonts; don't rely on system fonts

함께 쓰기: filesystem · after-effects

조합

다른 MCP와 조합해 10배 효율

huashu-design-skill + after-effects

Storyboard in HTML, finish in AE for broadcast quality

Draft in huashu-design; export frames for AE compositing.✓ 복사됨

huashu-design-skill + filesystem

Save iterations alongside the brief

Create /designs/landing-v1/ through v3/ and keep both.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
plan_layout	brief, style_ref	Every new design
generate_html	plan	Build from plan
review_5d	html	Self-review after building
render_mp4	html, duration	Animated deliverable

비용 및 제한

운영 비용

API 쿼터: N/A
호출당 토큰: High-fi designs produce a lot of HTML — keep scope tight
금액: Free
팁: Generate in small passes: structure first, styling second, polish third

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-write

자격 증명 저장: None

데이터 외부 송신: None

문제 해결

자주 발생하는 오류와 해결

MP4 render fails (ffmpeg missing)

brew install ffmpeg — the skill uses it for frame stitching

확인: `ffmpeg -version`

Design looks generic

You didn't pin a style reference — always name one (Swiss, Bauhaus, Pentagram, …)

Review gives happy feedback on bad design

Explicit prompt: "be critical; list what's wrong first"

대안

Huashu Design 다른 것과 비교

대안	언제 쓰나	단점/장점
cc-frontend-skill	You want an opinionated voice rather than a methodology	Less structured review process
Figma	Team workflow requires Figma	Not code; not animatable the same way

Huashu Design