AK

aka-kika/hig-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

38 stars 0 forks Качество 74 Тренд 32MIT

Сервер MCP, обслуживающий Apple Human Interface Guidelines в качестве структурированных токенов дизайна для агентов кодирования ИИ — системные цвета после WWDC25, ограничения Liquid Glass, отображения SwiftUI.

Обзор

— реальные системные цветовые значения, тип пандуса, ограничения жидкого стекла и отображения SwiftUI — вместо прозы для неправильного прочтения или устаревшей гекса для галлюцинации. На WWDC25 Apple не просто поставляла жидкое стекло — оно тихо (HIG changelog, 9 июня 2025 года). SystemBlue больше не #007AFF. Это #0088FF. Спросите агента о цветах iOS, и он уверенно закодирует палитру до 2025 года. Apple публикует рекомендации как веб-страницы; агент сжигает тысячи токенов, принося один, а затем все еще угадывает цифры. — размытые бюджеты, композитные крышки слоев, контраст, измеренный после размытия, обязательный резерв снижения прозрачности. Агенты по умолчанию нарушают их все. Вы в конечном итоге просматриваете сгенерированный SwiftUI, который выглядит правдоподобным и тонко вне спецификации везде. Кураторские, проверенные файлы токенов в прямом эфире - офлайн, детерминированные, почти нулевые токены - и проза извлекается в прямом эфире с sosumi.ai, поэтому руководство никогда не устаревает. Спросите цвет, и вы получите текущую таблицу спецификаций после WWDC25, а не память 2023 года.

Обзор (машинный перевод)

** Сервер MCP, который предоставляет Claude Code, Cursor и любому клиенту MCP руководство Apple по человеческому интерфейсу в качестве структурированных данных** — реальные значения цвета системы, тип пандуса, ограничения Liquid Glass и отображения SwiftUI — вместо прозы для неправильного прочтения или устаревшей шестнадцатерки для галлюцинации.

Проблема, с которой сталкивается каждый разработчик Apple (и их агент) прямо сейчас

На WWDC25 Apple не просто поставляла жидкое стекло — она тихо перекрашивала цветовую палитру системы (HIG changelog, 9 июня 2025 года). Это [[Т2]].

Что означает:

** Все данные об обучении LLM неверны.** Спросите агента о цветах iOS, и он уверенно закодирует палитру до 2025 года. HIG - это проза, а не данные. Apple публикует рекомендации как веб-страницы; агент сжигает тысячи токенов, принося один, а затем все еще угадывает цифры. ** Жидкое стекло имеет правила, которые никто не записывал в одном месте** — размытые бюджеты, композитные крышки слоев, контраст, измеренный после размытия, обязательный запасной вариант с пониженной прозрачностью. Агенты по умолчанию нарушают их все.

Вы в конечном итоге просматриваете сгенерированный SwiftUI, который * выглядит * правдоподобно и тонко вне спецификации везде.

Как hig-mcp решает проблему

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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.

Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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