AK

aka-kika/hig-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

38 stars 0 forks 품질 74 트렌드 32MIT

MCP 서버는 AI 코딩 에이전트를위한 구조화 된 디자인 토큰으로 Apple Human Interface Guidelines를 제공 - 포스트 WWDC25 시스템 색상, 액체 유리 제약, SwiftUI 매핑.

개요

- 실제 시스템 색상 값, 유형 경사로, 액체 유리 제약, 및 SwiftUI 매핑 - misread 또는 stale hex에 prose 대신. WWDC25 Apple은 액체 유리를 배송하지 않았습니다. 조용히 (HIG changelog, 6 월 9, 2025). systemBlue는 더 이상 #007AFF가 아닙니다. #0088FF입니다. - iOS 색상의 에이전트를 요청하고 정확히 pre-2025 팔레트를 해독합니다. - Apple은 웹 페이지로 가이드 라인을 게시합니다. 에이전트는 수천 개의 토큰을 태칭 한 다음 여전히 숫자를 추측합니다. - — blur 예산, 퇴비 층 모자, blur 후에 측정되는 대조, 필수 감소 투명성 fallback. 에이전트는 기본적으로 그들 모두를 위반. 검색 결과를 찾을 수 없음 한국어 사전에 온라인 구직 Curated, 검증 된 토큰 파일 라이브 — 오프라인, 세분화, 가까운 zero 토큰 - 그리고 prose는 sosumi.ai에서 라이브를 fetched 그래서 지도는 결코 stale입니다. 색상을 요청하고 현재 포스트 WWDC25 사양 테이블을 얻을, 아니 2023 메모리.

개요(AI 번역)

** Claude Code, Cursor 및 MCP 클라이언트를 제공하는 MCP 서버는 Apple Human Interface Guidelines as Structured data** — real system color values, type Tilt, Liquid Glass constraints, SwiftUI mappings — 대신에 misread 또는 stale hex to hallucinate.

문제 모든 Apple dev (그리고 그들의 대리인) 지금 있다

WWDC25 Apple은 액체 유리를 발송하지 않았습니다. 조용히 ** 시스템 색상 팔레트를 복사 ** (HIG changelog, 6 월 9, 2025). systemBlue은 더 이상 없습니다. #0088FF입니다.

어떤 의미:

  • ** 모든 LLM의 교육 데이터가 잘못됩니다. ** iOS 색상의 에이전트를 요청하고 정확히 pre-2025 팔레트를 해독합니다.
  • ** HIG는 prose, 데이터가 아닙니다. ** Apple은 웹 페이지로 가이드 라인을 게시합니다. 에이전트는 수천 개의 토큰을 태칭 한 다음 여전히 숫자를 추측합니다.
  • **Liquid Glass에는 아무도 한 곳에서 썼지 않습니다 ** - blur 예산, 퇴비 층 모자, 대조 측정 된 after blur, 필수 감소 투명성 fallback. 에이전트는 기본적으로 그들 모두를 위반.

looks plausible이 생성 된 SwiftUI를 검토하고 어디에나 하위 별입니다.

어떻게 hig-mcp 그것을 해결

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

hig-mcp — Apple HIG design tokens for AI coding agents

An MCP server that gives Claude Code, Cursor, and any MCP client the Apple Human Interface Guidelines as structured data — real system color values, the type ramp, Liquid Glass constraints, and SwiftUI mappings — instead of prose to misread or stale hex to hallucinate.

The problem every Apple dev (and their agent) has right now

At WWDC25 Apple didn’t just ship Liquid Glass — it quietly refreshed the system color palette (HIG changelog, June 9, 2025). systemBlue is not #007AFF anymore. It’s #0088FF.

Which means:

  • Every LLM’s training data is wrong. Ask an agent for iOS colors and it confidently hardcodes the pre-2025 palette.
  • The HIG is prose, not data. Apple publishes guidelines as web pages; an agent burns thousands of tokens fetching one, then still guesses the numbers.
  • Liquid Glass has rules nobody wrote down in one place — blur budgets, compositing layer caps, contrast measured after blur, the mandatory Reduce Transparency fallback. Agents violate all of them by default.

You end up reviewing generated SwiftUI that looks plausible and is subtly off-spec everywhere.

How hig-mcp solves it

Curated, verified token files live inside the server — offline, deterministic, near-zero tokens — and prose is fetched live from sosumi.ai so guidance is never stale. Ask for color and you get the current post-WWDC25 spec table, not a 2023 memory.

Tool What it returns Network
hig_get_tokens Design tokens by category: color, typography, materials, layout, swiftui, sf_symbols no
hig_check_liquid_glass Liquid Glass guardrails + a concrete checklist for your context and platform no
hig_swiftui HIG component → the right SwiftUI API + which tokens to apply no
hig_fetch Current HIG page as clean Markdown (via sosumi.ai) yes

How it works

Four tools over stdio (Python, the official mcp SDK 2.x). The structured half is plain JSON you own and extend (src/hig_mcp/data/); the prose half is delegated to sosumi.ai’s DocC-to-Markdown rendering rather than rebuilt. Every value is provenance-tagged:

  • apple-system / apple-hig — Apple-published facts (system colors, type ramp, 44pt hit targets).
  • wcag-aa — the 4.5:1 contrast rule.
  • figma-effect / community-bestpractice — useful numbers Apple never published, flagged so you know to confirm.
  • verify: true — beta-era API names that shift; confirm via hig_fetch or Xcode before shipping.

Each data file also carries a checked date in its _meta: the day its values were last compared with Apple’s live pages.

Honest data beats confident data.

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "hig": { "command": "hig-mcp" } } }